Documentation examples needed

Dave Kuhlman dkuhlman at rexx.com
Sat Jul 19 02:36:48 CEST 2003


Stuart D. Gathman wrote:

> On Thu, 17 Jul 2003 00:44:44 -0400, Dave Cole wrote:
> 
>> Stuart> Is there a small project with documentation in the Python
>> Stuart> standard that I can use as an example?
>> 
>> We have some:
>> 
>>         http://www.object-craft.com.au/projects/albatross/
>>         http://www.object-craft.com.au/projects/sybase/sybase/
> 
> Thank you.  Your Makefile is much less confusing than the one that
> comes
> with Python!  It also points out a shortcoming of the RPM
> packaging.  The python2-devel package includes everything you need
> to compile python extension modules, but does not include what is
> needed to "compile"
> python documentation!  Are third party module writers not supposed
> to document anything? :-) It looks like I'll have to download the
> Python sources and create my own RPMs.
> 
> Presumably, I do not need *everything* in the Doc directory to
> compile my
> own docs.  Probably just the tools directory, and maybe texinputs
> and
> templates.  Is the list of what is needed for 3rd party docs
> documented
> somewhere?  

The file Doc/README (in the Python source code distribution) has
some of this information.  You will have to scan down a ways for
it, though.

  - Dave

-- 
Dave Kuhlman
http://www.rexx.com/~dkuhlman
dkuhlman at rexx.com




More information about the Python-list mailing list