diff --git a/1998/bas1/README.md b/1998/bas1/README.md index 12b55244d..f1fce1f1c 100644 --- a/1998/bas1/README.md +++ b/1998/bas1/README.md @@ -1,63 +1,71 @@ # Best Encapsulation - Bas de Bakker - Pica, Centre for Library Automation - Statenweg 154 B (home address) - 3039 JN Rotterdam - The Netherlands +Bas de Bakker +Pica, Centre for Library Automation +Statenweg 154 B (home address) +3039 JN Rotterdam +The Netherlands ## To build: - make all +```sh +make all +``` ## To run: -If lpr on your system can print PostScript: +If `lpr` on your system can print PostScript: - ./bas1 | gunzip | lpr +```sh +./bas1 | gunzip | lpr +``` else, while in X Window System, - ./bas1 | gunzip | gv - +```sh +./bas1 | gunzip | gv - +``` + or: - ./bas1 | gunzip | gs -sDEVICE=pgmraw -sOutputFile='|xv -' - +```sh +./bas1 | gunzip | gs -sDEVICE=pgmraw -sOutputFile='|xv -' - +``` -## Judges' remarks +## Judges' remarks: The output is supposed to be a 3D maze, but it is somewhat more -than that. If you've seen any of the Maurits Escher's works, -you'll know what we're talking about. +than that. If you've seen any of the [Maurits +Escher's](https://en.wikipedia.org/wiki/M._C._Escher) +[works](https://mcescher.com/gallery/), you'll know what we're talking about. When trying to run the program with command line arguments, be generous. ## Author's remarks -BEMAZING -======== +### BEMAZING "You're in a twisty little maze of beams, all different." -Bemazing is "amazing" taken one step (letter) further. Bemazing +`Bemazing` is "amazing" taken one step (letter) further. `Bemazing` creates a 3D maze of beams. Try to go from the entrance (the unfinished beam in one corner) to the exit (the unfinished beam in the opposite corner) or vice versa. -For maximum portability, Bemazing is not tied to any window system, +For maximum portability, `Bemazing` is not tied to any window system, but creates postscript. The picture it makes will fit on either A4 or letter size paper. -In addition, because postscript is rather verbose, Bemazing creates +In addition, because postscript is rather verbose, `Bemazing` creates the postscript in gzip format, in order to save precious bits on your hard disk for the latest version of GNU Emacs (after all, you wouldn't want to use an editor without a psychoanalyze-pinhead function, now -would you). Again for maximum portability, Bemazing will take special +would you). Again for maximum portability, `Bemazing` will take special care that the binary output will not contain any newline or return characters that may get weird treatment on systems that do not use the One True Line Separator. -NOTES -===== +### NOTES Be sure to view the source with something that can display characters `\240-\377`. Use `LESSCHARSET=latin1`, `M-x` `standard-display-european` in @@ -66,8 +74,8 @@ GNU Emacs etc. The source does not use characters in the range HTML containing these control characters). Because this is not the obfuscated postscript contest, the postscript -does not contain any "for", "if" or other control structures. All the -logic is in the C code. There are only a few straightforward "def"s, +does not contain any `for`, `if` or other control structures. All the +logic is in the C code. There are only a few straightforward `def`s, because otherwise the output would become much larger. Try running `Bemazing` with command line arguments and see what