{"thread":{"id":"27744","subject":"[PATCH 1/2] Documentation: use [verse] for SYNOPSIS sections","startedAt":"2011-07-02T02:38:26Z","lastAt":"2011-07-06T21:31:20Z","messageCount":2,"participants":["Martin von Zweigbergk","Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":2},"messages":[{"id":"170762","messageId":"1309574306-6787-1-git-send-email-martin.von.zweigbergk@gmail.com","threadId":"27744","inReplyTo":null,"subject":"[PATCH 1/2] Documentation: use [verse] for SYNOPSIS sections","fromName":"Martin von Zweigbergk","fromEmail":"martin.von.zweigbergk@gmail.com","sentAt":"2011-07-02T02:38:26Z","receivedAt":"2011-07-02T02:38:26Z","isPatch":true,"sender":{"key":"martinvonz@gmail.com","avatar":"https://avatars.githubusercontent.com/u/891642?v=4"},"body":"The SYNOPSIS sections of most commands that span several lines already\nuse [verse] to retain line breaks. Most commands that don't span\nseveral lines seem not to use [verse]. In the HTML output, [verse]\ndoes not only preserve line breaks, but also makes the section\nindented, which causes a slight inconsistency between commands that\nuse [verse] and those that don't. Use [verse] in all SYNOPSIS sections\nfor consistency.\n\nAlso remove the blank lines from git-fetch.txt and git-rebase.txt to\nalign with the other man pages. In the case of git-rebase.txt, which\nalready uses [verse], the blank line makes the [verse] not apply to\nthe last line, so removing the blank line also makes the formatting\nwithin the document more consistent.\n\nWhile at it, add single quotes to 'git cvsimport' for consistency with\nother commands.\n\nSigned-off-by: Martin von Zweigbergk <martin.von.zweigbergk@gmail.com>\n---\n\nNot the most fun patch I have ever written, but at least it improves\nconsistency a bit. I was not sure what to do with e.g. gitrevisions,\ngitrepository-layout, gittutorial. Just leave them as is?\n\n\n Documentation/git-annotate.txt                  |    1 +\n Documentation/git-bisect.txt                    |    1 +\n Documentation/git-cherry-pick.txt               |    1 +\n Documentation/git-cherry.txt                    |    1 +\n Documentation/git-citool.txt                    |    1 +\n Documentation/git-commit-tree.txt               |    1 +\n Documentation/git-count-objects.txt             |    1 +\n Documentation/git-cvsexportcommit.txt           |    1 +\n Documentation/git-diff-files.txt                |    1 +\n Documentation/git-diff-index.txt                |    1 +\n Documentation/git-difftool.txt                  |    1 +\n Documentation/git-fast-export.txt               |    1 +\n Documentation/git-fast-import.txt               |    1 +\n Documentation/git-fetch-pack.txt                |    1 +\n Documentation/git-fetch.txt                     |    4 +---\n Documentation/git-fsck-objects.txt              |    1 +\n Documentation/git-gc.txt                        |    1 +\n Documentation/git-get-tar-commit-id.txt         |    1 +\n Documentation/git-gui.txt                       |    1 +\n Documentation/git-help.txt                      |    1 +\n Documentation/git-http-fetch.txt                |    1 +\n Documentation/git-http-push.txt                 |    1 +\n Documentation/git-imap-send.txt                 |    1 +\n Documentation/git-init-db.txt                   |    1 +\n Documentation/git-init.txt                      |    1 +\n Documentation/git-log.txt                       |    1 +\n Documentation/git-lost-found.txt                |    1 +\n Documentation/git-mailinfo.txt                  |    1 +\n Documentation/git-mailsplit.txt                 |    1 +\n Documentation/git-merge-index.txt               |    1 +\n Documentation/git-merge-one-file.txt            |    1 +\n Documentation/git-merge-tree.txt                |    1 +\n Documentation/git-mergetool--lib.txt            |    1 +\n Documentation/git-mergetool.txt                 |    1 +\n Documentation/git-mktag.txt                     |    1 +\n Documentation/git-mktree.txt                    |    1 +\n Documentation/git-mv.txt                        |    1 +\n Documentation/git-pack-redundant.txt            |    1 +\n Documentation/git-pack-refs.txt                 |    1 +\n Documentation/git-parse-remote.txt              |    1 +\n Documentation/git-patch-id.txt                  |    1 +\n Documentation/git-peek-remote.txt               |    1 +\n Documentation/git-prune-packed.txt              |    1 +\n Documentation/git-prune.txt                     |    1 +\n Documentation/git-pull.txt                      |    1 +\n Documentation/git-read-tree.txt                 |    1 +\n Documentation/git-rebase.txt                    |    1 -\n Documentation/git-receive-pack.txt              |    1 +\n Documentation/git-reflog.txt                    |    1 +\n Documentation/git-relink.txt                    |    1 +\n Documentation/git-remote-ext.txt                |    1 +\n Documentation/git-remote-helpers.txt            |    1 +\n Documentation/git-repack.txt                    |    1 +\n Documentation/git-repo-config.txt               |    1 +\n Documentation/git-request-pull.txt              |    1 +\n Documentation/git-rerere.txt                    |    1 +\n Documentation/git-rev-parse.txt                 |    1 +\n Documentation/git-revert.txt                    |    1 +\n Documentation/git-rm.txt                        |    1 +\n Documentation/git-send-email.txt                |    1 +\n Documentation/git-send-pack.txt                 |    1 +\n Documentation/git-sh-i18n.txt                   |    1 +\n Documentation/git-sh-setup.txt                  |    1 +\n Documentation/git-shell.txt                     |    1 +\n Documentation/git-show-branch.txt               |    1 -\n Documentation/git-show-index.txt                |    1 +\n Documentation/git-show.txt                      |    1 +\n Documentation/git-status.txt                    |    1 +\n Documentation/git-stripspace.txt                |    1 +\n Documentation/git-svn.txt                       |    1 +\n Documentation/git-symbolic-ref.txt              |    1 +\n Documentation/git-tar-tree.txt                  |    1 +\n Documentation/git-unpack-file.txt               |    1 +\n Documentation/git-unpack-objects.txt            |    1 +\n Documentation/git-update-ref.txt                |    1 +\n Documentation/git-update-server-info.txt        |    1 +\n Documentation/git-upload-archive.txt            |    1 +\n Documentation/git-upload-pack.txt               |    1 +\n Documentation/git-var.txt                       |    1 +\n Documentation/git-verify-pack.txt               |    1 +\n Documentation/git-verify-tag.txt                |    1 +\n Documentation/git-web--browse.txt               |    1 +\n Documentation/git-whatchanged.txt               |    1 +\n Documentation/git-write-tree.txt                |    1 +\n Documentation/gitcvs-migration.txt              |    3 ++-\n Documentation/gitdiffcore.txt                   |    1 +\n Documentation/gitk.txt                          |    1 +\n Documentation/gittutorial-2.txt                 |    1 +\n Documentation/gittutorial.txt                   |    1 +\n Documentation/gitworkflows.txt                  |    1 +\n contrib/convert-objects/git-convert-objects.txt |    1 +\n contrib/gitview/gitview.txt                     |    1 +\n contrib/svn-fe/svn-fe.txt                       |    1 +\n 93 files changed, 92 insertions(+), 6 deletions(-)\n\ndiff --git a/Documentation/git-annotate.txt b/Documentation/git-annotate.txt\nindex 9eb75c3..05fd482 100644\n--- a/Documentation/git-annotate.txt\n+++ b/Documentation/git-annotate.txt\n@@ -7,6 +7,7 @@ git-annotate - Annotate file lines with commit information\n \n SYNOPSIS\n --------\n+[verse]\n 'git annotate' [options] file [revision]\n \n DESCRIPTION\ndiff --git a/Documentation/git-bisect.txt b/Documentation/git-bisect.txt\nindex 7b7bafb..ab60a18 100644\n--- a/Documentation/git-bisect.txt\n+++ b/Documentation/git-bisect.txt\n@@ -8,6 +8,7 @@ git-bisect - Find by binary search the change that introduced a bug\n \n SYNOPSIS\n --------\n+[verse]\n 'git bisect' <subcommand> <options>\n \n DESCRIPTION\ndiff --git a/Documentation/git-cherry-pick.txt b/Documentation/git-cherry-pick.txt\nindex 9d8fe0d..6c9c2cb 100644\n--- a/Documentation/git-cherry-pick.txt\n+++ b/Documentation/git-cherry-pick.txt\n@@ -7,6 +7,7 @@ git-cherry-pick - Apply the changes introduced by some existing commits\n \n SYNOPSIS\n --------\n+[verse]\n 'git cherry-pick' [--edit] [-n] [-m parent-number] [-s] [-x] [--ff] <commit>...\n \n DESCRIPTION\ndiff --git a/Documentation/git-cherry.txt b/Documentation/git-cherry.txt\nindex 79448c5..f6c19c7 100644\n--- a/Documentation/git-cherry.txt\n+++ b/Documentation/git-cherry.txt\n@@ -7,6 +7,7 @@ git-cherry - Find commits not merged upstream\n \n SYNOPSIS\n --------\n+[verse]\n 'git cherry' [-v] [<upstream> [<head> [<limit>]]]\n \n DESCRIPTION\ndiff --git a/Documentation/git-citool.txt b/Documentation/git-citool.txt\nindex 6e5c812..c7a11c3 100644\n--- a/Documentation/git-citool.txt\n+++ b/Documentation/git-citool.txt\n@@ -7,6 +7,7 @@ git-citool - Graphical alternative to git-commit\n \n SYNOPSIS\n --------\n+[verse]\n 'git citool'\n \n DESCRIPTION\ndiff --git a/Documentation/git-commit-tree.txt b/Documentation/git-commit-tree.txt\nindex f524d76..0fdb82e 100644\n--- a/Documentation/git-commit-tree.txt\n+++ b/Documentation/git-commit-tree.txt\n@@ -8,6 +8,7 @@ git-commit-tree - Create a new commit object\n \n SYNOPSIS\n --------\n+[verse]\n 'git commit-tree' <tree> [(-p <parent commit>)...] < changelog\n \n DESCRIPTION\ndiff --git a/Documentation/git-count-objects.txt b/Documentation/git-count-objects.txt\nindex a73933a..23c80ce 100644\n--- a/Documentation/git-count-objects.txt\n+++ b/Documentation/git-count-objects.txt\n@@ -7,6 +7,7 @@ git-count-objects - Count unpacked number of objects and their disk consumption\n \n SYNOPSIS\n --------\n+[verse]\n 'git count-objects' [-v]\n \n DESCRIPTION\ndiff --git a/Documentation/git-cvsexportcommit.txt b/Documentation/git-cvsexportcommit.txt\nindex ad93a3e..7f79cec 100644\n--- a/Documentation/git-cvsexportcommit.txt\n+++ b/Documentation/git-cvsexportcommit.txt\n@@ -8,6 +8,7 @@ git-cvsexportcommit - Export a single commit to a CVS checkout\n \n SYNOPSIS\n --------\n+[verse]\n 'git cvsexportcommit' [-h] [-u] [-v] [-c] [-P] [-p] [-a] [-d cvsroot]\n \t[-w cvsworkdir] [-W] [-f] [-m msgprefix] [PARENTCOMMIT] COMMITID\n \ndiff --git a/Documentation/git-diff-files.txt b/Documentation/git-diff-files.txt\nindex 8d48194..906774f 100644\n--- a/Documentation/git-diff-files.txt\n+++ b/Documentation/git-diff-files.txt\n@@ -8,6 +8,7 @@ git-diff-files - Compares files in the working tree and the index\n \n SYNOPSIS\n --------\n+[verse]\n 'git diff-files' [-q] [-0|-1|-2|-3|-c|--cc] [<common diff options>] [<path>...]\n \n DESCRIPTION\ndiff --git a/Documentation/git-diff-index.txt b/Documentation/git-diff-index.txt\nindex 2ea22ab..c0b7c58 100644\n--- a/Documentation/git-diff-index.txt\n+++ b/Documentation/git-diff-index.txt\n@@ -8,6 +8,7 @@ git-diff-index - Compares content and mode of blobs between the index and reposi\n \n SYNOPSIS\n --------\n+[verse]\n 'git diff-index' [-m] [--cached] [<common diff options>] <tree-ish> [<path>...]\n \n DESCRIPTION\ndiff --git a/Documentation/git-difftool.txt b/Documentation/git-difftool.txt\nindex 590f410..a03515f 100644\n--- a/Documentation/git-difftool.txt\n+++ b/Documentation/git-difftool.txt\n@@ -7,6 +7,7 @@ git-difftool - Show changes using common diff tools\n \n SYNOPSIS\n --------\n+[verse]\n 'git difftool' [<options>] [<commit> [<commit>]] [--] [<path>...]\n \n DESCRIPTION\ndiff --git a/Documentation/git-fast-export.txt b/Documentation/git-fast-export.txt\nindex 781bd6e..a29ac02 100644\n--- a/Documentation/git-fast-export.txt\n+++ b/Documentation/git-fast-export.txt\n@@ -8,6 +8,7 @@ git-fast-export - Git data exporter\n \n SYNOPSIS\n --------\n+[verse]\n 'git fast-export [options]' | 'git fast-import'\n \n DESCRIPTION\ndiff --git a/Documentation/git-fast-import.txt b/Documentation/git-fast-import.txt\nindex 249249a..8b9f9bb 100644\n--- a/Documentation/git-fast-import.txt\n+++ b/Documentation/git-fast-import.txt\n@@ -8,6 +8,7 @@ git-fast-import - Backend for fast Git data importers\n \n SYNOPSIS\n --------\n+[verse]\n frontend | 'git fast-import' [options]\n \n DESCRIPTION\ndiff --git a/Documentation/git-fetch-pack.txt b/Documentation/git-fetch-pack.txt\nindex 48d4bf6..ed1bdaa 100644\n--- a/Documentation/git-fetch-pack.txt\n+++ b/Documentation/git-fetch-pack.txt\n@@ -8,6 +8,7 @@ git-fetch-pack - Receive missing objects from another repository\n \n SYNOPSIS\n --------\n+[verse]\n 'git fetch-pack' [--all] [--quiet|-q] [--keep|-k] [--thin] [--include-tag] [--upload-pack=<git-upload-pack>] [--depth=<n>] [--no-progress] [-v] [<host>:]<directory> [<refs>...]\n \n DESCRIPTION\ndiff --git a/Documentation/git-fetch.txt b/Documentation/git-fetch.txt\nindex 60ac8d2..b41d7c1 100644\n--- a/Documentation/git-fetch.txt\n+++ b/Documentation/git-fetch.txt\n@@ -8,12 +8,10 @@ git-fetch - Download objects and refs from another repository\n \n SYNOPSIS\n --------\n+[verse]\n 'git fetch' [<options>] [<repository> [<refspec>...]]\n-\n 'git fetch' [<options>] <group>\n-\n 'git fetch' --multiple [<options>] [(<repository> | <group>)...]\n-\n 'git fetch' --all [<options>]\n \n \ndiff --git a/Documentation/git-fsck-objects.txt b/Documentation/git-fsck-objects.txt\nindex 90ebb8a..eec4bdb 100644\n--- a/Documentation/git-fsck-objects.txt\n+++ b/Documentation/git-fsck-objects.txt\n@@ -8,6 +8,7 @@ git-fsck-objects - Verifies the connectivity and validity of the objects in the\n \n SYNOPSIS\n --------\n+[verse]\n 'git fsck-objects' ...\n \n DESCRIPTION\ndiff --git a/Documentation/git-gc.txt b/Documentation/git-gc.txt\nindex 4966cb5..815afcb 100644\n--- a/Documentation/git-gc.txt\n+++ b/Documentation/git-gc.txt\n@@ -8,6 +8,7 @@ git-gc - Cleanup unnecessary files and optimize the local repository\n \n SYNOPSIS\n --------\n+[verse]\n 'git gc' [--aggressive] [--auto] [--quiet] [--prune=<date> | --no-prune]\n \n DESCRIPTION\ndiff --git a/Documentation/git-get-tar-commit-id.txt b/Documentation/git-get-tar-commit-id.txt\nindex 8035736..1e2a20d 100644\n--- a/Documentation/git-get-tar-commit-id.txt\n+++ b/Documentation/git-get-tar-commit-id.txt\n@@ -8,6 +8,7 @@ git-get-tar-commit-id - Extract commit ID from an archive created using git-arch\n \n SYNOPSIS\n --------\n+[verse]\n 'git get-tar-commit-id' < <tarfile>\n \n \ndiff --git a/Documentation/git-gui.txt b/Documentation/git-gui.txt\nindex 32a833e..18f713b 100644\n--- a/Documentation/git-gui.txt\n+++ b/Documentation/git-gui.txt\n@@ -7,6 +7,7 @@ git-gui - A portable graphical interface to Git\n \n SYNOPSIS\n --------\n+[verse]\n 'git gui' [<command>] [arguments]\n \n DESCRIPTION\ndiff --git a/Documentation/git-help.txt b/Documentation/git-help.txt\nindex 42aa2b0..9e0b3f6 100644\n--- a/Documentation/git-help.txt\n+++ b/Documentation/git-help.txt\n@@ -7,6 +7,7 @@ git-help - display help information about git\n \n SYNOPSIS\n --------\n+[verse]\n 'git help' [-a|--all|-i|--info|-m|--man|-w|--web] [COMMAND]\n \n DESCRIPTION\ndiff --git a/Documentation/git-http-fetch.txt b/Documentation/git-http-fetch.txt\nindex fefa752..4d42073 100644\n--- a/Documentation/git-http-fetch.txt\n+++ b/Documentation/git-http-fetch.txt\n@@ -8,6 +8,7 @@ git-http-fetch - Download from a remote git repository via HTTP\n \n SYNOPSIS\n --------\n+[verse]\n 'git http-fetch' [-c] [-t] [-a] [-d] [-v] [-w filename] [--recover] [--stdin] <commit> <url>\n \n DESCRIPTION\ndiff --git a/Documentation/git-http-push.txt b/Documentation/git-http-push.txt\nindex 82ae34b..2e67362 100644\n--- a/Documentation/git-http-push.txt\n+++ b/Documentation/git-http-push.txt\n@@ -8,6 +8,7 @@ git-http-push - Push objects over HTTP/DAV to another repository\n \n SYNOPSIS\n --------\n+[verse]\n 'git http-push' [--all] [--dry-run] [--force] [--verbose] <url> <ref> [<ref>...]\n \n DESCRIPTION\ndiff --git a/Documentation/git-imap-send.txt b/Documentation/git-imap-send.txt\nindex 4e09708..875d283 100644\n--- a/Documentation/git-imap-send.txt\n+++ b/Documentation/git-imap-send.txt\n@@ -8,6 +8,7 @@ git-imap-send - Send a collection of patches from stdin to an IMAP folder\n \n SYNOPSIS\n --------\n+[verse]\n 'git imap-send'\n \n \ndiff --git a/Documentation/git-init-db.txt b/Documentation/git-init-db.txt\nindex 9f97f5a..a21e346 100644\n--- a/Documentation/git-init-db.txt\n+++ b/Documentation/git-init-db.txt\n@@ -8,6 +8,7 @@ git-init-db - Creates an empty git repository\n \n SYNOPSIS\n --------\n+[verse]\n 'git init-db' [-q | --quiet] [--bare] [--template=<template_directory>] [--separate-git-dir <git dir>] [--shared[=<permissions>]]\n \n \ndiff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\nindex f2777a7..9ac2bba 100644\n--- a/Documentation/git-init.txt\n+++ b/Documentation/git-init.txt\n@@ -8,6 +8,7 @@ git-init - Create an empty git repository or reinitialize an existing one\n \n SYNOPSIS\n --------\n+[verse]\n 'git init' [-q | --quiet] [--bare] [--template=<template_directory>]\n \t  [--separate-git-dir <git dir>]\n \t  [--shared[=<permissions>]] [directory]\ndiff --git a/Documentation/git-log.txt b/Documentation/git-log.txt\nindex de5c0d3..59f8be0 100644\n--- a/Documentation/git-log.txt\n+++ b/Documentation/git-log.txt\n@@ -8,6 +8,7 @@ git-log - Show commit logs\n \n SYNOPSIS\n --------\n+[verse]\n 'git log' [<options>] [<since>..<until>] [[\\--] <path>...]\n \n DESCRIPTION\ndiff --git a/Documentation/git-lost-found.txt b/Documentation/git-lost-found.txt\nindex adf7e1c..c406a11 100644\n--- a/Documentation/git-lost-found.txt\n+++ b/Documentation/git-lost-found.txt\n@@ -7,6 +7,7 @@ git-lost-found - Recover lost refs that luckily have not yet been pruned\n \n SYNOPSIS\n --------\n+[verse]\n 'git lost-found'\n \n DESCRIPTION\ndiff --git a/Documentation/git-mailinfo.txt b/Documentation/git-mailinfo.txt\nindex ed45662..51dc325 100644\n--- a/Documentation/git-mailinfo.txt\n+++ b/Documentation/git-mailinfo.txt\n@@ -8,6 +8,7 @@ git-mailinfo - Extracts patch and authorship from a single e-mail message\n \n SYNOPSIS\n --------\n+[verse]\n 'git mailinfo' [-k|-b] [-u | --encoding=<encoding> | -n] [--scissors] <msg> <patch>\n \n \ndiff --git a/Documentation/git-mailsplit.txt b/Documentation/git-mailsplit.txt\nindex 9b2049d..4d1b871 100644\n--- a/Documentation/git-mailsplit.txt\n+++ b/Documentation/git-mailsplit.txt\n@@ -7,6 +7,7 @@ git-mailsplit - Simple UNIX mbox splitter program\n \n SYNOPSIS\n --------\n+[verse]\n 'git mailsplit' [-b] [-f<nn>] [-d<prec>] [--keep-cr] -o<directory> [--] [(<mbox>|<Maildir>)...]\n \n DESCRIPTION\ndiff --git a/Documentation/git-merge-index.txt b/Documentation/git-merge-index.txt\nindex 6ce5467..e0df1b3 100644\n--- a/Documentation/git-merge-index.txt\n+++ b/Documentation/git-merge-index.txt\n@@ -8,6 +8,7 @@ git-merge-index - Run a merge for files needing merging\n \n SYNOPSIS\n --------\n+[verse]\n 'git merge-index' [-o] [-q] <merge-program> (-a | [--] <file>*)\n \n DESCRIPTION\ndiff --git a/Documentation/git-merge-one-file.txt b/Documentation/git-merge-one-file.txt\nindex ee059de..04e803d 100644\n--- a/Documentation/git-merge-one-file.txt\n+++ b/Documentation/git-merge-one-file.txt\n@@ -8,6 +8,7 @@ git-merge-one-file - The standard helper program to use with git-merge-index\n \n SYNOPSIS\n --------\n+[verse]\n 'git merge-one-file'\n \n DESCRIPTION\ndiff --git a/Documentation/git-merge-tree.txt b/Documentation/git-merge-tree.txt\nindex 3bfa7b4..c5f84b6 100644\n--- a/Documentation/git-merge-tree.txt\n+++ b/Documentation/git-merge-tree.txt\n@@ -8,6 +8,7 @@ git-merge-tree - Show three-way merge without touching index\n \n SYNOPSIS\n --------\n+[verse]\n 'git merge-tree' <base-tree> <branch1> <branch2>\n \n DESCRIPTION\ndiff --git a/Documentation/git-mergetool--lib.txt b/Documentation/git-mergetool--lib.txt\nindex 63edede..8c5be67 100644\n--- a/Documentation/git-mergetool--lib.txt\n+++ b/Documentation/git-mergetool--lib.txt\n@@ -7,6 +7,7 @@ git-mergetool--lib - Common git merge tool shell scriptlets\n \n SYNOPSIS\n --------\n+[verse]\n 'TOOL_MODE=(diff|merge) . \"$(git --exec-path)/git-mergetool--lib\"'\n \n DESCRIPTION\ndiff --git a/Documentation/git-mergetool.txt b/Documentation/git-mergetool.txt\nindex 8c79ae8..3470910 100644\n--- a/Documentation/git-mergetool.txt\n+++ b/Documentation/git-mergetool.txt\n@@ -7,6 +7,7 @@ git-mergetool - Run merge conflict resolution tools to resolve merge conflicts\n \n SYNOPSIS\n --------\n+[verse]\n 'git mergetool' [--tool=<tool>] [-y|--no-prompt|--prompt] [<file>...]\n \n DESCRIPTION\ndiff --git a/Documentation/git-mktag.txt b/Documentation/git-mktag.txt\nindex 037ab10..65e167a 100644\n--- a/Documentation/git-mktag.txt\n+++ b/Documentation/git-mktag.txt\n@@ -8,6 +8,7 @@ git-mktag - Creates a tag object\n \n SYNOPSIS\n --------\n+[verse]\n 'git mktag' < signature_file\n \n DESCRIPTION\ndiff --git a/Documentation/git-mktree.txt b/Documentation/git-mktree.txt\nindex afe21be..5c6ebdf 100644\n--- a/Documentation/git-mktree.txt\n+++ b/Documentation/git-mktree.txt\n@@ -8,6 +8,7 @@ git-mktree - Build a tree-object from ls-tree formatted text\n \n SYNOPSIS\n --------\n+[verse]\n 'git mktree' [-z] [--missing] [--batch]\n \n DESCRIPTION\ndiff --git a/Documentation/git-mv.txt b/Documentation/git-mv.txt\nindex db0e030..b8db373 100644\n--- a/Documentation/git-mv.txt\n+++ b/Documentation/git-mv.txt\n@@ -8,6 +8,7 @@ git-mv - Move or rename a file, a directory, or a symlink\n \n SYNOPSIS\n --------\n+[verse]\n 'git mv' <options>... <args>...\n \n DESCRIPTION\ndiff --git a/Documentation/git-pack-redundant.txt b/Documentation/git-pack-redundant.txt\nindex db9f0f7..f2869da 100644\n--- a/Documentation/git-pack-redundant.txt\n+++ b/Documentation/git-pack-redundant.txt\n@@ -8,6 +8,7 @@ git-pack-redundant - Find redundant pack files\n \n SYNOPSIS\n --------\n+[verse]\n 'git pack-redundant' [ --verbose ] [ --alt-odb ] < --all | .pack filename ... >\n \n DESCRIPTION\ndiff --git a/Documentation/git-pack-refs.txt b/Documentation/git-pack-refs.txt\nindex 54b9253..a3c6677 100644\n--- a/Documentation/git-pack-refs.txt\n+++ b/Documentation/git-pack-refs.txt\n@@ -7,6 +7,7 @@ git-pack-refs - Pack heads and tags for efficient repository access\n \n SYNOPSIS\n --------\n+[verse]\n 'git pack-refs' [--all] [--no-prune]\n \n DESCRIPTION\ndiff --git a/Documentation/git-parse-remote.txt b/Documentation/git-parse-remote.txt\nindex 02217f6..a45ea1e 100644\n--- a/Documentation/git-parse-remote.txt\n+++ b/Documentation/git-parse-remote.txt\n@@ -8,6 +8,7 @@ git-parse-remote - Routines to help parsing remote repository access parameters\n \n SYNOPSIS\n --------\n+[verse]\n '. \"$(git --exec-path)/git-parse-remote\"'\n \n DESCRIPTION\ndiff --git a/Documentation/git-patch-id.txt b/Documentation/git-patch-id.txt\nindex 50e26f4..90268f0 100644\n--- a/Documentation/git-patch-id.txt\n+++ b/Documentation/git-patch-id.txt\n@@ -7,6 +7,7 @@ git-patch-id - Compute unique ID for a patch\n \n SYNOPSIS\n --------\n+[verse]\n 'git patch-id' < <patch>\n \n DESCRIPTION\ndiff --git a/Documentation/git-peek-remote.txt b/Documentation/git-peek-remote.txt\nindex a34d62f..87ea3fb 100644\n--- a/Documentation/git-peek-remote.txt\n+++ b/Documentation/git-peek-remote.txt\n@@ -8,6 +8,7 @@ git-peek-remote - List the references in a remote repository\n \n SYNOPSIS\n --------\n+[verse]\n 'git peek-remote' [--upload-pack=<git-upload-pack>] [<host>:]<directory>\n \n DESCRIPTION\ndiff --git a/Documentation/git-prune-packed.txt b/Documentation/git-prune-packed.txt\nindex 9e6202c..80dc022 100644\n--- a/Documentation/git-prune-packed.txt\n+++ b/Documentation/git-prune-packed.txt\n@@ -8,6 +8,7 @@ git-prune-packed - Remove extra objects that are already in pack files\n \n SYNOPSIS\n --------\n+[verse]\n 'git prune-packed' [-n|--dry-run] [-q|--quiet]\n \n \ndiff --git a/Documentation/git-prune.txt b/Documentation/git-prune.txt\nindex f616a73..80d01b0 100644\n--- a/Documentation/git-prune.txt\n+++ b/Documentation/git-prune.txt\n@@ -8,6 +8,7 @@ git-prune - Prune all unreachable objects from the object database\n \n SYNOPSIS\n --------\n+[verse]\n 'git prune' [-n] [-v] [--expire <expire>] [--] [<head>...]\n \n DESCRIPTION\ndiff --git a/Documentation/git-pull.txt b/Documentation/git-pull.txt\nindex 14609cb..e1da468 100644\n--- a/Documentation/git-pull.txt\n+++ b/Documentation/git-pull.txt\n@@ -8,6 +8,7 @@ git-pull - Fetch from and merge with another repository or a local branch\n \n SYNOPSIS\n --------\n+[verse]\n 'git pull' [options] [<repository> [<refspec>...]]\n \n \ndiff --git a/Documentation/git-read-tree.txt b/Documentation/git-read-tree.txt\nindex 46a96f2..c45d53c 100644\n--- a/Documentation/git-read-tree.txt\n+++ b/Documentation/git-read-tree.txt\n@@ -8,6 +8,7 @@ git-read-tree - Reads tree information into the index\n \n SYNOPSIS\n --------\n+[verse]\n 'git read-tree' [[-m [--trivial] [--aggressive] | --reset | --prefix=<prefix>]\n \t\t[-u [--exclude-per-directory=<gitignore>] | -i]]\n \t\t[--index-output=<file>] [--no-sparse-checkout]\ndiff --git a/Documentation/git-rebase.txt b/Documentation/git-rebase.txt\nindex 9a075bc..a9e0e50 100644\n--- a/Documentation/git-rebase.txt\n+++ b/Documentation/git-rebase.txt\n@@ -12,7 +12,6 @@ SYNOPSIS\n \t[<upstream>] [<branch>]\n 'git rebase' [-i | --interactive] [options] --onto <newbase>\n \t--root [<branch>]\n-\n 'git rebase' --continue | --skip | --abort\n \n DESCRIPTION\ndiff --git a/Documentation/git-receive-pack.txt b/Documentation/git-receive-pack.txt\nindex f34e0ae..459c085 100644\n--- a/Documentation/git-receive-pack.txt\n+++ b/Documentation/git-receive-pack.txt\n@@ -8,6 +8,7 @@ git-receive-pack - Receive what is pushed into the repository\n \n SYNOPSIS\n --------\n+[verse]\n 'git-receive-pack' <directory>\n \n DESCRIPTION\ndiff --git a/Documentation/git-reflog.txt b/Documentation/git-reflog.txt\nindex 09057bf..976dc14 100644\n--- a/Documentation/git-reflog.txt\n+++ b/Documentation/git-reflog.txt\n@@ -8,6 +8,7 @@ git-reflog - Manage reflog information\n \n SYNOPSIS\n --------\n+[verse]\n 'git reflog' <subcommand> <options>\n \n DESCRIPTION\ndiff --git a/Documentation/git-relink.txt b/Documentation/git-relink.txt\nindex 9893376..3b33c99 100644\n--- a/Documentation/git-relink.txt\n+++ b/Documentation/git-relink.txt\n@@ -7,6 +7,7 @@ git-relink - Hardlink common objects in local repositories\n \n SYNOPSIS\n --------\n+[verse]\n 'git relink' [--safe] <dir>... <master_dir>\n \n DESCRIPTION\ndiff --git a/Documentation/git-remote-ext.txt b/Documentation/git-remote-ext.txt\nindex 68263a6..8a8e1d7 100644\n--- a/Documentation/git-remote-ext.txt\n+++ b/Documentation/git-remote-ext.txt\n@@ -7,6 +7,7 @@ git-remote-ext - Bridge smart transport to external command.\n \n SYNOPSIS\n --------\n+[verse]\n git remote add <nick> \"ext::<command>[ <arguments>...]\"\n \n DESCRIPTION\ndiff --git a/Documentation/git-remote-helpers.txt b/Documentation/git-remote-helpers.txt\nindex 58f6ad4..930b403 100644\n--- a/Documentation/git-remote-helpers.txt\n+++ b/Documentation/git-remote-helpers.txt\n@@ -7,6 +7,7 @@ git-remote-helpers - Helper programs to interact with remote repositories\n \n SYNOPSIS\n --------\n+[verse]\n 'git remote-<transport>' <repository> [<URL>]\n \n DESCRIPTION\ndiff --git a/Documentation/git-repack.txt b/Documentation/git-repack.txt\nindex 0decee2..40af321 100644\n--- a/Documentation/git-repack.txt\n+++ b/Documentation/git-repack.txt\n@@ -8,6 +8,7 @@ git-repack - Pack unpacked objects in a repository\n \n SYNOPSIS\n --------\n+[verse]\n 'git repack' [-a] [-A] [-d] [-f] [-F] [-l] [-n] [-q] [--window=<n>] [--depth=<n>]\n \n DESCRIPTION\ndiff --git a/Documentation/git-repo-config.txt b/Documentation/git-repo-config.txt\nindex a0d1fa6..9ec115b 100644\n--- a/Documentation/git-repo-config.txt\n+++ b/Documentation/git-repo-config.txt\n@@ -8,6 +8,7 @@ git-repo-config - Get and set repository or global options\n \n SYNOPSIS\n --------\n+[verse]\n 'git repo-config' ...\n \n \ndiff --git a/Documentation/git-request-pull.txt b/Documentation/git-request-pull.txt\nindex 3521d8e..b99681c 100644\n--- a/Documentation/git-request-pull.txt\n+++ b/Documentation/git-request-pull.txt\n@@ -7,6 +7,7 @@ git-request-pull - Generates a summary of pending changes\n \n SYNOPSIS\n --------\n+[verse]\n 'git request-pull' [-p] <start> <url> [<end>]\n \n DESCRIPTION\ndiff --git a/Documentation/git-rerere.txt b/Documentation/git-rerere.txt\nindex 52db1d8..a6253ba 100644\n--- a/Documentation/git-rerere.txt\n+++ b/Documentation/git-rerere.txt\n@@ -7,6 +7,7 @@ git-rerere - Reuse recorded resolution of conflicted merges\n \n SYNOPSIS\n --------\n+[verse]\n 'git rerere' ['clear'|'forget' <pathspec>|'diff'|'status'|'gc']\n \n DESCRIPTION\ndiff --git a/Documentation/git-rev-parse.txt b/Documentation/git-rev-parse.txt\nindex 02c44c9..42c9676 100644\n--- a/Documentation/git-rev-parse.txt\n+++ b/Documentation/git-rev-parse.txt\n@@ -8,6 +8,7 @@ git-rev-parse - Pick out and massage parameters\n \n SYNOPSIS\n --------\n+[verse]\n 'git rev-parse' [ --option ] <args>...\n \n DESCRIPTION\ndiff --git a/Documentation/git-revert.txt b/Documentation/git-revert.txt\nindex ac10cfb..e4b46cf 100644\n--- a/Documentation/git-revert.txt\n+++ b/Documentation/git-revert.txt\n@@ -7,6 +7,7 @@ git-revert - Revert some existing commits\n \n SYNOPSIS\n --------\n+[verse]\n 'git revert' [--edit | --no-edit] [-n] [-m parent-number] [-s] <commit>...\n \n DESCRIPTION\ndiff --git a/Documentation/git-rm.txt b/Documentation/git-rm.txt\nindex 8c0554f..da0215d 100644\n--- a/Documentation/git-rm.txt\n+++ b/Documentation/git-rm.txt\n@@ -7,6 +7,7 @@ git-rm - Remove files from the working tree and from the index\n \n SYNOPSIS\n --------\n+[verse]\n 'git rm' [-f | --force] [-n] [-r] [--cached] [--ignore-unmatch] [--quiet] [--] <file>...\n \n DESCRIPTION\ndiff --git a/Documentation/git-send-email.txt b/Documentation/git-send-email.txt\nindex 5a168cf..327233c 100644\n--- a/Documentation/git-send-email.txt\n+++ b/Documentation/git-send-email.txt\n@@ -8,6 +8,7 @@ git-send-email - Send a collection of patches as emails\n \n SYNOPSIS\n --------\n+[verse]\n 'git send-email' [options] <file|directory|rev-list options>...\n \n \ndiff --git a/Documentation/git-send-pack.txt b/Documentation/git-send-pack.txt\nindex 17f8f55..bd3eaa6 100644\n--- a/Documentation/git-send-pack.txt\n+++ b/Documentation/git-send-pack.txt\n@@ -8,6 +8,7 @@ git-send-pack - Push objects over git protocol to another repository\n \n SYNOPSIS\n --------\n+[verse]\n 'git send-pack' [--all] [--dry-run] [--force] [--receive-pack=<git-receive-pack>] [--verbose] [--thin] [<host>:]<directory> [<ref>...]\n \n DESCRIPTION\ndiff --git a/Documentation/git-sh-i18n.txt b/Documentation/git-sh-i18n.txt\nindex 3b1f7ac..eafa55a 100644\n--- a/Documentation/git-sh-i18n.txt\n+++ b/Documentation/git-sh-i18n.txt\n@@ -7,6 +7,7 @@ git-sh-i18n - Git's i18n setup code for shell scripts\n \n SYNOPSIS\n --------\n+[verse]\n '. \"$(git --exec-path)/git-sh-i18n\"'\n \n DESCRIPTION\ndiff --git a/Documentation/git-sh-setup.txt b/Documentation/git-sh-setup.txt\nindex 27fd8ba..a2f346c 100644\n--- a/Documentation/git-sh-setup.txt\n+++ b/Documentation/git-sh-setup.txt\n@@ -7,6 +7,7 @@ git-sh-setup - Common git shell script setup code\n \n SYNOPSIS\n --------\n+[verse]\n '. \"$(git --exec-path)/git-sh-setup\"'\n \n DESCRIPTION\ndiff --git a/Documentation/git-shell.txt b/Documentation/git-shell.txt\nindex d7d4b92..9b92506 100644\n--- a/Documentation/git-shell.txt\n+++ b/Documentation/git-shell.txt\n@@ -8,6 +8,7 @@ git-shell - Restricted login shell for Git-only SSH access\n \n SYNOPSIS\n --------\n+[verse]\n 'git shell' [-c <command> <argument>]\n \n DESCRIPTION\ndiff --git a/Documentation/git-show-branch.txt b/Documentation/git-show-branch.txt\nindex ee4559b..a8e77b5 100644\n--- a/Documentation/git-show-branch.txt\n+++ b/Documentation/git-show-branch.txt\n@@ -13,7 +13,6 @@ SYNOPSIS\n \t\t[--more=<n> | --list | --independent | --merge-base]\n \t\t[--no-name | --sha1-name] [--topics]\n \t\t[(<rev> | <glob>)...]\n-\n 'git show-branch' (-g|--reflog)[=<n>[,<base>]] [--list] [<ref>]\n \n DESCRIPTION\ndiff --git a/Documentation/git-show-index.txt b/Documentation/git-show-index.txt\nindex c4d99f1..2dcbbb2 100644\n--- a/Documentation/git-show-index.txt\n+++ b/Documentation/git-show-index.txt\n@@ -8,6 +8,7 @@ git-show-index - Show packed archive index\n \n SYNOPSIS\n --------\n+[verse]\n 'git show-index' < idx-file\n \n \ndiff --git a/Documentation/git-show.txt b/Documentation/git-show.txt\nindex 7f075e8..1f0e30b 100644\n--- a/Documentation/git-show.txt\n+++ b/Documentation/git-show.txt\n@@ -8,6 +8,7 @@ git-show - Show various types of objects\n \n SYNOPSIS\n --------\n+[verse]\n 'git show' [options] <object>...\n \n DESCRIPTION\ndiff --git a/Documentation/git-status.txt b/Documentation/git-status.txt\nindex 8ecc99d..3d51717 100644\n--- a/Documentation/git-status.txt\n+++ b/Documentation/git-status.txt\n@@ -8,6 +8,7 @@ git-status - Show the working tree status\n \n SYNOPSIS\n --------\n+[verse]\n 'git status' [<options>...] [--] [<pathspec>...]\n \n DESCRIPTION\ndiff --git a/Documentation/git-stripspace.txt b/Documentation/git-stripspace.txt\nindex 10509cc..b78f031 100644\n--- a/Documentation/git-stripspace.txt\n+++ b/Documentation/git-stripspace.txt\n@@ -8,6 +8,7 @@ git-stripspace - Filter out empty lines\n \n SYNOPSIS\n --------\n+[verse]\n 'git stripspace' [-s | --strip-comments] < <stream>\n \n DESCRIPTION\ndiff --git a/Documentation/git-svn.txt b/Documentation/git-svn.txt\nindex 713e523..ed5eca1 100644\n--- a/Documentation/git-svn.txt\n+++ b/Documentation/git-svn.txt\n@@ -7,6 +7,7 @@ git-svn - Bidirectional operation between a Subversion repository and git\n \n SYNOPSIS\n --------\n+[verse]\n 'git svn' <command> [options] [arguments]\n \n DESCRIPTION\ndiff --git a/Documentation/git-symbolic-ref.txt b/Documentation/git-symbolic-ref.txt\nindex d7795ed..75b1ae5 100644\n--- a/Documentation/git-symbolic-ref.txt\n+++ b/Documentation/git-symbolic-ref.txt\n@@ -7,6 +7,7 @@ git-symbolic-ref - Read and modify symbolic refs\n \n SYNOPSIS\n --------\n+[verse]\n 'git symbolic-ref' [-q] [-m <reason>] <name> [<ref>]\n \n DESCRIPTION\ndiff --git a/Documentation/git-tar-tree.txt b/Documentation/git-tar-tree.txt\nindex 5f15754..95b135d 100644\n--- a/Documentation/git-tar-tree.txt\n+++ b/Documentation/git-tar-tree.txt\n@@ -8,6 +8,7 @@ git-tar-tree - Create a tar archive of the files in the named tree object\n \n SYNOPSIS\n --------\n+[verse]\n 'git tar-tree' [--remote=<repo>] <tree-ish> [ <base> ]\n \n DESCRIPTION\ndiff --git a/Documentation/git-unpack-file.txt b/Documentation/git-unpack-file.txt\nindex c49d727..e9f148a 100644\n--- a/Documentation/git-unpack-file.txt\n+++ b/Documentation/git-unpack-file.txt\n@@ -9,6 +9,7 @@ git-unpack-file - Creates a temporary file with a blob's contents\n \n SYNOPSIS\n --------\n+[verse]\n 'git unpack-file' <blob>\n \n DESCRIPTION\ndiff --git a/Documentation/git-unpack-objects.txt b/Documentation/git-unpack-objects.txt\nindex dd77990..ff23494 100644\n--- a/Documentation/git-unpack-objects.txt\n+++ b/Documentation/git-unpack-objects.txt\n@@ -8,6 +8,7 @@ git-unpack-objects - Unpack objects from a packed archive\n \n SYNOPSIS\n --------\n+[verse]\n 'git unpack-objects' [-n] [-q] [-r] [--strict] <pack-file\n \n \ndiff --git a/Documentation/git-update-ref.txt b/Documentation/git-update-ref.txt\nindex e25a65a..2a96143 100644\n--- a/Documentation/git-update-ref.txt\n+++ b/Documentation/git-update-ref.txt\n@@ -7,6 +7,7 @@ git-update-ref - Update the object name stored in a ref safely\n \n SYNOPSIS\n --------\n+[verse]\n 'git update-ref' [-m <reason>] (-d <ref> [<oldvalue>] | [--no-deref] <ref> <newvalue> [<oldvalue>])\n \n DESCRIPTION\ndiff --git a/Documentation/git-update-server-info.txt b/Documentation/git-update-server-info.txt\nindex 775024d..bd0e364 100644\n--- a/Documentation/git-update-server-info.txt\n+++ b/Documentation/git-update-server-info.txt\n@@ -8,6 +8,7 @@ git-update-server-info - Update auxiliary info file to help dumb servers\n \n SYNOPSIS\n --------\n+[verse]\n 'git update-server-info' [--force]\n \n DESCRIPTION\ndiff --git a/Documentation/git-upload-archive.txt b/Documentation/git-upload-archive.txt\nindex acbf634..4d52d38 100644\n--- a/Documentation/git-upload-archive.txt\n+++ b/Documentation/git-upload-archive.txt\n@@ -8,6 +8,7 @@ git-upload-archive - Send archive back to git-archive\n \n SYNOPSIS\n --------\n+[verse]\n 'git upload-archive' <directory>\n \n DESCRIPTION\ndiff --git a/Documentation/git-upload-pack.txt b/Documentation/git-upload-pack.txt\nindex 4c0ca9d..a58e90c 100644\n--- a/Documentation/git-upload-pack.txt\n+++ b/Documentation/git-upload-pack.txt\n@@ -8,6 +8,7 @@ git-upload-pack - Send objects packed back to git-fetch-pack\n \n SYNOPSIS\n --------\n+[verse]\n 'git-upload-pack' [--strict] [--timeout=<n>] <directory>\n \n DESCRIPTION\ndiff --git a/Documentation/git-var.txt b/Documentation/git-var.txt\nindex 6498f7c..5317cc2 100644\n--- a/Documentation/git-var.txt\n+++ b/Documentation/git-var.txt\n@@ -8,6 +8,7 @@ git-var - Show a git logical variable\n \n SYNOPSIS\n --------\n+[verse]\n 'git var' ( -l | <variable> )\n \n DESCRIPTION\ndiff --git a/Documentation/git-verify-pack.txt b/Documentation/git-verify-pack.txt\nindex 7c2428d..cd23076 100644\n--- a/Documentation/git-verify-pack.txt\n+++ b/Documentation/git-verify-pack.txt\n@@ -8,6 +8,7 @@ git-verify-pack - Validate packed git archive files\n \n SYNOPSIS\n --------\n+[verse]\n 'git verify-pack' [-v|--verbose] [-s|--stat-only] [--] <pack>.idx ...\n \n \ndiff --git a/Documentation/git-verify-tag.txt b/Documentation/git-verify-tag.txt\nindex 8c9a718..5ff76e8 100644\n--- a/Documentation/git-verify-tag.txt\n+++ b/Documentation/git-verify-tag.txt\n@@ -7,6 +7,7 @@ git-verify-tag - Check the GPG signature of tags\n \n SYNOPSIS\n --------\n+[verse]\n 'git verify-tag' <tag>...\n \n DESCRIPTION\ndiff --git a/Documentation/git-web--browse.txt b/Documentation/git-web--browse.txt\nindex 69d92fa..8b4f65a 100644\n--- a/Documentation/git-web--browse.txt\n+++ b/Documentation/git-web--browse.txt\n@@ -7,6 +7,7 @@ git-web--browse - git helper script to launch a web browser\n \n SYNOPSIS\n --------\n+[verse]\n 'git web{litdd}browse' [OPTIONS] URL/FILE ...\n \n DESCRIPTION\ndiff --git a/Documentation/git-whatchanged.txt b/Documentation/git-whatchanged.txt\nindex 31f3663..99388bd 100644\n--- a/Documentation/git-whatchanged.txt\n+++ b/Documentation/git-whatchanged.txt\n@@ -8,6 +8,7 @@ git-whatchanged - Show logs with difference each commit introduces\n \n SYNOPSIS\n --------\n+[verse]\n 'git whatchanged' <option>...\n \n DESCRIPTION\ndiff --git a/Documentation/git-write-tree.txt b/Documentation/git-write-tree.txt\nindex e8c94c1..f22041a 100644\n--- a/Documentation/git-write-tree.txt\n+++ b/Documentation/git-write-tree.txt\n@@ -8,6 +8,7 @@ git-write-tree - Create a tree object from the current index\n \n SYNOPSIS\n --------\n+[verse]\n 'git write-tree' [--missing-ok] [--prefix=<prefix>/]\n \n DESCRIPTION\ndiff --git a/Documentation/gitcvs-migration.txt b/Documentation/gitcvs-migration.txt\nindex d861ec4..aeb0cdc 100644\n--- a/Documentation/gitcvs-migration.txt\n+++ b/Documentation/gitcvs-migration.txt\n@@ -7,7 +7,8 @@ gitcvs-migration - git for CVS users\n \n SYNOPSIS\n --------\n-git cvsimport *\n+[verse]\n+'git cvsimport' *\n \n DESCRIPTION\n -----------\ndiff --git a/Documentation/gitdiffcore.txt b/Documentation/gitdiffcore.txt\nindex 6af29a4..370624c 100644\n--- a/Documentation/gitdiffcore.txt\n+++ b/Documentation/gitdiffcore.txt\n@@ -7,6 +7,7 @@ gitdiffcore - Tweaking diff output\n \n SYNOPSIS\n --------\n+[verse]\n 'git diff' *\n \n DESCRIPTION\ndiff --git a/Documentation/gitk.txt b/Documentation/gitk.txt\nindex e10ac58..a17a354 100644\n--- a/Documentation/gitk.txt\n+++ b/Documentation/gitk.txt\n@@ -7,6 +7,7 @@ gitk - The git repository browser\n \n SYNOPSIS\n --------\n+[verse]\n 'gitk' [<option>...] [<revs>] [--] [<path>...]\n \n DESCRIPTION\ndiff --git a/Documentation/gittutorial-2.txt b/Documentation/gittutorial-2.txt\nindex 7fe5848..f1e4422 100644\n--- a/Documentation/gittutorial-2.txt\n+++ b/Documentation/gittutorial-2.txt\n@@ -7,6 +7,7 @@ gittutorial-2 - A tutorial introduction to git: part two\n \n SYNOPSIS\n --------\n+[verse]\n git *\n \n DESCRIPTION\ndiff --git a/Documentation/gittutorial.txt b/Documentation/gittutorial.txt\nindex 0982f74..dee0505 100644\n--- a/Documentation/gittutorial.txt\n+++ b/Documentation/gittutorial.txt\n@@ -7,6 +7,7 @@ gittutorial - A tutorial introduction to git (for version 1.5.1 or newer)\n \n SYNOPSIS\n --------\n+[verse]\n git *\n \n DESCRIPTION\ndiff --git a/Documentation/gitworkflows.txt b/Documentation/gitworkflows.txt\nindex 1ef55ff..5e4f362 100644\n--- a/Documentation/gitworkflows.txt\n+++ b/Documentation/gitworkflows.txt\n@@ -7,6 +7,7 @@ gitworkflows - An overview of recommended workflows with git\n \n SYNOPSIS\n --------\n+[verse]\n git *\n \n \ndiff --git a/contrib/convert-objects/git-convert-objects.txt b/contrib/convert-objects/git-convert-objects.txt\nindex 9718abf..0565d83 100644\n--- a/contrib/convert-objects/git-convert-objects.txt\n+++ b/contrib/convert-objects/git-convert-objects.txt\n@@ -8,6 +8,7 @@ git-convert-objects - Converts old-style git repository\n \n SYNOPSIS\n --------\n+[verse]\n 'git-convert-objects'\n \n DESCRIPTION\ndiff --git a/contrib/gitview/gitview.txt b/contrib/gitview/gitview.txt\nindex 77c29de..9e12f97 100644\n--- a/contrib/gitview/gitview.txt\n+++ b/contrib/gitview/gitview.txt\n@@ -7,6 +7,7 @@ gitview - A GTK based repository browser for git\n \n SYNOPSIS\n --------\n+[verse]\n 'gitview' [options] [args]\n \n DESCRIPTION\ndiff --git a/contrib/svn-fe/svn-fe.txt b/contrib/svn-fe/svn-fe.txt\nindex cd075b9..72ffea0 100644\n--- a/contrib/svn-fe/svn-fe.txt\n+++ b/contrib/svn-fe/svn-fe.txt\n@@ -7,6 +7,7 @@ svn-fe - convert an SVN \"dumpfile\" to a fast-import stream\n \n SYNOPSIS\n --------\n+[verse]\n svnadmin dump --incremental REPO | svn-fe [url] | git fast-import\n \n DESCRIPTION\n-- \n1.7.5.3.640.gd1066\n"},{"id":"171104","messageId":"7v1uxwcy6x.fsf@alter.siamese.dyndns.org","threadId":"27744","inReplyTo":"1309574306-6787-1-git-send-email-martin.von.zweigbergk@gmail.com","subject":"Re: [PATCH 1/2] Documentation: use [verse] for SYNOPSIS sections","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2011-07-06T21:31:20Z","receivedAt":"2011-07-06T21:31:20Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Martin von Zweigbergk <martin.von.zweigbergk@gmail.com> writes:\n\n> Not the most fun patch I have ever written, but at least it improves\n> consistency a bit.\n\nThanks.\n"}]}