← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to HACKING

  • Committer: John Arbash Meinel
  • Date: 2006-07-25 15:10:57 UTC
  • mto: (1946.2.6 reduce-knit-churn)
  • mto: This revision was merged to the branch mainline in revision 1886.
  • Revision ID: john@arbash-meinel.com-20060725151057-2c2137712774f59d
Update HACKING to be rst compliant

Show diffs side-by-side

added added

removed removed

Lines of Context:
HACKING
38
38
  pipelines.
39
39
 
40
40
  Recommended values are 
41
 
    0- OK, 
42
 
    1- Conflicts in merge-like operations, or changes are present in
 
41
    0. OK, 
 
42
    1. Conflicts in merge-like operations, or changes are present in
43
43
       diff-like operations. 
44
 
    2- Unrepresentable diff changes (i.e. binary files that we cannot show 
 
44
    2. Unrepresentable diff changes (i.e. binary files that we cannot show 
45
45
       a diff of).
46
 
    3- An error or exception has occurred.
 
46
    3. An error or exception has occurred.
47
47
 
48
48
Evolving interfaces
49
49
-------------------
260
260
option, then you should be writing a UI test.  If you are both adding UI
261
261
functionality and library functionality, you will want to write tests for 
262
262
both the UI and the core behaviours.  We call UI tests 'blackbox' tests
263
 
and they are found in bzrlib/tests/blackbox/*.py. 
 
263
and they are found in ``bzrlib/tests/blackbox/*.py``. 
264
264
 
265
265
When writing blackbox tests please honour the following conventions:
266
266
 
305
305
 
306
306
To skip a particular test (or set of tests), you need to use a negative
307
307
match, like so::
 
308
 
308
309
  ./bzr selftest '^(?!.*blackbox)'  
309
310
 
310
311
 
365
366
for those characters.  (Although this is not totally reliable we might still
366
367
accept these and assume they should be put into UTF-8.)
367
368
 
368
 
A similar edge case is that the url ``http://foo/sweet%2Fsour" contains
 
369
A similar edge case is that the url ``http://foo/sweet%2Fsour`` contains
369
370
one directory component whose name is "sweet/sour".  The escaped slash is
370
371
not a directory separator.  If we try to convert URLs to regular Unicode
371
372
paths this information will be lost.