Changes between Version 2 and Version 3 of TracDev/ApiDocs
- Timestamp:
- Nov 18, 2010, 10:56:44 PM (13 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracDev/ApiDocs
v2 v3 5 5 We propose two ways for taking benefit from this embedded documentation in order to generate API documentation references. 6 6 7 - Full API reference using [http://epydoc.sourceforge.net/ epydoc]8 - Semi-automatic API documentation using [http://sphinx.pocoo.org Sphinx]7 - ''apiref'' — Full API reference using [http://epydoc.sourceforge.net/ epydoc] 8 - ''apidoc'' — Semi-automatic API documentation using [http://sphinx.pocoo.org Sphinx] 9 9 10 10 With epydoc, the entirety of the API is covered, but we have less control over the generated output and the documentation is a bit more "dry" and feels, well, ... auto-generated. … … 15 15 16 16 17 == View the documentation — //TODO add links to generated docs//18 - Trac 0.11 ( apiref)19 - Trac 0.12 ( apiref)20 - Trac 0.13dev ( apiref | apidoc)17 == View the documentation 18 - Trac 0.11 (''apiref'' for [http://www.edgewall.org/docs/tags-trac-0.11.7/epydoc/ 0.11.7]) 19 - Trac 0.12 (''apiref'' for [http://www.edgewall.org/docs/tags-trac-0.12/epydoc/ 0.12] | [http://www.edgewall.org/docs/tags-trac-0.12.1/epydoc/ 0.12.1] | [http://www.edgewall.org/docs/branches-0.12-stable/epydoc/ 0.12-stable]) 20 - Trac 0.13dev ([http://www.edgewall.org/docs/trac-trunk/epydoc/ apiref] | [http://www.edgewall.org/docs/trac-trunk/html/ apidoc HTML] | [http://www.edgewall.org/docs/trac-trunk/pdf/trac_dev.pdf apidoc PDF]) 21 21 22 Note that as Trac 0.11 and 0.12 were not really prepared for being processed, the quality of the generated documentation is all but perfect. Not that the one for 0.13dev is, but there we're working on it ;-)22 Note that as Trac 0.11 and 0.12 were not really prepared for being processed, the quality of the generated documentation is all but perfect. It's not that the one for 0.13dev is, but there we're working on it. The 0.12-stable link and the 0.13dev links above should correspond to the latest version //(not yet updated automatically - this is coming next)//. 23 23 24 24 == Generating the documentation