Documentation on testing pyshp about pyshp

[micahcochran]

On Python 3.4.3, doctest seems to not work very well at all.

1 items had failures:
  68 of 140 in README.txt
140 tests in 1 items.
72 passed and 68 failed.
***Test Failed*** 68 failures.

It seems that the criteria for "Expect nothing" has changed.

On Python 2.7 the testing is almost 100%.

EDIT: Using dos2unix to convert README.txt makes the tests work on Linux.

[micahcochran]

Here are instructions to run the tests.

1. Download pyshp's zip file and uncompress. And change directory into the pyshp/ folder.

2. Extra step for a Linux box, convert the README.txt by running
   $ dos2unix README.txt. (Before conversion $ file README.txt will report the file as "README.txt: ASCII text, with CRLF line terminators", after conversion it reports "README.txt: ASCII text")

3. Run tests from the pyshp/ folder. This folder contains the README.txt and the blockgroups shapefile that are required for testing. These files are NOT installed with pyshp.

   a. Run from prompt:
   $ python shapefile.py

   b. Run from python console:

>>> import shapefile
>>> shapefile.test()

I'll do a PR to add this to the README, hopefully soon.

[micahcochran]

Fixed in 1.2.5 release.