← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/HACKING.txt

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2007-10-26 08:56:09 UTC
  • mfrom: (2592.3.247 mbp-writegroups)
  • Revision ID: pqm@pqm.ubuntu.com-20071026085609-c3r8skfrmjj21j0m
Unlock while in a write group now aborts the write group, unlocks, and errors.  Also includes the knit extraction one-liner tweak.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/HACKING.txt
470
470
they're displayed or handled.
471
471
 
472
472
 
 
473
Testing warnings
 
474
----------------
 
475
 
 
476
The Python ``warnings`` module is used to indicate a non-fatal code
 
477
problem.  Code that's expected to raise a warning can be tested through
 
478
callCatchWarnings.
 
479
 
 
480
The test suite can be run with ``-Werror`` to check no unexpected errors
 
481
occur.
 
482
 
 
483
However, warnings should be used with discretion.  It's not an appropriate
 
484
way to give messages to the user, because the warning is normally shown
 
485
only once per source line that causes the problem.  You should also think
 
486
about whether the warning is serious enought that it should be visible to
 
487
users who may not be able to fix it.
 
488
 
 
489
 
473
490
Interface implementation testing and test scenarios
474
491
---------------------------------------------------
475
492