Anonymous avatar Anonymous committed 4fa041e

Add license and repository info to front page, add comments where sections need to be written.

Comments (0)

Files changed (5)

doc/_templates/index.html

 
   <p>
     Sphinx is a tool that makes it easy to create intelligent and beautiful
-    documentation for Python projects, written by Georg Brandl.  It was
-    originally created to translate <a href="http://docs.python.org/dev/">the
+    documentation for Python projects, written by Georg Brandl and licensed
+    under the BSD license.</p>
+  <p>It was originally created to translate <a href="http://docs.python.org/dev/">the
     new Python documentation</a>, but has now been cleaned up in the hope that
     it will be useful to many other projects.  (Of course, this site is also
     created from reStructuredText sources using Sphinx!)
-
   </p>
   <p>
     Although it is still under constant development, the following features are
     <li><b>Automatic indices:</b> general index as well as a module index</li>
     <li><b>Code handling:</b> automatic highlighting using the <a
     href="http://pygments.org">Pygments</a> highlighter</li>
+    <li><b>Extensions:</b> automatic testing of code snippets, inclusion of
+    docstrings from Python modules, and more</li>
   </ul>
   <p>
     Sphinx uses <a href="http://docutils.sf.net/rst.html">reStructuredText</a>
     package on the <a href="http://pypi.python.org/pypi/Sphinx">Python Package
     Index</a>.
   </p>
+  <p>The code can be found on the Python SVN server, under
+    <tt>http://svn.python.org/projects/doctools</tt>.</p>
   
 {% endblock %}
 
    Its name is ``linkcheck``.
 
+
+Built-in Sphinx extensions that offer more builders are:
+
+* :mod:`~sphinx.ext.doctest`
+* :mod:`~sphinx.ext.coverage`

doc/ext/builderapi.rst

 Writing new builders
 ====================
 
+XXX to be expanded.
+
 .. class:: sphinx.builder.Builder
 
    This is the base class for all builders.

doc/ext/coverage.rst

    To use this builder, activate the coverage extension in your configuration
    file and give ``-b coverage`` on the command line.
 
+XXX to be expanded.
 
 Several new configuration values can be used to specify what the builder
 should check:

doc/ext/refcounting.rst

 
 .. module:: sphinx.ext.refcounting
    :synopsis: Keep track of reference counting behavior.
+
+XXX to be written.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.