← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/index.txt

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2010-09-01 08:02:42 UTC
  • mfrom: (5390.3.3 faster-revert-593560)
  • Revision ID: pqm@pqm.ubuntu.com-20100901080242-esg62ody4frwmy66
(spiv) Avoid repeatedly calling self.target.all_file_ids() in
 InterTree.iter_changes. (Andrew Bennetts)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/index.txt
3
3
=================================
4
4
 
5
5
 
6
 
Overall developer documentation
7
 
===============================
8
 
 
9
 
* `Developer Guide <../en/developer-guide/HACKING.html>`_
10
 
 
11
 
* `Architectural Overview <overview.html>`_ |--| describes some of the
12
 
  most important classes and concepts.
13
 
 
14
 
* `bzrlib API reference <http://starship.python.net/crew/mwh/bzrlibapi/>`_ 
15
 
  (external link)
16
 
  |--| automatically generated API reference information
17
 
 
18
 
* `Integrating with Bazaar <http://bazaar-vcs.org/Integrating_with_Bazaar>`_
19
 
  (wiki) |--| a guide for writing Python programs that work with Bazaar.
20
 
 
21
 
* `Revision Properties <revision-properties.html>`_ |--| An application
22
 
  can set arbitrary per-revision key/value pairs to store app-specific
23
 
  data.
24
 
 
25
 
* `Testing <testing.html>`_ |--| Guide to writing tests for Bazaar.
26
 
 
27
 
* `Writing plugins <http://bazaar-vcs.org/WritingPlugins>`_ (wiki) 
28
 
  |--| specific advice on writing Bazaar plugins.
29
 
 
30
 
Process
31
 
=======
32
 
 
33
 
* `The Bazaar Development Cycle <cycle.html>`_ |--| The monthly
34
 
  development cycle and how to run it.
35
 
  
36
 
* `Releasing Bazaar <releasing.html>`_ |--| 
37
 
  Checklist to make a release of Bazaar.
38
 
 
39
 
* `Managing the Bazaar PPA <ppa.html>`_ |--| Packaging Bazaar for Ubuntu.
40
 
 
41
 
* `Giving back <http://bazaar-vcs.org/BzrGivingBack>`_ (wiki) |--| How to get
42
 
  your changes to Bazaar integrated into a release.
43
 
 
44
 
* `Profiling notes <profiling.html>`_ |--| Instructions on how to profile 
45
 
  bzr code and visualize the results.
46
 
 
47
 
* `EC2 resources <ec2.html>`_ |--| A team resource for 
48
 
  Windows packaging and testing, and Ubuntu testing.
49
 
 
50
 
* `Tracking Bugs in Bazaar <bug-handling.html>`_ |--| How we use the bug 
51
 
  tracker.
52
 
 
53
 
Plans
54
 
=====
55
 
 
56
 
* `Performance roadmap <performance-roadmap.html>`_ |--| The roadmap 
57
 
  for fixing performance in bzr over the next few releases.
58
 
 
59
 
* `Co-located branches <colocated-branches.html>`_ |--| Planned(?) support
60
 
  for storing multiple branches in one file-system directory.
61
 
 
62
 
* `Bazaar Windows Shell Extension Options <tortoise-strategy.html>`_ |--|
63
 
  Implmentation strategy for Bazaar Windows Shell Extensions, aka
64
 
  TortoiseBzr.
65
 
 
66
 
* `CHK Optimized index <improved_chk_index.html>`_
67
 
 
68
 
Specifications
69
 
==============
70
 
 
71
 
* `API versioning <api-versioning.html>`_ |--| bzrlib API versioning.
72
 
 
73
 
* `Authentication ring <authentication-ring.html>`_ |--| Configuring
74
 
  authentication.
75
 
 
76
 
* `Bundles <bundles.html>`_ |--| All about bzr bundles.
77
 
 
78
 
* `Container format <container-format.html>`_ |--| Notes on a container format
79
 
  for streaming and storing Bazaar data.
80
 
 
81
 
* `Groupcompress <groupcompress-design.html>`_ |--| Notes on the compression
82
 
  technology used in CHK repositories.
83
 
 
84
 
* `Indices <indices.html>`_ |--| The index facilities available within bzrlib.
85
 
 
86
 
