summaryrefslogtreecommitdiff
path: root/admin
Commit message (Collapse)AuthorAgeFilesLines
* doc: add JavaDoc to SphinxNoah Watkins2012-10-261-2/+20
| | | | Signed-off-by: Noah Watkins <noahwatkins@gmail.com>
* Revert "admin/build-doc: Use installed Sphinx and its dependencies, when ↵Dan Mick2012-10-081-14/+4
| | | | | | | | | | possible." This reverts commit c65ffe9f7f27bc0fe5afab36e9ef0de42bc3c74c. oneiric, where the doc gitbuilder runs, doesn't have the --system-site-packages option; let's get docs back and sort this out offline. (virtualenv 1.6.4-0ubuntu1 on oneiric, 1.7.1.2-1 on precise)
* admin/build-doc: Use installed Sphinx and its dependencies, when possible.Sean Channel2012-10-041-4/+14
| | | | | | | | | | | | | | | | | | This avoids the delay of installing Sphinx inside the virtualenv; especially, compiling lxml is slow. If Sphinx is not installed system-wide (or it's too old), this will still install a copy inside the virtualenv, to keep working. Thanks to Sean for the push to make this happen, and testing the various scenarios; I (Tv) took the liberty of changing the commit to use venv-python for the manpage build too, avoid the nonstandard "which" command, be more careful about quoting, and explain more fully what's going on in the comment. Closes: https://github.com/ceph/ceph/pull/24 Signed-off-by: Sean Channel <pentabular@gmail.com> Signed-off-by: Tommi Virtanen <tv@inktank.com>
* manpage-howto.txt: note that man/Makefile.am may need update tooDan Mick2012-09-271-4/+5
| | | | Signed-off-by: Dan Mick <dan.mick@inktank.com>
* Add howto for changing man pagesDan Mick2012-09-271-0/+7
| | | | Signed-off-by: Dan Mick <dan.mick@inktank.com>
* build-doc: use alternate virtualenv dir, if specifiedSage Weil2012-03-121-5/+7
| | | | | | | The docs gitbuilder will use this to avoid rebuilding the virtualenv on every build. Signed-off-by: Sage Weil <sage@newdream.net>
* github.com/NewDreamNetwork -> github.com/cephSage Weil2012-03-021-2/+2
|
* doc: Switch doxygen integration from breathe to asphyxiate.Tommi Virtanen2012-01-092-11/+1
| | | | | | | | | | TODO: path of librados.h is now just the basename TODO: no enum support for now TODO: no @bug support for now Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>
* doc: Reorganize pip calls to use a requirements file.Tommi Virtanen2011-12-062-5/+3
| | | | | | | | | The conditional before running pip install was unnecessary, "pip install" on already installed packages is fast (as long as it's not --upgrade), and --quiet makes it not spam the console. Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>
* doc: Switch diagram tools from dia to ditaa.Tommi Virtanen2011-12-061-4/+28
| | | | | | | | | | | | | Now you can create diagrams easily with the ".. ditaa::" directive in the Sphinx documents. admin/build-doc now checks for debs required for building the documentation, or just lists commands missing for hosts not using dpkg. For more on Ditaa, see http://ditaa.sourceforge.net/ Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>
* doc: Add peering state diagramSamuel Just2011-11-291-0/+2
| | | | Signed-off-by: Samuel Just <samuel.just@dreamhost.com>
* doc: add documentation for librbd python bindingsJosh Durgin2011-09-301-1/+1
| | | | Signed-off-by: Josh Durgin <josh.durgin@dreamhost.com>
* doc: Move internals into a new section, /dev.Tommi Virtanen2011-09-011-1/+0
| | | | | | | | | | Most of the doc is user-oriented, let's isolate internals more. Split into multiple files. Clean up RST. Use Sphinx's graphviz plugin for graphs. Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>
* Add object store architecture overview pictureColin Patrick McCabe2011-08-311-0/+2
| | | | | | | It requires graphviz / dot to be installed. It generates a nice graph of the dependencies between classes in the object store. Signed-off-by: Colin McCabe <colin.mccabe@dreamhost.com>
* Integrate Doxygen into Sphinx docs.Tommi Virtanen2011-08-291-1/+17
| | | | Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>
* First draft of the documentation overhaul.Tommi Virtanen2011-08-292-0/+52
To build the docs, run ./admin/build-doc. To browse them, either get them on any static website, or just run ./admin/serve-doc to serve them quickly off of port 8080. build-doc sets up a virtualenv to avoid needing Sphinx installed system-wide. serve-doc needs thttpd installed. Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>