X-Git-Url: https://git.distorted.org.uk/~mdw/stgit/blobdiff_plain/b24fee3e827d1c4fad0f0f45203062e1e00c7181..b13d080c1b6f59d78c276932f72da1971cc6fd2d:/Documentation/stg-new.txt

diff --git a/Documentation/stg-new.txt b/Documentation/stg-new.txt
index 5775559..fbf2f67 100644
--- a/Documentation/stg-new.txt
+++ b/Documentation/stg-new.txt
@@ -9,7 +9,8 @@ stg-new - stgdesc:new[]
 
 SYNOPSIS
 --------
-stg new [OPTIONS] <name>
+[verse]
+'stg' new [OPTIONS] [name]
 
 DESCRIPTION
 -----------
@@ -20,6 +21,10 @@ is made the new top of the stack.  The local changes in the working
 tree are not included in the patch. A stglink:refresh[] command is
 needed for this.
 
+The given <name> must be unique in the stack, and may only contain
+alphanumeric characters, dashes and underscores. If no name is given,
+one is generated from the first line of the commit message.
+
 An editor will be launched to edit the commit message to be used for
 the patch, unless the '--message' flag already specified one.  The
 'patchdescr.tmpl' template file is used if available to pre-fill the
@@ -57,11 +62,6 @@ described in gitlink:git-commit-tree[1].
 OPTIONS
 -------
 
-<name>::
-	The short name that will be used as to identify the patch in
-	other StGIT commands.  Must be unique in the stack.  May only
-	contain alphanumeric characters, dashes and underscores.
-
 --message=<message>::
 -m <message>::
 	Use <message> as the patch description.