← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/index.txt

  • Committer: Tarmac
  • Author(s): Vincent Ladeuil
  • Date: 2017-01-30 14:42:05 UTC
  • mfrom: (6620.1.1 trunk)
  • Revision ID: tarmac-20170130144205-r8fh2xpmiuxyozpv
Merge  2.7 into trunk including fix for bug #1657238 [r=vila]

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
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
 
 
 
6
Introduction
 
7
============
 
8
 
 
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
   documenting-changes
 
29
 
 
30
* `Contributing to Bazaar Documentation <http://wiki.bazaar.canonical.com/ContributingToTheDocs>`_ (wiki)
 
31
 
 
32
 
 
33
Architecture overviews
 
34
======================
 
35
 
 
36
.. toctree::
 
37
   :maxdepth: 1
 
38
 
 
39
   configuration
 
40
   fetch
 
41
   transports
 
42
   ui
 
43
 
 
44
Releasing and Packaging
 
45
=======================
 
46
 
 
47
.. toctree::
 
48
   :maxdepth: 1
 
49
 
 
50
   releasing
 
51
   ppa
 
52
   ec2 
 
53
 
 
54
 
 
55
Developing using bzrlib
 
56
=======================
 
57
 
 
58
.. toctree::
 
59
   :maxdepth: 1
 
60
 
 
61
   overview
 
62
   integration
 
63
 
 
64
* `Writing plugins for Bazaar <http://doc.bazaar.canonical.com/plugins/en/plugin-development.html>`_ (web link)
 
65
 
 
66
* `bzrlib API reference <http://people.canonical.com/~mwh/bzrlibapi/>`_
 
67
  (web link)
 
68
 
 
69
 
 
70
Other documents
 
71
===============
 
72
 
 
73
.. toctree::
 
74
   :maxdepth: 1
 
75
 
 
76
   principles
 
77
   plans
 
78
   specifications
 
79
   implementation-notes
 
80
   miscellaneous-notes
 
81
 
 
82
 
 
83
Licence
 
84
============
 
85
 
 
86
Copyright 2005-2011 Canonical Ltd. Bazaar is free software, and you
 
87
may use, modify and redistribute both Bazaar and this document under
 
88
the terms of the GNU General Public License version 2 or later.  See
 
89
<http://www.gnu.org/licenses/>.
137
90
 
138
91
.. |--| unicode:: U+2014
139
92