================================= Bazaar Developer Document Catalog ================================= Overall developer documentation =============================== * `Developer Guide `_ * `Architectural Overview `_ |--| describes some of the most important classes and concepts. * `bzrlib API reference `_ (external link) |--| automatically generated API reference information * `Integrating with Bazaar `_ (wiki) |--| a guide for writing Python programs that work with Bazaar. * `Revision Properties `_ |--| An application can set arbitrary per-revision key/value pairs to store app-specific data. * `Testing `_ |--| Guide to writing tests for Bazaar. * `Writing plugins `_ |--| specific advice on writing Bazaar plugins. (web link) Process ======= * `The Bazaar Development Cycle `_ |--| The monthly development cycle and how to run it. * `Releasing Bazaar `_ |--| Checklist to make a release of Bazaar. * `Managing the Bazaar PPA `_ |--| Packaging Bazaar for Ubuntu. * `Giving back `_ (wiki) |--| How to get your changes to Bazaar integrated into a release. * `Profiling notes `_ |--| Instructions on how to profile bzr code and visualize the results. * `EC2 resources `_ |--| A team resource for Windows packaging and testing, and Ubuntu testing. * `Tracking Bugs in Bazaar `_ |--| How we use the bug tracker. Plans ===== * `Performance roadmap `_ |--| The roadmap for fixing performance in bzr over the next few releases. * `Co-located branches `_ |--| Planned(?) support for storing multiple branches in one file-system directory. * `Bazaar Windows Shell Extension Options `_ |--| Implmentation strategy for Bazaar Windows Shell Extensions, aka TortoiseBzr. * `CHK Optimized index `_ Specifications ============== * `API versioning `_ |--| bzrlib API versioning. * `Apport error reporting `_ |--| Capture data to report bugs. * `Authentication ring `_ |--| Configuring authentication. * `Bundles `_ |--| All about bzr bundles. * `Container format `_ |--| Notes on a container format for streaming and storing Bazaar data. * `Groupcompress `_ |--| Notes on the compression technology used in CHK repositories. * `Indices `_ |--| The index facilities available within bzrlib. * `Inventories `_ |--| Tree shape abstraction. * `LCA merge `_ |--| A nice new merge algorithm. * `Network protocol `_ |--| Custom network protocol. * `Plugin APIs `_ |--| APIs plugins should use. * `Repositories `_ |--| What repositories do and are used for. * `Repository stream `_ |--| Notes on streaming data for repositories (a layer above the container format). * `Integration Guide `_ |--| A guide to integrate bzrlib into any python application. * `Bazaar and case-insensitive file systems `_ |--| How Bazaar operates on case-insensitive file systems such as commonly found on Windows, USB sticks, etc. * `Development repository formats `_ |--| How to work with repository formats that are still under development. Contains instructions for those implementing new formats, of course, but also for (bleeding-edge) end users of those formats. Data formats ============ * `Knit pack repositories `_ |--| KnitPack repositories (new in Bazaar 0.92). Implementation notes ==================== * `BTree Index Prefetch `_ |--| How bzr decides to pre-read extra nodes in the btree index. * `Computing last_modified values `_ for inventory entries * `Content filtering `_ * `LCA Tree Merging `_ |--| Merging tree-shape when there is not a single unique ancestor (criss-cross merge). Miscellaneous ============= * `dirstate `_ |--| An observation re. the dirstate file * `"bzr update" performance analysis `_ |--| "bzr update" performance analysis .. |--| unicode:: U+2014 .. vim: ft=rst tw=74 ai