1
=================================
2
Breezy Developer Document Catalog
3
=================================
6
Overall developer documentation
7
===============================
9
* `Developer Guide <HACKING.html>`_
11
* `Architectural Overview <overview.html>`_ |--| describes some of the
12
most important classes and concepts.
14
* `breezy API reference <https://www.breezy-vcs.org/developers/api/>`_
16
|--| automatically generated API reference information
18
* `Integrating with Breezy <http://wiki.bazaar.canonical.com/Integrating_with_Bazaar>`_
19
(wiki) |--| a guide for writing Python programs that work with Breezy.
21
* `Revision Properties <revision-properties.html>`_ |--| An application
22
can set arbitrary per-revision key/value pairs to store app-specific
25
* `Testing <testing.html>`_ |--| Guide to writing tests for Breezy.
27
* `Code Review <code-review.html>`_.
29
* `Breezy Code Style Guide <code-style.html>`_.
31
* `Writing plugins <plugin-development.html>`_
32
|--| specific advice on writing Breezy plugins.
34
* `Documenting changes <documenting-changes.html>`_.
39
* `Releasing Breezy <releasing.html>`_ |--|
40
Checklist to make a release of Breezy.
42
* `Managing the Breezy PPA <ppa.html>`_ |--| Packaging Breezy for Ubuntu.
44
* `Giving back <http://wiki.bazaar.canonical.com/BzrGivingBack>`_ (wiki) |--| How to get
45
your changes to Breezy integrated into a release.
47
* `Profiling notes <profiling.html>`_ |--| Instructions on how to profile
48
brz code and visualize the results.
50
* `EC2 resources <ec2.html>`_ |--| A team resource for
51
Windows packaging and testing, and Ubuntu testing.
53
* `Tracking Bugs in Breezy <bug-handling.html>`_ |--| How we use the bug
56
Architecture overviews
57
======================
59
* `Transports <transports.html>`_ |--| Transport virtual filesystem
65
* `Performance roadmap <performance-roadmap.html>`_ |--| The roadmap
66
for fixing performance in brz over the next few releases.
68
* `Co-located branches <colocated-branches.html>`_ |--| Planned(?) support
69
for storing multiple branches in one file-system directory.
71
* `Breezy Windows Shell Extension Options <tortoise-strategy.html>`_ |--|
72
Implementation strategy for Breezy Windows Shell Extensions, aka
75
* `CHK Optimized index <improved_chk_index.html>`_
80
* `API versioning <api-versioning.html>`_ |--| breezy API versioning.
82
* `Apport error reporting <apport.html>`_ |--| Capture data to report
85
* `Authentication ring <authentication-ring.html>`_ |--| Configuring
88
* `Bundles <bundles.html>`_ |--| All about brz bundles.
90
* `Container format <container-format.html>`_ |--| Notes on a container format
91
for streaming and storing Breezy data.
93
* `Groupcompress <groupcompress-design.html>`_ |--| Notes on the compression
94
technology used in CHK repositories.
96
* `Indices <indices.html>`_ |--| The index facilities available within
99
* `Inventories <inventory.html>`_ |--| Tree shape abstraction.
101
* `LCA merge <lca-merge.html>`_ |--| A nice new merge algorithm.
103
* `Network protocol <network-protocol.html>`_ |--| Custom network protocol.
105
* `Plugin APIs <plugin-api.html>`_ |--| APIs plugins should use.
107
* `Repositories <repository.html>`_ |--| What repositories do and are used for.
109
* `Repository stream <repository-stream.html>`_ |--| Notes on streaming data
110
for repositories (a layer above the container format).
112
* `Integration Guide <integration.html>`_ |--| A guide to integrate breezy into
113
any python application.
115
* `Breezy and case-insensitive file systems <case-insensitive-file-systems.html>`_
116
|--| How Breezy operates on case-insensitive file systems such as commonly
117
found on Windows, USB sticks, etc.
119
* `Development repository formats <development-repo.html>`_ |--| How to
120
work with repository formats that are still under development.
121
Contains instructions for those implementing new formats, of course,
122
but also for (bleeding-edge) end users of those formats.
127
* `Knit pack repositories <packrepo.html>`_ |--| KnitPack repositories
128
(new in Bazaar 0.92).
133
* `BTree Index Prefetch <btree_index_prefetch.html>`_ |--| How brz decides
134
to pre-read extra nodes in the btree index.
136
* `Computing last_modified values <last-modified.html>`_ for inventory
139
* `Content filtering <content-filtering.html>`_
141
* `LCA Tree Merging <lca_tree_merging.html>`_ |--| Merging tree-shape when
142
there is not a single unique ancestor (criss-cross merge).
147
* `dirstate <dirstate.html>`_ |--| An observation re. the dirstate file
149
* `"brz update" performance analysis <update.html>`_ |--| "brz update"
153
.. |--| unicode:: U+2014