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)


     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="">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="">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!)
     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="">Pygments</a> highlighter</li>
+    <li><b>Extensions:</b> automatic testing of code snippets, inclusion of
+    docstrings from Python modules, and more</li>
     Sphinx uses <a href="">reStructuredText</a>
     package on the <a href="">Python Package
+  <p>The code can be found on the Python SVN server, under
+    <tt></tt>.</p>
 {% endblock %}
    Its name is ``linkcheck``.
+Built-in Sphinx extensions that offer more builders are:
+* :mod:`~sphinx.ext.doctest`
+* :mod:`~sphinx.ext.coverage`


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


    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:


 .. 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
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.