[Pythonmac-SIG] "Official" mac python Docs Project: requestsfor help/comments

[Chris Barker]

Francois Granger wrote:

> My spare cycles are rare like yours probably. And I am not a great
> programmer. But MacPython helped me to solve easily and elegantly some
> problems. For a beginning, I'd like to help by proof reading and correcting
> documentation.

I'll take whatever help I can get. I'll be posting updates to the docs
on this list.

> A pointer to "Inside Ma" online somewhere ???
> http://developer.apple.com/techpubs/macos8/mac8.html
> This is what I got.

Anyone else have other or better pointers?

 
> Is there a way to edit LaTEX documents on Mac ?
> I got these:
> 
> http://www.esm.psu.edu/mac-tex/
> http://www.esm.psu.edu/mac-tex/editors.html

This is the best site for TeX-on-the-Mac info. I use OzTeX and the Alpha
editor, it has a very nice LaTeX mode. The Pepper editor seems to be
pretty nice as well. 

Unfortunately, the whole Python docs system is all set up to be run on a
Unix-like system. That includes using make to build everything,
LaTeX2html, a perl Script, to build the html, and assorted unix tools to
put it all together. It ran "out-of-the-box" on my Linux box, but
getting it all to work on the Mac would be a challenge. All is not lost,
however. The LaTeX stuff can certainly be edited on a Mac, and there is
no reason why the printable version couldn't be made on the Mac as well,
you're just not going to get the html, and info, etc. That doesn't
really matter, however. eventually, it all gets put into cvs, and built
by the docs folks anyway. I'll be testing it out on my Linux box in the
meantime.

Thanks for your help,.

-Chris

-- 
Christopher Barker,
Ph.D.                                                           
cbarker@jps.net                      ---           ---           ---
http://www.jps.net/cbarker          -----@@       -----@@       -----@@
                                   ------@@@     ------@@@     ------@@@
Water Resources Engineering       ------   @    ------   @   ------   @
Coastal and Fluvial Hydrodynamics -------      ---------     --------    
------------------------------------------------------------------------
------------------------------------------------------------------------