/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/supportability.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/supportability.txt
1
 
************************
2
 
Bazaar-NG Supportability
3
 
************************
4
 
 
5
 
The goal is to be able to diagnose and fix a bug the first time it is
6
 
reported, even if the reporter or developer can't reproduce it.
7
 
 
8
 
Done:
9
 
 
10
 
* Verbose logs are always written to ``.bzr.log`` in the current
11
 
  directory.  This include all error messages and some trace messages
12
 
  that are not normally displayed.  It also includes backtraces if
13
 
  an exception occurs.
14
 
 
15
 
To do:
16
 
 
17
 
* The --verbose option should send debug output to stderr.
18
 
 
19
 
* Re-read changesets after writing them to a temporary file, but
20
 
  before permanently committing them.  Make sure that they are valid
21
 
  XML (against RELAX-NG schema), that they can be parsed, and that
22
 
  they recreate the right revision.  This should help prevent the
23
 
  archive ever getting corrupted, which is a pain to reverse.