Re: Python evolution: Unease

From: Terry Reedy (tjreedy_at_udel.edu)
Date: 01/06/05 

To: python-list@python.org
Date: Wed, 5 Jan 2005 19:37:01 -0500

"John Roth" <newsgroups@jhrothjr.com> wrote in message
news:10to8qulnc3vke1@news.supernews.com...
> I would like to contribute some documentation to Python.
> I've got the time, I write quite a bit, etc. I've got fairly
> strong opinions about some things that need to be documented,
> (such as all the new style class descriptor stuff from 2.2)
> and I have relatively little difficulty matching the existing style.

I would love to see the written better and in the manuals.

> However, I don't
> know TEX, Latex, CVS or Sourceforge. (The latter two are
> on my "learn sometime soon so I can put PyFIT where it belongs"
> list.)

Neither do I.

> I have no desire to install Perl to run the documentation toolchain.
> I also have no particular desire to write up a bunch of final
> format stuff and drop it on someone else to put into the latex
> format so it can be included.

Why not? If someone is willing to do the part that is easier for him
(format pre-written ascii text), why aren't you willing to do the part that
is easier for you (write the text)?

I am asking as someone who has done just that, at least on a micro scale of
occasional sentences in response to bug reports.

Terry J. Reedy

Relevant Pages

  • Re: font families in plain tex
    ... let alone separate documentation. ... TeX and LaTeX are developed by different sets of people. ... format), or, that will then could be ... Use LaTeX or ConTeXt. ...
    (comp.text.tex)
  • Re: Software For Book Writing
    ... The reason that I want to use something like Vim is because I'd be able to make a more censored version of the book on the fly for certain people to download ... I thought that latex would be what I needed, ... but isn't that for documentation? ... It would be a life saver in those cases where people insist on receiving documents in .doc format. ...
    (Debian-User)
  • Re: Software For Book Writing
    ... The reason that I want to use something like Vim is because I'd be ... but isn't that for documentation? ... There seems to be a module that converts LaTex into just about anything, ... Can it convert from latex to odt format? ...
    (Debian-User)
  • Re: How to include files?
    ... I have a collection of documentation for my software. ... I'd strongly recommend to use LaTeX. ... If you have docbook xml already, you're way ahead of the game. ... you use latex as your intermediate format to output beautiful ...
    (comp.text.tex)
  • Re: Linux syscalls
    ... > convert the documentation on msdn.com to plain ASCII text ... And though the repetitions of some Hollywood cliche' about the ... all their opinions on board to provide as useful a service as ... simple plain text file...I personally am not greatly fussed at ...
    (alt.lang.asm)