[Python-checkins] python/dist/src/Doc/doc doc.tex,1.63,1.64

[fdrake@sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/doc
In directory usw-pr-cvs1:/tmp/cvs-serv16077/doc

Modified Files:
	doc.tex 
Log Message:
Added some notes on setting up the documentation tools on Cygwin.

Index: doc.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/doc/doc.tex,v
retrieving revision 1.63
retrieving revision 1.64
diff -C2 -d -r1.63 -r1.64
*** doc.tex	19 Apr 2002 04:50:44 -0000	1.63
--- doc.tex	1 May 2002 22:05:30 -0000	1.64
***************
*** 1756,1759 ****
--- 1756,1799 ----
  
  
+   \subsection{Working on Cygwin \label{cygwin}}
+ 
+     \begin{notice}[warning]
+       This section is a work in progress.  It really doesn't work
+       yet.  If anyone knows Cygwin and wants to help, send email to
+       \email{python-docs@python.org}.
+     \end{notice}
+ 
+     Installing the required tools under Cygwin under Cygwin can be a
+     little tedious, if only because many packages are more difficult
+     to install under Cygwin.
+ 
+     Using the Cygwin installer, make sure your Cygwin installation
+     includes Perl, Python, and the \TeX{} packages.  Perl and Python
+     are located under \menuselection{Interpreters} in the installer
+     The \TeX{} packages are located in the \menuselection{Text}
+     section; installing the tetex-beta, texmf, texmf-base, and
+     texmf-extra ensures that all the required packages are available.
+     (There may be a more minimal set, but I've not spent time trying
+     to minimize the installation.)
+ 
+     The netpbm package is used by \LaTeX2HTML, and \emph{must} be
+     installed before \LaTeX2HTML can be successfully installed, even
+     though they will never be used for most Python documentation.
+     References to download locations are located in the \ulink{netpbm
+     README}{http://netpbm.sourceforge.net/README}.  Install according
+     to the instructions.
+ 
+     \LaTeX2HTML can be installed from the source archive, but only
+     after munging one of the files in the distribution.  Edit the file
+     \file{L2hos.pm} in the top level of the unpacked distribution;
+     near the bottom of the file, change the text
+     \code{\$\textasciicircum{}O} with the text \code{'unix'}.  Proceed
+     using this command to build and install the software:
+ 
+ \begin{verbatim}
+ % configure && make install
+ \end{verbatim}
+ 
+ 
  \section{Future Directions \label{futures}}