From d31c6adf4e2224a5af9aa6978e3aa1d5383099d9 Mon Sep 17 00:00:00 2001 From: Cody Boone Ferguson <53008573+xexyl@users.noreply.github.com> Date: Fri, 31 Mar 2023 09:46:50 -0700 Subject: [PATCH] Fixes in 2018/poikola I had put in the README.md that the entry needs XQuartz for macOS because it uses X11 but this is not true (I should have known as this was my favourite entry that year in the preview and it still is). The point was that Terminal.app of macOS might not work. This has been corrected. As it happens it appears to work fine for me which I noted in the README.md. Formatting fixes, slight improvements and possibly typo fixes. Add missing make rule docs that was referred to in the README.md but was missing from the Makefile. It was found in the archive/2020/poikola/Makefile. --- 2018/poikola/Makefile | 5 +++ 2018/poikola/README.md | 100 ++++++++++++++++++++++++++--------------- 2 files changed, 68 insertions(+), 37 deletions(-) diff --git a/2018/poikola/Makefile b/2018/poikola/Makefile index b777d3792..d492669a6 100644 --- a/2018/poikola/Makefile +++ b/2018/poikola/Makefile @@ -118,6 +118,7 @@ TARGET= ${PROG} ALT_OBJ= ALT_TARGET= +DOCS= poikola.tex ################# # build the entry @@ -143,6 +144,10 @@ alt: data ${ALT_TARGET} data: ${DATA} @${TRUE} +docs: ${DOCS} + pdflatex ${DOCS} + + # both all and alt # everything: all alt diff --git a/2018/poikola/README.md b/2018/poikola/README.md index 2b96898ec..5676a72b2 100644 --- a/2018/poikola/README.md +++ b/2018/poikola/README.md @@ -9,10 +9,11 @@ make ``` -NOTE: this entry requires `X11/Xlib.h` header file and the X11 library to -compile. macOS users running Mountain Lion and later will need to download and -install [XQuartz](https://www.xquartz.org) in order to compile and run this -entry. +NOTE: some have reported that Terminal.app in macOS does not work and one might +need a different terminal emulator like that from +[XQuartz](https://www.xquartz.org) but [Cody Boone +Ferguson](/winners.html#Cody_Boone_Ferguson) reported that this works fine in +macOS Ventura with Terminal.app. YMMV of course. ## To run: @@ -42,7 +43,7 @@ And those in the deep south might wish to go north for a better view. ## Author's comments: -### How to build +### How to build: ```sh cc -o prog -std=gnu11 -O3 prog.c @@ -54,67 +55,91 @@ or make ``` -### Poster +### Poster: -You can generate an A3 sized poster by _make docs_. This command creates a pdf file _poikola.pdf_. +You can generate an A3 sized poster by _make docs_. This command creates a pdf +file _poikola.pdf_. -### What this entry does -#### Introduction -It was a starry night when my wife pointed her finger up and asked: "What is this star and may I have some Easter eggs?" +### What this entry does: -So I had to sit down and solve those tricky questions with Nano and a C compiler. +#### Introduction: +It was a starry night when my wife pointed her finger up and asked: "What is +this star and may I have some Easter eggs?" -#### Little spoilers -Basically, the program draws animated ASCII art of the Big Dipper using Annie Jump Cannon's spectral classification system of stars and I think the -colors of the output are as accurate as possible. +So I had to sit down and solve those tricky questions with Nano and a C +compiler. -This program also tells once in a year if it is correct time to find and eat some Easter eggs. +#### Little spoilers: + +Basically, the program draws animated ASCII art of the Big Dipper using Annie +Jump Cannon's spectral classification system of stars and I think the colors of +the output are as accurate as possible. + +This program also tells once in a year if it is correct time to find and eat +some Easter eggs. The program has also at least three other functions, obvious and not so obvious. #### Technical jargon -This program has been tested on xterm and Konsole and also Linux virtual terminal. Color support in the terminal is not necessary, but the effect is better with it. -This entry has partial support for terminals with a white background but the best viewing experience is achieved when the terminal in use supports 24-bit colors, -has a black background and the size is at least 125x38. +This program has been tested on xterm and Konsole and also Linux virtual +terminal. Color support in the terminal is not necessary, but the effect is +better with it. -Special note for Mac users: __Terminal__ does not work as expected you might need xterm from XQuartz or some other -working terminal. Thanks to [Dave Burton](/winners.html#Dave_Burton) for spotting this problem. +This entry has partial support for terminals with a white background but the +best viewing experience is achieved when the terminal in use supports 24-bit +colors, has a black background and the size is at least 125x38. -The main reason for the header `unistd.h` is `getdelim()` but once I included it I also abused other functions and defines. This header is mutually exclusive with _-std=c11_. +Special note for Mac users: __Terminal__ does not work as expected you might +need xterm from XQuartz or some other working terminal. Thanks to [Dave +Burton](/winners.html#Dave_Burton) for spotting this problem. -The program was developed with little-endian machines; I tried to support big-endian too, but this support is somewhat limited. +The main reason for the header `unistd.h` is `getdelim()` but once I included it +I also abused other functions and defines. This header is mutually exclusive +with _-std=c11_. + +The program was developed with little-endian machines; I tried to support +big-endian too, but this support is somewhat limited. This program has been compiled in 1. i386 (Debian Stretch) with gcc and clang 2. amd64 (Debian Buster) with gcc and clang 3. Raspberry Pi 3 (Debian stretch) with gcc and clang -4. Lego Mindstorms EV3 Intelligent Brick (Debian Jessie) with gcc and clang (in this case, compiling time with clang-3.5 12 seconds and with gcc 27 seconds) +4. Lego Mindstorms EV3 Intelligent Brick (Debian Jessie) with gcc and clang (in +this case, compiling time with clang-3.5 12 seconds and with gcc 27 seconds) -### Warnings and restrictions required by law +### Warnings and restrictions required by law: Please do not feed little babies chocolate. -### Major spoilers +### Major spoilers:
 
