~ubuntu-branches/ubuntu/quantal/nova/quantal-proposed

« back to all changes in this revision

Viewing changes to doc/README.rst

  • Committer: Package Import Robot
  • Author(s): Chuck Short
  • Date: 2012-08-16 14:04:11 UTC
  • mto: This revision was merged to the branch mainline in revision 84.
  • Revision ID: package-import@ubuntu.com-20120816140411-0mr4n241wmk30t9l
Tags: upstream-2012.2~f3
ImportĀ upstreamĀ versionĀ 2012.2~f3

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
=================
2
 
Building the docs
3
 
=================
4
 
 
5
 
Dependencies
6
 
============
7
 
 
8
 
Sphinx_
9
 
  You'll need sphinx (the python one) and if you are
10
 
  using the virtualenv you'll need to install it in the virtualenv
11
 
  specifically so that it can load the nova modules.
12
 
 
13
 
  ::
14
 
 
15
 
    pip install Sphinx
16
 
 
17
 
Graphviz_
18
 
  Some of the diagrams are generated using the ``dot`` language
19
 
  from Graphviz.
20
 
 
21
 
  ::
22
 
 
23
 
    sudo apt-get install graphviz
24
 
 
25
 
.. _Sphinx: http://sphinx.pocoo.org
26
 
 
27
 
.. _Graphviz: http://www.graphviz.org/
28
 
 
29
 
 
30
 
Use `make`
31
 
==========
32
 
 
33
 
Just type make::
34
 
 
35
 
  % make
36
 
 
37
 
Look in the Makefile for more targets.
38
 
 
39
 
 
40
 
Manually
41
 
========
42
 
 
43
 
  1. Generate the code.rst file so that Sphinx will pull in our docstrings::
44
 
     
45
 
      % ./generate_autodoc_index.sh > source/code.rst
46
 
 
47
 
  2. Run `sphinx_build`::
48
 
 
49
 
      % sphinx-build -b html source build/html
50
 
 
51
 
 
52
 
The docs have been built
53
 
========================
54
 
 
55
 
Check out the `build` directory to find them. Yay!