A plaintext README

README

@@ -18,43 +18,125 @@
                                                                                                 
 
 
-REQUIRED dependencies:
+Required runtime dependencies
+=============================
 
-bash: required for the main script [file: ponysay]
+    bash      : required for the main script [file: ponysay]
 
-cowsay: this is a wrapper for cowsay
+    cowsay    : this is a wrapper for cowsay
 
-coreutils: the main script [file: ponysay] uses stty, cut, ls, cat, head and tail
+    coreutils : the main script [file: ponysay] uses stty, cut, ls, cat, head and tail
 
-sed: used to remove .pony from pony named when running ponysay -l
+    sed       : used to remove .pony from pony named when running ponysay -l
 
 
+Optional runtime dependencies
+=============================
 
-OPTIONAL dependencies:
+    (none)
-
-(none)
 
 
+Package building dependencies
+=============================
 
-PONY PROVIDER dependencies:
+    gcc       : used for compiling ponysaytruncater.c
 
-make: required to run `make ttyponies` 
+    gzip      : used for compressing manpages
 
-coreutils: ln and readlink are used in ttyponies.sh
+    make      : required to run the make script
 
-bash: required to run ttyponies.sh
+    coreutils : make script uses install unlink rm ln mkdir cp
-
-util-say: used by ttyponies.sh to builder ttyponies from xterm ponies
-# Available for Arch:ers in AUR as util-say-git are on github at https://github.com/maandree/util-say
 
 
+Dependencies for pony providers
+===============================
 
-MAKE dependencies:
+    make      : required to run `make ttyponies` 
 
-gcc: used for compiling ponysaytruncater.c
+    coreutils : ln and readlink are used in ttyponies.sh
 
-gzip: used for compressing manpages
+    bash      : required to run ttyponies.sh
 
-make: required to run the make script
+    util-say  : used by ttyponies.sh to builder ttyponies from xterm ponies
+    -- Available for Arch:ers in AUR as util-say-git (https://aur.archlinux.org/packages.php?ID=60241)
+    -- and on github at https://github.com/maandree/util-say
+
+
+Installation on GNU/Linux (or other Unix implementations)
+=========================================================
+
+    Before installing ponysay, make sure your system have the packages listed under
+    [Required runtime dependencies] and [Package building dependencies] installed.
+    
+    Download or clone the project.  bleeding edge:  https://github.com/erkin/ponysay/tarball/master
+    	     	      	  	    release:        https://github.com/erkin/ponysay/tags
+    
+    In the terminal, `cd` into the ponysay directory and execute `make && make install`.
+    This will install ponysay into the $PREFIX (/usr by default, meaning you may need to
+    run `make install` as root, e.g by running `sudo make install`.)
+    
+    In order to use ponysay, run:                 ponysay "I am just the cutest pony!"
+    Or if you have a specific pony in your mind:  ponysay -f pinkie "Partay!~"
+    
+    Run `info ponysay`, `man 6 ponysay` (man ponysay) or `ponysay -h` for more information.
+    A Spanish manual is available: man -L es 6 ponysay
+
+
+Pony fortune on terminal startup
+================================
+
+    This requires that you have fortune utility installed. You can install it from your
+    distributions package repository, it should be named fortune or fortune-mod.
+    
+    Edit your ~/.bashrc and this line [to the end should work]:
+    
+        fortune | ponysay
+    
+    Now every time you open a terminal a pony should give your fortune.
+    
+    If you wany ponified fortuned the are some stuff you can try:
+        
+        A gigantic sed script:
+          http://www.reddit.com/r/mylittlelinux/comments/srixi/using_ponysay_with_a_ponified_fortune_warning/
+        
+        ponypipe:
+          https://github.com/maandree/ponypipe
+          https://aur.archlinux.org/packages.php?ID=60228
+        
+        pinkie-pie:
+          https://github.com/maandree/pinkie-pie
+          https://aur.archlinux.org/packages.php?ID=60229
+
+
+Ponies in TTY (Linux VT)
+========================
+
+    If you have a custom colour palette edit your ~/.bashrc and add:
+    
+        if [ "$TERM" = "linux" ]; then
+            function ponysay
+            {
+                exec ponysay "$@"
+                #RESET PALETTE HERE
+            }
+        fi
+
+
+FAQ
+===
+
+    Q: The output looks like a mess in (TTY/PuTTY/other)!
+    
+    A: Unfortunately, there's nothing much we can do about it.
+       See issue 1:  https://github.com/erkin/ponysay/issues/1
+    
+    Q: You are missing (my-favourite-pony)!
+    
+    A: Ask and we'll add!
+       https://github.com/erkin/ponysay/issues
+    
+    Q: Which programs do you use to generate the pony files?
+    
+    A: The pony files are actually mostly a bunch of selected browser
+       ponies that are generated into cow files via img2xterm or util-say.
 
-coreutils: make script uses install unlink rm ln mkdir cp

README.md

@@ -14,7 +14,7 @@ This is often sufficient, but if is not you may be missing one of the standard p
 [Download](https://github.com/erkin/ponysay/downloads) or clone the project.
 In the terminal, `cd` into the ponysay directory and `make && make install`.
 
-This will install ponysay into the $PREFIX (`/usr` by default, meaning you may need to `make install` as root, e.g. `sudo make install`).
+This will install ponysay into the $PREFIX (`/usr` by default, meaning you may need to `make install` as root, e.g. `sudo make install`.)
 
 If either `make` or `make install` fails you be missing one of the standard packages:
 [gcc](ftp://ftp.gnu.org/gnu/gcc/), [gzip](ftp://ftp.gnu.org/gnu/gzip/), [make](ftp://ftp.gnu.org/gnu/make/) or [coreutils](ftp://ftp.gnu.org/gnu/coreutils/).
@@ -28,12 +28,12 @@ Or if you have a specific pony in your mind:
     ponysay -f pinkie "Partay!~"
 
 Run `info ponysay`, `man 6 ponysay` or `ponysay -h` for more information.
-A spanish manual is available: `man -L es 6 ponysay`.
+A Spanish manual is available: `man -L es 6 ponysay`.
 
 
 ### Pony fortune on terminal startup 
 
-This requires that you have the `fortune` utility installed. You can install it from your repositories (may be namned `fortune-mod`)
+This requires that you have the `fortune` utility installed. You can install it from your repositories (may be named `fortune-mod`)
 or just fetch the source code from [here](ftp://ftp.ibiblio.org/pub/linux/games/amusements/fortune/).
 
 You can try [this](http://www.reddit.com/r/mylittlelinux/comments/srixi/using_ponysay_with_a_ponified_fortune_warning/) script or
@@ -52,7 +52,7 @@ If you have a custom colour palette edit your `~/.bashrc` and add
     if [ "$TERM" = "linux" ]; then
         function ponysay
         {
-            exec ponysay $@
+            exec ponysay "$@"
             #RESET PALETTE HERE
         }
     fi