← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/HACKING.txt

  • Committer: Jelmer Vernooij
  • Date: 2011-12-16 19:18:39 UTC
  • mto: This revision was merged to the branch mainline in revision 6391.
  • Revision ID: jelmer@samba.org-20111216191839-eg681lxqibi1qxu1
Fix remaining tests.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/HACKING.txt
117
117
`your_lp_username`.  You can push your branch to Launchpad directly from
118
118
Bazaar::
119
119
 
120
 
  $ bzr push lp:~your_lp_username/bzr/meaningful_name_here
 
120
  $ bzr push lp:~<your_lp_username>/bzr/meaningful_name_here
121
121
 
122
122
After you have pushed your branch, you will need to propose it for merging to
123
123
the Bazaar trunk.  Go to
124
 
<https://launchpad.net/your_lp_username/bzr/meaningful_name_here> and choose
125
 
"Propose for merging into another branch".  Select "~bzr/bzr/trunk" to hand
 
124
<https://launchpad.net/~<your_lp_username>/bzr/meaningful_name_here> and choose
 
125
"Propose for merging into another branch".  Select "lp:bzr" to hand
126
126
your changes off to the Bazaar developers for review and merging.
127
127
 
128
128
Alternatively, after pushing you can use the ``lp-propose`` command to 
254
254
    This file covers a brief introduction to Bazaar and lists some of its
255
255
    key features.
256
256
 
257
 
NEWS
258
 
    Summary of changes in each Bazaar release that can affect users or
259
 
    plugin developers.
260
 
 
261
257
setup.py
262
258
    Installs Bazaar system-wide or to your home directory.  To perform
263
259
    development work on Bazaar it is not required to run this file - you
285
281
    Documentation specifically targeted at Bazaar and plugin developers.
286
282
    (Including this document.)
287
283
 
 
284
doc/en/release-notes/
 
285
 
 
286
    Detailed changes in each Bazaar release (there is one file by series:
 
287
    bzr-2.3.txt, bzr-2.4.txt, etc) that can affect users or plugin
 
288
    developers.
 
289
 
 
290
doc/en/whats-new/
 
291
 
 
292
    High-level summaries of changes in each Bazaar release (there is one
 
293
    file by series: whats-new-in-2.3.txt, whats-new-in-2.4.txt, etc).
288
294
 
289
295
 
290
296
Automatically-generated API reference information is available at
430
436
be disabled if necessary by setting the environment variable
431
437
``BZR_SIGQUIT_PDB=0``.
432
438
 
 
439
All tests inheriting from bzrlib.tests.TestCase can use ``self.debug()``
 
440
instead of the longer ``import pdb; pdb.set_trace()``. The former also works
 
441
when ``stdin/stdout`` are redirected (by using the original ``stdin/stdout``
 
442
file handles at the start of the ``bzr`` script) while the later doesn't.
 
443
``bzrlib.debug.set_trace()`` also uses the original ``stdin/stdout`` file
 
444
handles.
433
445
 
434
446
Debug Flags
435
447
===========
511
523
Because Transports work in URLs (as defined earlier), printing the raw URL
512
524
to the user is usually less than optimal. Characters outside the standard
513
525
set are printed as escapes, rather than the real character, and local
514
 
paths would be printed as ``file://`` urls. The function
 
526
paths would be printed as ``file://`` URLs. The function
515
527
``unescape_for_display`` attempts to unescape a URL, such that anything
516
528
that cannot be printed in the current encoding stays an escaped URL, but
517
529
valid characters are generated where possible.
576
588
stuff covered above, "core" developers have responsibility for:
577
589
 
578
590
* reviewing changes
579
 
* reviewing blueprints
580
591
* planning releases
581
592
* managing releases (see `Releasing Bazaar <http://doc.bazaar.canonical.com/developers/releasing.html>`_)
582
593