~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/index.txt

(jameinel) Allow 'bzr serve' to interpret SIGHUP as a graceful shutdown.
 (bug #795025) (John A Meinel)

Show diffs side-by-side

added added

removed removed

Lines of Context:
2
2
Bazaar Developer Document Catalog
3
3
=================================
4
4
 
5
 
Bazaar user documentation is in the 
6
 
`Main Document Catalog <../index.html>`_.
7
 
 
8
 
Overall developer documentation
9
 
===============================
10
 
 
11
 
* `Developer Guide <../en/developer-guide/HACKING.html>`_
12
 
 
13
 
* `Architectural Overview <overview.html>`_ |--| describes some of the
14
 
  most important classes and concepts.
15
 
 
16
 
* `bzrlib API reference <http://starship.python.net/crew/mwh/bzrlibapi-oe/>`_ 
17
 
  (external link)
18
 
  |--| automatically generated API reference information
19
 
 
20
 
* `Integrating with Bazaar <http://bazaar-vcs.org/Integrating_with_Bazaar>`_
21
 
  (wiki) |--| a guide for writing Python programs that work with Bazaar.
22
 
 
23
 
* `Testing <testing.html>`_ |--| Testing bzr.
24
 
 
25
 
* `Writing plugins <http://bazaar-vcs.org/WritingPlugins>`_ (wiki) 
26
 
  |--| specific advice on writing Bazaar plugins.
27
 
 
28
 
Process
29
 
=======
30
 
 
31
 
* `The Bazaar Development Cycle <cycle.html>`_ |--| The monthly
32
 
  development cycle and how to run it.
33
 
  
34
 
* `Releasing Bazaar <releasing.html>`_ |--| 
35
 
  Checklist to make a release of Bazaar.
36
 
 
37
 
* `Managing the Bazaar PPA <ppa.html>`_ |--| Packaging Bazaar for Ubuntu.
38
 
 
39
 
* `Giving back <http://bazaar-vcs.org/BzrGivingBack>`_ (wiki) |--| How to get
40
 
  your changes to Bazaar integrated into a release.
41
 
 
42
 
* `Profiling notes <profiling.html>`_ |--| Instructions on how to profile 
43
 
  bzr code and visualize the results.
44
 
 
45
 
Plans
46
 
=====
47
 
 
48
 
* `Performance roadmap <performance-roadmap.html>`_ |--| The roadmap 
49
 
  for fixing performance in bzr over the next few releases.
50
 
 
51
 
Specifications
52
 
==============
53
 
 
54
 
* `API versioning <api-versioning.html>`_ |--| bzrlib API versioning.
55
 
 
56
 
* `Authentication ring <authentication-ring.html>`_ |--| Configuring
57
 
  authentication.
58
 
 
59
 
* `Bundles <bundles.html>`_ |--| All about bzr bundles.
60
 
 
61
 
* `Container format <container-format.html>`_ |--| Notes on a container format
62
 
  for streaming and storing Bazaar data.
63
 
 
64
 
* `Repository stream <repository-stream.html>`_ |--| Notes on streaming data
65
 
  for repositories (a layer above the container format).
66
 
 
67
 
* `Indices <indices.html>`_ |--| The index facilities available within bzrlib.
68
 
 
69
 
* `Inventories <inventory.html>`_ |--| Tree shape abstraction.
70
 
 
71
 
* `LCA merge <lca-merge.html>`_ |--| A nice new merge algorithm.
72
 
 
73
 
* `Network protocol <network-protocol.html>`_ |--| Custom network protocol.
74
 
 
75
 
* `Plugin APIs <plugin-api.html>`_ |--| APIs plugins should use.
76
 
 
77
 
* `Repositories <repository.html>`_ |--| What repositories do and are used for.
78
 
 
79
 
* `Integration Guide <integration.html>`_ |--| A guide to integrate bzrlib into
80
 
  any python application.
81
 
 
82
 
* `Bazaar and case-insensitive file systems <case-insensitive-file-systems.html>`_
83
 
  |--| How Bazaar operates on case-insensitive file systems such as commonly
84
 
  found on Windows, USB sticks, etc.
85
 
 
86
 
Data formats
87
 
============
88
 
 
89
 
* `Knit pack repositories <packrepo.html>`_ |--| KnitPack repositories 
90
 
  (new in Bazaar 0.92).
91
 
 
 
5
 
 
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://starship.python.net/crew/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/>.
92
90
 
93
91
.. |--| unicode:: U+2014
94
92