[Monotone-commits-diffs] net.venge.monotone.string-sanitization: fd5b630851cddb0a0a45c8212e19e87ff752c11c

[code]

revision:            fd5b630851cddb0a0a45c8212e19e87ff752c11c
date:                2011-03-08T10:39:43
author:              Richard Levitte <address@hidden>
branch:              net.venge.monotone.string-sanitization
changelog:
* HACKING: Commands in the middle of sentences should also be quoted.
  However, items that would otherwise be quoted but stand alone do not
  need any quoting.

manifest:
format_version "1"

new_manifest [1c75101ff1bfd93eee62a6ae275a5e00ed76f8dc]

old_revision [5d435341ec792afc1a63744ca046900bc45858ad]

patch "HACKING"
 from [631a94fd2d5d0ea9bee35647bd17c72d287837d0]
   to [cf403ac1b4e542270a8f08bdeb0ae0dd61d9d0aa]
============================================================
--- HACKING	631a94fd2d5d0ea9bee35647bd17c72d287837d0
+++ HACKING	cf403ac1b4e542270a8f08bdeb0ae0dd61d9d0aa
@@ -60,9 +60,20 @@ for messages in english:
 for messages in english:
 
   - put single quotes ('') aroung file names and paths, option names,
-    tag names and branch names, as well as any %s that would be
-    expanded to one of those.
+    tag names, branch names, command names and commands, as well as
+    any %s that would be expanded to one of those.
+    There is an exception, though: if the quoted item is cited after a
+    colon, either as the last part of the message or on its own line.
+    For example, the following doesn't look very good:
 
+        To apply the changes relative to one of its parents, use:
+          'mtn pluck -r PARENT -r 06c3...'
+
+    The following looks better
+
+        To apply the changes relative to one of its parents, use:
+          mtn pluck -r PARENT -r 06c3...
+
   - use a Capital first letter in command abstract and description
     strings.  Do not put a period at the end of the abstract, but do
     so with the description.  The following would be very wrong: