improve "usage" strings to include optional "--"

[stgit] / stgit / commands / publish.py

diff --git a/stgit/commands/publish.py b/stgit/commands/publish.py
index d829916..93e4d28 100644 (file)
--- a/stgit/commands/publish.py
+++ b/stgit/commands/publish.py
@@ -23,9 +23,9 @@ from stgit.lib import git, stack
 from stgit.out import out
 from stgit import utils
 
-help = 'Publish the stack changes to a merge-friendly head'
+help = 'Push the stack changes to a merge-friendly branch'
 kind = 'stack'
-usage = ['[options] [branch]']
+usage = ['[options] [--] [branch]']
 description = """
 This command commits a set of changes on a separate (called public) branch
 based on the modifications of the given or current stack. The history of the
@@ -109,6 +109,11 @@ def func(parser, options, args):
     # check for rebased stack. In this case we emulate a merge with the stack
     # base by setting two parents.
     merge_bases = repository.get_merge_bases(public_head, stack.base)
+    if public_head in merge_bases:
+        # fast-forward the public ref
+        repository.refs.set(public_ref, stack.head, 'publish')
+        out.info('Fast-forwarded "%s"' % public_ref)
+        return
     if not stack.base in merge_bases:
         message = 'Merge %s into %s' % (repository.describe(stack.base).strip(),
                                         utils.strip_prefix('refs/heads/',