* `Inventories <inventory.html>`_ |--| Tree shape abstraction.
87
 
 
88
 
* `LCA merge <lca-merge.html>`_ |--| A nice new merge algorithm.
89
 
 
90
 
* `Network protocol <network-protocol.html>`_ |--| Custom network protocol.
91
 
 
92
 
* `Plugin APIs <plugin-api.html>`_ |--| APIs plugins should use.
93
 
 
94
 
* `Repositories <repository.html>`_ |--| What repositories do and are used for.
95
 
 
96
 
* `Repository stream <repository-stream.html>`_ |--| Notes on streaming data
97
 
  for repositories (a layer above the container format).
98
 
 
99
 
* `Integration Guide <integration.html>`_ |--| A guide to integrate bzrlib into
100
 
  any python application.
101
 
 
102
 
* `Bazaar and case-insensitive file systems <case-insensitive-file-systems.html>`_
103
 
  |--| How Bazaar operates on case-insensitive file systems such as commonly
104
 
  found on Windows, USB sticks, etc.
105
 
 
106
 
* `Development repository formats <development-repo.html>`_ |--| How to
107
 
  work with repository formats that are still under development.
108
 
  Contains instructions for those implementing new formats, of course,
109
 
  but also for (bleeding-edge) end users of those formats.
110
 
 
111
 
Data formats
 
6
Introduction
112
7
============
113
8
 
114
 
* `Knit pack repositories <packrepo.html>`_ |--| KnitPack repositories 
115
 
  (new in Bazaar 0.92).
116
 
 
117
 
Implementation notes
118
 
====================
119
 
 
120
 
* `BTree Index Prefetch <btree_index_prefetch.html>`_ |--| How bzr decides
121
 
  to pre-read extra nodes in the btree index.
122
 
 
123
 
* `Computing last_modified values <last-modified.html>`_ for inventory
124
 
  entries
125
 
 
126
 
* `LCA Tree Merging <lca_tree_merging.html>`_ |--| Merging tree-shape when
127
 
  there is not a single unique ancestor (criss-cross merge).
128
 
 
129
 
Miscellaneous
130
 
=============
131
 
 
132
 
* `dirstate <dirstate.html>`_ |--| An observation re. the dirstate file
133
 
 
134
 
* `"bzr update" performance analysis <update.html>`_ |--| "bzr update"
135
 
  performance analysis
 
9
.. toctree::
 
10
   :maxdepth: 1
 
11
 
 
12
   contribution-quickstart
 
13
 
 
14
 
 
15
Working on Bazaar
 
16
=================
 
17
 
 
18
.. toctree::
 
19
   :maxdepth: 1
 
20
 
 
21
   cycle
 
22
   profiling
 
23
   bug-handling
 
24
   HACKING
 
25
   testing
 
26
   code-review
 
27
   code-style
 
28
 
 
29
* `Contributing to Bazaar Documentation <http://wiki.bazaar.canonical.com/ContributingToTheDocs>`_ (wiki)
 
30
 
 
31
 
 
32
Architecture overviews
 
33
======================
 
34
 
 
35
.. toctree::
 
36
   :maxdepth: 1
 
37
 
 
38
   transports
 
39
 
 
40
Releasing and Packaging
 
41
=======================
 
42
 
 
43
.. toctree::
 
44
   :maxdepth: 1
 
45
 
 
46
   releasing
 
47
   ppa
 
48
   ec2 
 
49
 
 
50
 
 
51
Developing using bzrlib
 
52
=======================
 
53
 
 
54
.. toctree::
 
55
   :maxdepth: 1
 
56
 
 
57
   overview
 
58
   integration
 
59
 
 
60
* `Writing plugins for Bazaar <http://doc.bazaar.canonical.com/plugins/en/plugin-development.html>`_ (web link)
 
61
 
 
62
* `bzrlib API reference <http://starship.python.net/crew/mwh/bzrlibapi/>`_
 
63
  (web link)
 
64
 
 
65
 
 
66
Other documents
 
67
===============
 
68
 
 
69
.. toctree::
 
70
   :maxdepth: 1
 
71
 
 
72
   principles
 
73
   plans
 
74
   specifications
 
75
   implementation-notes
 
76
   miscellaneous-notes
136
77
 
137
78
 
138
79
.. |--| unicode:: U+2014