[capi-sig] Documenting a C/Py API
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
> > 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
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