← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/HACKING

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2007-07-11 04:19:50 UTC
  • mfrom: (2598.1.5 check-options)
  • Revision ID: pqm@pqm.ubuntu.com-20070711041950-ci5yz9nyhbcdmuqv
(mbp,r=jamesw,r=aaron) Make option grammar consistent and enforce that with a test

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/HACKING
693
693
should be only in the command-line tool.
694
694
 
695
695
 
 
696
 
 
697
Displaying help
 
698
===============
 
699
 
 
700
Bazaar has online help for various topics through ``bzr help COMMAND`` or
 
701
equivalently ``bzr command -h``.  We also have help on command options,
 
702
and on other help topics.  (See ``help_topics.py``.)
 
703
 
 
704
As for python docstrings, the first paragraph should be a single-sentence
 
705
synopsis of the command.
 
706
 
 
707
The help for options should be one or more proper sentences, starting with
 
708
a capital letter and finishing with a full stop (period).
 
709
 
 
710
All help messages and documentation should have two spaces between
 
711
sentences.
 
712
 
 
713
 
696
714
Writing tests
697
715
=============
698
716