[capi-sig] Documenting a C/Py API

Martin Poirier theeth at yahoo.com
Mon Jul 2 17:46:42 CEST 2007

--- Carsten Haese <carsten at uniqsys.com> wrote:

> On Mon, 2007-07-02 at 23:30 +1000, Campbell Barton
> wrote:
> > However Id be interested to know how other
> projects deal with the issue 
> > of maintaining docstrings and online docs.
> I maintain separate docstrings and online docs for
> one simple reason:
> The online docs can be more extensive than
> docstrings. Docstrings are
> for brief memory-joggers. Online documentation can
> contain examples and
> generally more detail that's not appropriate for
> docstrings.

Can you elaborate on this a bit. What kind of tools do
you use to generate/maintain your docs?


- Blender developer

Finding fabulous fares is fun.  
Let Yahoo! FareChase search your favorite travel sites to find flight and hotel bargains.

More information about the capi-sig mailing list