revise README in pymodel and bin directories

also remove bin/pymodel_symlinks, superceded by new bin/pma etc. commands

Author: jon-jacky

bin/README.md

@@ -1,6 +1,6 @@
 
-bin directory
-=============
+PyModel bin directory
+=====================
 
 This directory contains the commands for PyModel.
 
@@ -16,20 +16,33 @@ commands.
 The commands are:
 
 - *pma*, *pmg*, *pmt*, *pmv*: the four main PyModel commands.  They
-  just invoke the Python modules with the same names in the *pymodel*
-  directory.  See *commands.txt* in the *notes* directory, or print
+  just run the Python modules with the same names in the *pymodel*
+  directory.  For details, see *commands.txt* in the *notes* directory, or print
   their built-in help by typing *pma -h* etc.
 
-- *clogdiff*: works with trun.py to execute and check
-  regression tests.  See *test.txt* in the *notes* directory.
-
-- *dotpdf*, *dotps*, *dotsvg*: invoke the Graphviz *dot* program to
+- *dotpdf*, *dotps*, *dotsvg*: run the Graphviz *dot* program to
   produce *.pdf*, *.ps*, or *.svg* graphics files from the *.dot*
   files generated by *pmg*
 
-- *tpath*: put the current directory *.* (dot) on *PYTHONPATH*. This
-   is needed by the PyModel programs *pmt* etc., which all import
-   Python modules in the current directory that are named on the command line.
+- *trun*: runs test scripts, including sample demonstrations.  See
+   *test.txt* in the *notes* directory.
+
+- *clogdiff*: works with *trun* to execute and check
+  regression tests.  See *test.txt* in the *notes* directory.
+
+- *wsgirunner*: runs WSGI-compliant web applications on *localhost*,
+  such as *webapp* in the *WebApplication* sample, or *wsgidemo* here.
+
+- *pymodel_paths*: assigns paths for running PyModel from these *PyModel*
+    directories.  To prepare to use PyModel, execute this script,
+    or put the commands from this script into your *.profile* or *.bashrc*.
+    These commands add *PyModel/bin* to the execution
+    *PATH*, and add *PyModel/pymodel* to the *PYTHONPATH*. They also
+    add the current directory to the *PYTHONPATH*, because the
+    PyModel programs *pmt* etc. all import Python modules in the
+    current directory that are named on the command line.  
+    (If you install PyModel so its commands and modules are placed
+    in system directories, you may no longer need these commands.)
 
 
 Revised Apr 2013

bin/pymodel_symlinks

@@ -16,18 +16,18 @@ its modules are usually invoked through the commands in the PyModel
 The Python modules are:
 
 - *pma*, *pmg*, *pmt*, *pmv*: the main modules for the four main
-   PyModel programs.  See *commands.txt* in the *notes* directory, or
-   print their built-in help by typing *pma -h* etc.
+   PyModel programs.  For details, see *commands.txt* in the *notes* 
+   directory, or print their built-in help by typing *pma -h* etc.
 
 - *trun*: runs test scripts, including sample demonstrations.  See
    *test.txt* in the *notes* directory.
 
-- *wsgirunner*: runs WSGI-compliant web applications on localhost
+- *wsgirunner*: runs WSGI-compliant web applications on *localhost*,
+  such as *webapp* in the *WebApplication* sample, or *wsgidemo* here.
 
 - *wsgidemo*: a sample web application to run with *wsgirunner*
 
-- *ActionNameCoverage* and all the other modules are used
-  by  *pma*, *pmg*, *pmt*, and *pmv*.
+All the other modules here are used by *pma*, *pmg*, *pmt*, and *pmv*.
 
 
 Revised Apr 2013