/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to doc/developers/api-versioning.txt

  • Committer: Martin Pool
  • Date: 2008-04-24 07:22:53 UTC
  • mto: This revision was merged to the branch mainline in revision 3415.
  • Revision ID: mbp@sourcefrog.net-20080424072253-opmjij7xfy38w27f
Remove every assert statement from bzrlib!

Depending on the context they are:

 * turned into an explicit if/raise of either AssertionError 
   or something more specific -- particularly where they protect
   programming interfaces, complex invariants, or data file integrity
 * removed, if they're redundant with a later check, not protecting
   a meaningful invariant
 * turned into a selftest method on tests

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/api-versioning.txt
8
8
:Date: 2007-06-26
9
9
 
10
10
bzrlib has a rich API which is used both internally, and externally by
11
 
plugins_ and scripts. To allow the API to change, specifically to allow
 
11
plugins and scripts. To allow the API to change, specifically to allow
12
12
support for features and methods to be removed, without causing hard to
13
13
diagnose bugs in the clients of the API, bzrlib provides explicit API
14
14
compatibility data, and a compact API to allow scripts and plugins to
16
16
written against.
17
17
 
18
18
 
19
 
.. _plugins: plugin-api.html
20
 
 
21
 
 
22
19
.. contents::
23
20
 
24
21
 
86
83
with ``(0, 18, 0)``.
87
84
 
88
85
+------------+---------------+
89
 
| API        | Covers        |
90
 
+============+===============+
 
86
| API        | Covers        | 
 
87
+============+===============+ 
91
88
| bzrlib     | All of bzrlib |
92
89
+------------+---------------+
93
90