/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to doc/BUILD-NOTES

  • Committer: John Arbash Meinel
  • Date: 2009-09-09 18:52:56 UTC
  • mto: (4634.52.16 2.0)
  • mto: This revision was merged to the branch mainline in revision 4738.
  • Revision ID: john@arbash-meinel.com-20090909185256-rdaxy872xauoem46
https://launchpad.net/bugs/402623
Work around bug #402623 by allowing BTreeGraphIndex(...,unlimited_cache=True).

The basic issue is that the access pattern for chk pages is fully random,
because the keys are 'sha1' handles. As such, we have no locality of
reference, and downloading a large project over HTTP can cause us to
redownload all of the .cix pages multiple times. The bug report
noticed the pages getting downloaded 4-5 times.
This was causing a significant increase in the total bytes downloaded.
(For Launchpad, downloading the 10MB cix file 5 times was 50MB, out of
around 160MB total download.)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/BUILD-NOTES
 
1
To build Bazaar's documentation using Sphinx, follow the
 
2
steps below.
 
3
 
 
4
0. Install Sphinx. You'll need Sphinx 0.6 or later. If that
 
5
   version isn't available in your package manager repositories
 
6
   yet, install python-easyinstall and use it to install Sphinx.
 
7
   See http://sphinx.pocoo.org/ for details.
 
8
 
 
9
1. Build the Bazaar docs normally, i.e. in the project root, run:
 
10
 
 
11
   make docs
 
12
 
 
13
2. Tweak the User Guide index page used:
 
14
 
 
15
   cd doc/en/user-guide
 
16
   bzr mv index.txt index-for-1x.txt
 
17
   bzr mv index-for-2x.txt index.txt
 
18
 
 
19
3. Tweak the Release Notes TOC depth:
 
20
 
 
21
   cd ../release-notes
 
22
   vi NEWS.txt  (change depth to 2)
 
23
 
 
24
4. Change to the docs directory and build the site:
 
25
 
 
26
   cd ../..
 
27
   make html
 
28
 
 
29
The generated output site can be found in _build/html.
 
30
 
 
31
Note: All of the above will Just Work soon. For now, we don't
 
32
want to break the existing doc generation until a few issues
 
33
with the Sphinx-generated site are ironed out, e.g. links from
 
34
the User Reference to ../user-guide/index.html#foo no longer
 
35
work when the User Guide is nicely split into topic pages.