~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/supportability.txt

  • Committer: Martin Pool
  • Date: 2006-06-15 05:36:34 UTC
  • mto: This revision was merged to the branch mainline in revision 1797.
  • Revision ID: mbp@sourcefrog.net-20060615053634-4fd52ba691855659
Clean up many exception classes.

Errors indicating a user error are now shown with is_user_error on the
exception; use this rather than hardcoding a list of exceptions that should be
handled this way.

Exceptions now inherit from BzrNewException where possible to use consistent
formatting method.

Remove rather obsolete docstring test on Branch.missing_revisions.

Remove dead code from find_merge_base.


Show diffs side-by-side

added added

removed removed

Lines of Context:
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.