-I incorporated the Fletcher 16 checksum algorithm into the source for security reasons; it might be challenging to make changes without breaking the main functionality of the code. +I incorporated the Fletcher 16 checksum algorithm into the source for security +reasons; it might be challenging to make changes without breaking the main +functionality of the code. + The space after `#define p return` is necessary. -The computus uses an algorithm described in the journal Nature in 1876. It should be valid for Gregorian calendars. +The computus (method to determine the date of Easter) uses an algorithm +described in the journal Nature in 1876. It should be valid for Gregorian +calendars. -#### Some obfuscation techniques used +### Some obfuscation techniques used: -1. I tried to use meaningless or misleading variable names. For example, this program draws the Big Dipper with the correct colors, but variables -like `o`, `b`, and `a` are used in totally unrelated tasks. +1. I tried to use meaningless or misleading variable names. For example, this +program draws the Big Dipper with the correct colors, but variables like `o`, +`b`, and `a` are used in totally unrelated tasks. 2. I reused and recycled variables almost every time when possible. 3. Unnecessary use of predefined stuff like `__ATOMIC_SEQ_CST`. -4. When I was a kid, my favorite programming language was Pascal. In Pascal, there are things like `begin;` and `end;` instead of curly brackets. -They are used also in my code, but I had to shorten them to meet size requirements. -5. I also have strong Perl background, -and therefore I added some dollar signs to the code. One of the first ideas was to -write all variables with prefixed `$`, but then I rejected it. +4. When I was a kid, my favorite programming language was Pascal. In Pascal, +there are things like `begin;` and `end;` instead of curly brackets. They are +used also in my code, but I had to shorten them to meet size requirements. +5. I also have strong Perl background, and therefore I added some dollar signs +to the code. One of the first ideas was to write all variables with prefixed +`$`, but then I rejected it. -If you think you understand how this program works, can you answer these questions: +If you think you understand how this program works, can you answer these +questions: 1. What is the value of `aI_` after line 21? 2. Why are there some big numbers on line 47? @@ -124,7 +149,8 @@ If you think you understand how this program works, can you answer these questio ### Rot18 part -Because the rot13 is too easy to decode with the plain eyes, I decided to use the Caesar cipher with the key 18. +Because the rot13 is too easy to decode with the plain eyes, I decided to use +the Caesar cipher with the key 18. Lzw xajkl tsffwj ak wfugvwv mkafy AWWW 754 xdgslk gf dafw 47. Al ak hjaflwv gfdq gf dalldw-wfvasf esuzafwk.