[PATCH] bzrlib/builtins.py - status command help improvement

Jari Aalto jari.aalto at cante.net
Mon Sep 12 13:52:58 BST 2005


Jan Hudec <bulb at ucw.cz> writes:

| To me it sounds pretty weird.  Added *and commited* files are no longer
| "added"---they are "versioned".  That's how *all* version control system I
| know use the term "added".  I'd suggest:
| 
| NOTE: Files, that don't differ from the commited state are not listed
| unless '--all' option is given (see also 'bzr inventory').
| 
| Because that's really what is going on here.
| 
| By the way, looking at the --all option I more and more think that the
| inventory command should be merged into status (as the _only_ remaining
| thing status does not show is ignored files).

sounds good.
 
| It is customary to put two spaces after a period in english text,
| because in english typesetting the space after perod is longer than
| normal. Please remain consistent with the rest of the help.

It's an old relict. Used at the age of typewrites. I have no
recollection it being used outside of USA. 

It does not apply to computer displayed text which is monospace, like
help screens on terminal. See.

   Style Guide Punctuation

   ...spacing: Use a single space between sentences. Using two spaces
   is an old typewriter convention that is not appropriate for
   computers. If in doubt about this convention, look at nearly any
   book, journal, newspaper or magazine.
   <http://www.lanecc.edu/mpr/stylepun.htm>
   
   FULL STOP: Spacing after full stop

   In typewritten texts and other documents printed in uniform-width
   fonts, there is a convention among laymen that two spaces are
   placed after the full stop ... the awkwardness that most keyboards
   and word-processing software have in representing correctly the 1.5
   spaces that had previously become standard for typographically
   proportional (non-monospace) fonts has led to some confusion about
   how to render the space between sentences using only
   word-processing tools. Many descriptivists support the notion that
   a single space after a full stop should be considered standard
   because it has been the norm in mainstream publishing for many
   decades ...
   <http://en.wikipedia.org/wiki/Period_(punctuation)>







More information about the bazaar mailing list