← 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-27 14:30:10 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-20060727143010-9db27d72d6a5caa7
cleanup from suggestions by Robert and Martin

Show diffs side-by-side

added added

removed removed

Lines of Context:
HACKING
5
5
.. contents::
6
6
 
7
7
(The current version of this document is available in the file ``HACKING``
8
 
in the source tree, or at http://bazaar-vcs.org/hacking.html)
 
8
in the source tree, or at http://doc.bazaar-vcs.org/current/hacking.html)
9
9
 
10
10
Overall
11
11
=======
391
391
``sys.stdout``, and should be used to write information to the screen,
392
392
rather than directly writing to ``sys.stdout`` or calling ``print``.
393
393
This file has the ability to translate Unicode objects into the correct
394
 
representation, based on the console encoding.  Also, the parameter
395
 
``self.encoding_type`` will effect how unprintable characters will be
 
394
representation, based on the console encoding.  Also, the class attribute
 
395
``encoding_type`` will effect how unprintable characters will be
396
396
handled.  This parameter can take one of 3 values:
397
397
 
398
398
  replace
399
 
    Unprintable characters will be represented with a simple '?', and no
400
 
    exception will be raised. This is for any command which generates text
401
 
    for the user to review, rather than for automated processing.
 
399
    Unprintable characters will be represented with a suitable replacement
 
400
    marker (typically '?'), and no exception will be raised. This is for
 
401
    any command which generates text for the user to review, rather than
 
402
    for automated processing.
402
403
    For example: ``bzr log`` should not fail if one of the entries has text
403
404
    that cannot be displayed.
404
405