Update md files.

Author: sbrodehl

CHANGELOG CHANGELOG.md

@@ -1,26 +1,25 @@
-
-Version 0.1.7:
+## Version 0.1.7:
 
     2004-04-30:
 
         - Added scientific calculator example (calc1)
         - Added support for error-handling rules
         - Added support for rule handlers to raise errors
 
-Version 0.1.6:
+## Version 0.1.6:
 
     2004-04-30:
 
         - Added ANSI C parser to examples
 
-Version 0.1.5:
+## Version 0.1.5:
 
     2004-04-30:
 
         - Added XML support - can now export and import parse trees to/from
           XML strings or xml.dom.minidom objects
 
-Version 0.1.4:
+## Version 0.1.4:
 
     2004-04-29:
 
@@ -31,7 +30,7 @@ Version 0.1.4:
 
         - tidied up and fleshed out the walkthrough document
 
-Version 0.1.3:
+## Version 0.1.3:
 
     2004-04-28:
 
@@ -48,7 +47,7 @@ Version 0.1.3:
 
         - various other fixes and tidy-ups
 
-Version 0.1.2:
+## Version 0.1.2:
 
     2004-04-25:
 
@@ -61,7 +60,7 @@ Version 0.1.2:
         - added '-c' option to bison2py utility, which causes the generation
           of handler code as separate node classes instead of methods
 
-Version 0.1.1:
+## Version 0.1.1:
 
     2004-04-23:
 
@@ -72,9 +71,8 @@ Version 0.1.1:
         
         - added java parser example
 
-Version 0.1.0:
+## Version 0.1.0:
 
     2004-04-23:
 
         - first release
-

CREDITS

@@ -0,0 +1,9 @@
+PyBison was designed and written by David McNab <[email protected]>.
+
+---------------------
+
+Ideas for the class model were borrowed from the PLY Python Parser Builder toolkit - [http://systems.cs.uchicago.edu/ply/](http://systems.cs.uchicago.edu/ply/)
+
+----------------------
+
+The javaparser.l and javaparser.y files in the examples/ directory are based (almost verbatim) on scripts written by Professor Dave Binkley [http://www.cs.loyola.edu/~binkley/](http://www.cs.loyola.edu/~binkley/) at the Department of Computer Science at Loyola College in Maryland [http://www.cs.loyola.edu/](http://www.cs.loyola.edu/) (permission pending)

CREDITS.md

@@ -0,0 +1,29 @@
+# Install file for PyBison
+
+1. Prerequisites
+
+    You will need:
+    
+      - Python 2.2 or later, with development headers and libraries
+      - GNU bison (or yacc) - www.gnu.org or gnuwin32.sf.net
+      - GNU flex (or lex) - ditto
+      - The Pyrex Python/C wrapper creation framework:
+          - http://www.cosc.canterbury.ac.nz/~greg/python/Pyrex/
+      - A standard C compiler and linker
+
+2. Installing
+
+      - Crack the tarball somewhere convenient (eg your home directory)
+      - cd into the top level directory of this package
+      - become root, and type 'python setup.py install'
+
+With all going well, you should see a bunch of harmless warning messages
+from the compilation of bison.c, but no errors.
+
+The following commands will verify if the installation succeeded:
+
+```bash
+$ which bison2py
+/usr/bin/bison2py
+$ python -c "import bison"
+```

INSTALL

@@ -9,25 +9,26 @@ I just added the one-line installation-script and colorfied the syntax-errors th
 ### Global Python Installation (sudo needed)
 Needs sudo for the installation of the following dependencies:
 - **apt-get:** bison, flex
+    - `sudo apt install bison flex`
 - **pip3**: cython, six, pyrex, pybison itself
+    - `pip3 install -U cython six pyrex pybison`
 
 Install with:
-```sh
+```bash
 curl -s https://raw.githubusercontent.com/da-h/pybison/master/install_global.sh | bash
 ```
 
 ### Virtualenv Python Installation (no sudo needed)
 First, install the dependencies
-```sh
+```bash
 sudo apt-get install bison flex
 ```
 Now, install with:
-```sh
+```bash
 curl -s https://raw.githubusercontent.com/da-h/pybison/master/install_venv.sh | bash
 ```
 
-
-
+----------------------------------------------------------
 
 For further information, please read the following original **README**:  
 
@@ -67,6 +68,5 @@ The other frameworks utilise a fiddly script syntax -
 
 ## How do I use this?
 
-Refer to the INSTALL file for setting up.  
-Refer to the examples and the doco for usage.
-
+Refer to the [INSTALL](INSTALL.md) file for setting up.  
+Refer to the [examples](examples) and the [docs](docs) for usage.