← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/index.txt

  • Committer: Robert Collins
  • Date: 2007-07-15 15:40:37 UTC
  • mto: (2592.3.33 repository)
  • mto: This revision was merged to the branch mainline in revision 2624.
  • Revision ID: robertc@robertcollins.net-20070715154037-3ar8g89decddc9su
Make GraphIndex accept nodes as key, value, references, so that the method
signature is closer to what a simple key->value index delivers. Also
change the behaviour when the reference list count is zero to accept
key, value as nodes, and emit key, value to make it identical in that case
to a simple key->value index. This may not be a good idea, but for now it
seems ok.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/index.txt
1
 
=================================
2
 
Bazaar Developer Document Catalog
3
 
=================================
4
 
 
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.
 
1
=======================
 
2
Bazaar Developers Guide
 
3
=======================
 
4
 
 
5
###################
 
6
Documentation index
 
7
###################
29
8
 
30
9
Process
31
10
=======
32
11
 
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.
 
12
* `General HACKING HOWTO <HACKING.htm>`_
 
13
 
 
14
  Guide to policies and tools for working on Bazaar itself.
 
15
 
 
16
* `Profiling notes <profiling.htm>`_
 
17
 
 
18
  Instructions on how to profile bzr code and visualize the results.
52
19
 
53
20
Plans
54
21
=====
55
22
 
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>`_
 
23
* `Performance roadmap <performance-roadmap.htm>`_
 
24
 
 
25
  The roadmap for fixing performance in bzr over the next few releases.
67
26
 
68
27
Specifications
69
28
==============
70
29
 
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
112
 
============
113
 
 
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
136
 
 
137
 
 
138
 
.. |--| unicode:: U+2014
139
 
 
140
 
..
141
 
   vim: ft=rst tw=74 ai
 
30
* `API versioning <api-versioning.htm>`_
 
31
 
 
32
  bzrlib API versioning.
 
33
 
 
34
* `Bundles <bundles.htm>`_
 
35
 
 
36
  All about bzr bundles.
 
37
 
 
38
* `Container format <container-format.htm>`_
 
39
 
 
40
  Notes on a container format for streaming and storing Bazaar data.
 
41
 
 
42
* `Indices <indices.txt>`_
 
43
 
 
44
  The index facilities available within bzrlib.
 
45
 
 
46
* `Repositories <repository.htm>`_
 
47
 
 
48
  What repositories do and are used for.