fix .gitignore, Makefile, README.md for 2005/persano

2005/persano/README.md

@@ -1,30 +1,40 @@
 # Best of show
 
-Mauro Persano
-São Paulo
-Brazil
-mauro_persano@yahoo.com
+    Mauro Persano
+    São Paulo
+    Brazil
+    mauro_persano@yahoo.com
 
-## Judges' Comments
+# To build:
 
-### To build
+```sh
+make
+```
 
-        cc -lm persano.c -o persano
+### To run:
 
-If your system is one of those that distinguish between text and binary
-streams, you must know what to do to switch the standard output into
-binary mode (e.g. adding a line to the source code or specifying a
-linker option).
+```sh
+./persano p q [num frames]
+```
 
-### Try
+### Try:
 
-        persano 3 16 > knot3-16.gif
+```sh
+./persano 3 16 > knot3-16.gif
+```
 
 Open the GIF file with a viewer capable of displaying animated GIFs and
 watch closely at the bottom of the picture (you may need to use
 "gifsicle" - a great tool to manipulate animated GIFs - to slow down the
 animation and to compress the GIFs generated by the entry).
 
+## Judges' comments:
+
+If your system is one of those that distinguish between text and binary
+streams, you must know what to do to switch the standard output into
+binary mode (e.g., adding a line to the source code or specifying a
+linker option).
+
 What needs to be done to fix the problem?
 
 Solving the author's exercises below may or may not help.
@@ -32,7 +42,7 @@ Solving the author's exercises below may or may not help.
 At the time of judging, the approximation of π used in the program could
 not be found on mathworld.com.
 
-## Selected Author's Comments
+## Author's comments:
 
 ### NAME
 
@@ -41,7 +51,9 @@ not be found on mathworld.com.
 
 ### SYNOPSIS
 
-        knot p q [num frames]
+```sh
+knot p q [num frames]
+```
 
 ### DESCRIPTION
 
@@ -55,12 +67,16 @@ circle embedded in R3 [2]).
 
 Sample usage:
 
-        knot 3 2 1 > foo.gif
+```sh
+./persano 3 2 1 > foo.gif
+```
 
 writes a non-animated GIF (a single frame) stream of a rendered trefoil
 knot to the file foo.gif.
 
-        knot 5 2
+```sh
+./persano 5 2
+```
 
 writes a GIF stream with a rendering of Solomon's Seal knot to standard
 output; since the number of frames is not specified, an animation with