Merge branch 'jj/doc-markup-hints-in-coding-guidelines' into maint
authorJunio C Hamano <gitster@pobox.com>
Tue, 17 Dec 2013 19:36:10 +0000 (11:36 -0800)
committerJunio C Hamano <gitster@pobox.com>
Tue, 17 Dec 2013 19:36:10 +0000 (11:36 -0800)
* jj/doc-markup-hints-in-coding-guidelines:
State correct usage of literal examples in man pages in the coding standards

1  2 
Documentation/CodingGuidelines
index a600e35c810b74848062dee8d74e573192c09e2c,4b9d59e7ae5ec4261f045956ab4c5eebb14351eb..ef67b53f721f28e5442c00273dec5f1582f555be
@@@ -250,19 -242,13 +250,21 @@@ Writing Documentation
   processed into HTML and manpages (e.g. git.html and git.1 in the
   same directory).
  
 + The documentation liberally mixes US and UK English (en_US/UK)
 + norms for spelling and grammar, which is somewhat unfortunate.
 + In an ideal world, it would have been better if it consistently
 + used only one and not the other, and we would have picked en_US
 + (if you wish to correct the English of some of the existing
 + documentation, please see the documentation-related advice in the
 + Documentation/SubmittingPatches file).
 +
   Every user-visible change should be reflected in the documentation.
   The same general rule as for code applies -- imitate the existing
-  conventions.  A few commented examples follow to provide reference
-  when writing or modifying command usage strings and synopsis sections
-  in the manual pages:
+  conventions.
+  A few commented examples follow to provide reference when writing or
+  modifying command usage strings and synopsis sections in the manual
+  pages:
  
   Placeholders are spelled in lowercase and enclosed in angle brackets:
     <file>