Initial commit

1 files changed, 53 insertions, 0 deletions

diff --git a/info/pstdoc/README b/info/pstdoc/README
new file mode 100644
index 0000000000..3b912a65e6
--- /dev/null
+++ b/info/pstdoc/README
@@ -0,0 +1,53 @@
+This package is distributed under the LaTeX Project Public License.
+
+It provides help with syntax and keywords associated with PSTricks commands. See the screenshot for typical output.
+
+Installation of pstdoc.
+
+Python 2.5 or more recent is required. The database file pstCommands.db must be in the same folder as the Python script pstdoc.py.
+
+Mac:
+1. Set up your Terminal Window so that it understands ANSI commands, by setting the following in ~/.profile or ~/.MacOSX/environment.plist.
+
+CLICOLOR=true
+TERM=xterm-color
+LSCOLORS=exfxcxdxbxegedabagacad
+
+2. Check that your version of Python is recent enough.
+
+3. Rename pstdoc.py to just pstdoc, and copy it to some folder in your PATH. I copied it to ~/bin, along with the SQLite database file pstCommands.db
+
+4. Enter, for example, 
+pstdoc \psarc (or just pstdoc psarc)
+to get the syntax and all keywords that might apply. Arguments with yellow background are optional. A red double left arrow indicates a default replacement value. Output look better when the Terminal window is twice as wide as normal.
+
+Windows:
+
+Install Python (the MSI version) from ActiveState and restart Windows. You invoke it as
+
+python c:\mybin\pstdoc.py \psarc
+
+after installing pstdoc.py and pstCommands.db in some folder in your PATH---say, C:\mybin. A batch file pstdoc.bat in c:\mybin containing just the line
+
+python C:\mybin\pstdoc.py %1
+
+will allow it to be invoked with 
+
+pstdoc \psarc
+
+The output has no color and no double left arrow character---a left pointing double-angle quote is used instead. The presence of this character indicates that the argument is optional, and spells out the default value.
+
+Linux:
+
+It should work if used in a terminal that understands ANSI color commands.
+
+Apache Web Server:
+
+This is the nicest interface, IMHO.
+
+In the Webserver folder:
+
+Documents <- pstCommands.db, psthelp.css, index.html
+CGI-Executables <- parsehelp.py
+
+I keep this running at all times on my Mac OS 10.6.7 (check Web Sharing in System Preferences/Sharing) so that help is available in the browser by browsing to http://localhost.
\ No newline at end of file