Merge branch 'mz/doc-synopsis-verse' into maint

* mz/doc-synopsis-verse: Documentation: use [verse] for SYNOPSIS sections
14 years ago · 412403eb45
93 changed files with 92 additions and 6 deletions
--- a/Documentation/git-annotate.txt
+++ b/Documentation/git-annotate.txt
@ -7,6 +7,7 @@ git-annotate - Annotate file lines with commit information
				@@ -7,6 +7,7 @@ git-annotate - Annotate file lines with commit information

 SYNOPSIS
 --------
+[verse]
 'git annotate' [options] file [revision]

 DESCRIPTION
--- a/Documentation/git-bisect.txt
+++ b/Documentation/git-bisect.txt
@ -8,6 +8,7 @@ git-bisect - Find by binary search the change that introduced a bug
				@@ -8,6 +8,7 @@ git-bisect - Find by binary search the change that introduced a bug

 SYNOPSIS
 --------
+[verse]
 'git bisect' <subcommand> <options>

 DESCRIPTION
--- a/Documentation/git-cherry-pick.txt
+++ b/Documentation/git-cherry-pick.txt
@ -7,6 +7,7 @@ git-cherry-pick - Apply the changes introduced by some existing commits
				@@ -7,6 +7,7 @@ git-cherry-pick - Apply the changes introduced by some existing commits

 SYNOPSIS
 --------
+[verse]
 'git cherry-pick' [--edit] [-n] [-m parent-number] [-s] [-x] [--ff] <commit>...

 DESCRIPTION
--- a/Documentation/git-cherry.txt
+++ b/Documentation/git-cherry.txt
@ -7,6 +7,7 @@ git-cherry - Find commits not merged upstream
				@@ -7,6 +7,7 @@ git-cherry - Find commits not merged upstream

 SYNOPSIS
 --------
+[verse]
 'git cherry' [-v] [<upstream> [<head> [<limit>]]]

 DESCRIPTION
--- a/Documentation/git-citool.txt
+++ b/Documentation/git-citool.txt
@ -7,6 +7,7 @@ git-citool - Graphical alternative to git-commit
				@@ -7,6 +7,7 @@ git-citool - Graphical alternative to git-commit

 SYNOPSIS
 --------
+[verse]
 'git citool'

 DESCRIPTION
--- a/Documentation/git-commit-tree.txt
+++ b/Documentation/git-commit-tree.txt
@ -8,6 +8,7 @@ git-commit-tree - Create a new commit object
				@@ -8,6 +8,7 @@ git-commit-tree - Create a new commit object

 SYNOPSIS
 --------
+[verse]
 'git commit-tree' <tree> [(-p <parent commit>)...] < changelog

 DESCRIPTION
--- a/Documentation/git-count-objects.txt
+++ b/Documentation/git-count-objects.txt
@ -7,6 +7,7 @@ git-count-objects - Count unpacked number of objects and their disk consumption
				@@ -7,6 +7,7 @@ git-count-objects - Count unpacked number of objects and their disk consumption

 SYNOPSIS
 --------
+[verse]
 'git count-objects' [-v]

 DESCRIPTION
--- a/Documentation/git-cvsexportcommit.txt
+++ b/Documentation/git-cvsexportcommit.txt
@ -8,6 +8,7 @@ git-cvsexportcommit - Export a single commit to a CVS checkout
				@@ -8,6 +8,7 @@ git-cvsexportcommit - Export a single commit to a CVS checkout

 SYNOPSIS
 --------
+[verse]
 'git cvsexportcommit' [-h] [-u] [-v] [-c] [-P] [-p] [-a] [-d cvsroot]
 	[-w cvsworkdir] [-W] [-f] [-m msgprefix] [PARENTCOMMIT] COMMITID

--- a/Documentation/git-diff-files.txt
+++ b/Documentation/git-diff-files.txt
@ -8,6 +8,7 @@ git-diff-files - Compares files in the working tree and the index
				@@ -8,6 +8,7 @@ git-diff-files - Compares files in the working tree and the index

 SYNOPSIS
 --------
+[verse]
 'git diff-files' [-q] [-0|-1|-2|-3|-c|--cc] [<common diff options>] [<path>...]

 DESCRIPTION
--- a/Documentation/git-diff-index.txt
+++ b/Documentation/git-diff-index.txt
@ -8,6 +8,7 @@ git-diff-index - Compares content and mode of blobs between the index and reposi
				@@ -8,6 +8,7 @@ git-diff-index - Compares content and mode of blobs between the index and reposi

 SYNOPSIS
 --------
+[verse]
 'git diff-index' [-m] [--cached] [<common diff options>] <tree-ish> [<path>...]

 DESCRIPTION
--- a/Documentation/git-difftool.txt
+++ b/Documentation/git-difftool.txt
@ -7,6 +7,7 @@ git-difftool - Show changes using common diff tools
				@@ -7,6 +7,7 @@ git-difftool - Show changes using common diff tools

 SYNOPSIS
 --------
+[verse]
 'git difftool' [<options>] [<commit> [<commit>]] [--] [<path>...]

 DESCRIPTION
--- a/Documentation/git-fast-export.txt
+++ b/Documentation/git-fast-export.txt
@ -8,6 +8,7 @@ git-fast-export - Git data exporter
				@@ -8,6 +8,7 @@ git-fast-export - Git data exporter

 SYNOPSIS
 --------
+[verse]
 'git fast-export [options]' | 'git fast-import'

 DESCRIPTION
--- a/Documentation/git-fast-import.txt
+++ b/Documentation/git-fast-import.txt
@ -8,6 +8,7 @@ git-fast-import - Backend for fast Git data importers
				@@ -8,6 +8,7 @@ git-fast-import - Backend for fast Git data importers

 SYNOPSIS
 --------
+[verse]
 frontend | 'git fast-import' [options]

 DESCRIPTION
--- a/Documentation/git-fetch-pack.txt
+++ b/Documentation/git-fetch-pack.txt
@ -8,6 +8,7 @@ git-fetch-pack - Receive missing objects from another repository
				@@ -8,6 +8,7 @@ git-fetch-pack - Receive missing objects from another repository

 SYNOPSIS
 --------
+[verse]
 'git fetch-pack' [--all] [--quiet|-q] [--keep|-k] [--thin] [--include-tag] [--upload-pack=<git-upload-pack>] [--depth=<n>] [--no-progress] [-v] [<host>:]<directory> [<refs>...]

 DESCRIPTION
--- a/Documentation/git-fetch.txt
+++ b/Documentation/git-fetch.txt
@ -8,12 +8,10 @@ git-fetch - Download objects and refs from another repository
				@@ -8,12 +8,10 @@ git-fetch - Download objects and refs from another repository

 SYNOPSIS
 --------
+[verse]
 'git fetch' [<options>] [<repository> [<refspec>...]]
-
 'git fetch' [<options>] <group>
-
 'git fetch' --multiple [<options>] [(<repository> | <group>)...]
-
 'git fetch' --all [<options>]


--- a/Documentation/git-fsck-objects.txt
+++ b/Documentation/git-fsck-objects.txt
@ -8,6 +8,7 @@ git-fsck-objects - Verifies the connectivity and validity of the objects in the
				@@ -8,6 +8,7 @@ git-fsck-objects - Verifies the connectivity and validity of the objects in the

 SYNOPSIS
 --------
+[verse]
 'git fsck-objects' ...

 DESCRIPTION
--- a/Documentation/git-gc.txt
+++ b/Documentation/git-gc.txt
@ -8,6 +8,7 @@ git-gc - Cleanup unnecessary files and optimize the local repository
				@@ -8,6 +8,7 @@ git-gc - Cleanup unnecessary files and optimize the local repository

 SYNOPSIS
 --------
+[verse]
 'git gc' [--aggressive] [--auto] [--quiet] [--prune=<date> | --no-prune]

 DESCRIPTION
--- a/Documentation/git-get-tar-commit-id.txt
+++ b/Documentation/git-get-tar-commit-id.txt
@ -8,6 +8,7 @@ git-get-tar-commit-id - Extract commit ID from an archive created using git-arch
				@@ -8,6 +8,7 @@ git-get-tar-commit-id - Extract commit ID from an archive created using git-arch

 SYNOPSIS
 --------
+[verse]
 'git get-tar-commit-id' < <tarfile>


--- a/Documentation/git-gui.txt
+++ b/Documentation/git-gui.txt
@ -7,6 +7,7 @@ git-gui - A portable graphical interface to Git
				@@ -7,6 +7,7 @@ git-gui - A portable graphical interface to Git

 SYNOPSIS
 --------
+[verse]
 'git gui' [<command>] [arguments]

 DESCRIPTION
--- a/Documentation/git-help.txt
+++ b/Documentation/git-help.txt
@ -7,6 +7,7 @@ git-help - display help information about git
				@@ -7,6 +7,7 @@ git-help - display help information about git

 SYNOPSIS
 --------
+[verse]
 'git help' [-a|--all|-i|--info|-m|--man|-w|--web] [COMMAND]

 DESCRIPTION
--- a/Documentation/git-http-fetch.txt
+++ b/Documentation/git-http-fetch.txt
@ -8,6 +8,7 @@ git-http-fetch - Download from a remote git repository via HTTP
				@@ -8,6 +8,7 @@ git-http-fetch - Download from a remote git repository via HTTP

 SYNOPSIS
 --------
+[verse]
 'git http-fetch' [-c] [-t] [-a] [-d] [-v] [-w filename] [--recover] [--stdin] <commit> <url>

 DESCRIPTION
--- a/Documentation/git-http-push.txt
+++ b/Documentation/git-http-push.txt
@ -8,6 +8,7 @@ git-http-push - Push objects over HTTP/DAV to another repository
				@@ -8,6 +8,7 @@ git-http-push - Push objects over HTTP/DAV to another repository

 SYNOPSIS
 --------
+[verse]
 'git http-push' [--all] [--dry-run] [--force] [--verbose] <url> <ref> [<ref>...]

 DESCRIPTION
--- a/Documentation/git-imap-send.txt
+++ b/Documentation/git-imap-send.txt
@ -8,6 +8,7 @@ git-imap-send - Send a collection of patches from stdin to an IMAP folder
				@@ -8,6 +8,7 @@ git-imap-send - Send a collection of patches from stdin to an IMAP folder

 SYNOPSIS
 --------
+[verse]
 'git imap-send'


--- a/Documentation/git-init-db.txt
+++ b/Documentation/git-init-db.txt
@ -8,6 +8,7 @@ git-init-db - Creates an empty git repository
				@@ -8,6 +8,7 @@ git-init-db - Creates an empty git repository

 SYNOPSIS
 --------
+[verse]
 'git init-db' [-q | --quiet] [--bare] [--template=<template_directory>] [--separate-git-dir <git dir>] [--shared[=<permissions>]]


--- a/Documentation/git-init.txt
+++ b/Documentation/git-init.txt
@ -8,6 +8,7 @@ git-init - Create an empty git repository or reinitialize an existing one
				@@ -8,6 +8,7 @@ git-init - Create an empty git repository or reinitialize an existing one

 SYNOPSIS
 --------
+[verse]
 'git init' [-q | --quiet] [--bare] [--template=<template_directory>]
 	  [--separate-git-dir <git dir>]
 	  [--shared[=<permissions>]] [directory]
--- a/Documentation/git-log.txt
+++ b/Documentation/git-log.txt
@ -8,6 +8,7 @@ git-log - Show commit logs
				@@ -8,6 +8,7 @@ git-log - Show commit logs

 SYNOPSIS
 --------
+[verse]
 'git log' [<options>] [<since>..<until>] [[\--] <path>...]

 DESCRIPTION
--- a/Documentation/git-lost-found.txt
+++ b/Documentation/git-lost-found.txt
@ -7,6 +7,7 @@ git-lost-found - Recover lost refs that luckily have not yet been pruned
				@@ -7,6 +7,7 @@ git-lost-found - Recover lost refs that luckily have not yet been pruned

 SYNOPSIS
 --------
+[verse]
 'git lost-found'

 DESCRIPTION
--- a/Documentation/git-mailinfo.txt
+++ b/Documentation/git-mailinfo.txt
@ -8,6 +8,7 @@ git-mailinfo - Extracts patch and authorship from a single e-mail message
				@@ -8,6 +8,7 @@ git-mailinfo - Extracts patch and authorship from a single e-mail message

 SYNOPSIS
 --------
+[verse]
 'git mailinfo' [-k|-b] [-u | --encoding=<encoding> | -n] [--scissors] <msg> <patch>


--- a/Documentation/git-mailsplit.txt
+++ b/Documentation/git-mailsplit.txt
@ -7,6 +7,7 @@ git-mailsplit - Simple UNIX mbox splitter program
				@@ -7,6 +7,7 @@ git-mailsplit - Simple UNIX mbox splitter program

 SYNOPSIS
 --------
+[verse]
 'git mailsplit' [-b] [-f<nn>] [-d<prec>] [--keep-cr] -o<directory> [--] [(<mbox>|<Maildir>)...]

 DESCRIPTION
--- a/Documentation/git-merge-index.txt
+++ b/Documentation/git-merge-index.txt
@ -8,6 +8,7 @@ git-merge-index - Run a merge for files needing merging
				@@ -8,6 +8,7 @@ git-merge-index - Run a merge for files needing merging

 SYNOPSIS
 --------
+[verse]
 'git merge-index' [-o] [-q] <merge-program> (-a | [--] <file>*)

 DESCRIPTION
--- a/Documentation/git-merge-one-file.txt
+++ b/Documentation/git-merge-one-file.txt
@ -8,6 +8,7 @@ git-merge-one-file - The standard helper program to use with git-merge-index
				@@ -8,6 +8,7 @@ git-merge-one-file - The standard helper program to use with git-merge-index

 SYNOPSIS
 --------
+[verse]
 'git merge-one-file'

 DESCRIPTION
--- a/Documentation/git-merge-tree.txt
+++ b/Documentation/git-merge-tree.txt
@ -8,6 +8,7 @@ git-merge-tree - Show three-way merge without touching index
				@@ -8,6 +8,7 @@ git-merge-tree - Show three-way merge without touching index

 SYNOPSIS
 --------
+[verse]
 'git merge-tree' <base-tree> <branch1> <branch2>

 DESCRIPTION
--- a/Documentation/git-mergetool--lib.txt
+++ b/Documentation/git-mergetool--lib.txt
@ -7,6 +7,7 @@ git-mergetool--lib - Common git merge tool shell scriptlets
				@@ -7,6 +7,7 @@ git-mergetool--lib - Common git merge tool shell scriptlets

 SYNOPSIS
 --------
+[verse]
 'TOOL_MODE=(diff|merge) . "$(git --exec-path)/git-mergetool--lib"'

 DESCRIPTION
--- a/Documentation/git-mergetool.txt
+++ b/Documentation/git-mergetool.txt
@ -7,6 +7,7 @@ git-mergetool - Run merge conflict resolution tools to resolve merge conflicts
				@@ -7,6 +7,7 @@ git-mergetool - Run merge conflict resolution tools to resolve merge conflicts

 SYNOPSIS
 --------
+[verse]
 'git mergetool' [--tool=<tool>] [-y|--no-prompt|--prompt] [<file>...]

 DESCRIPTION
--- a/Documentation/git-mktag.txt
+++ b/Documentation/git-mktag.txt
@ -8,6 +8,7 @@ git-mktag - Creates a tag object
				@@ -8,6 +8,7 @@ git-mktag - Creates a tag object

 SYNOPSIS
 --------
+[verse]
 'git mktag' < signature_file

 DESCRIPTION
--- a/Documentation/git-mktree.txt
+++ b/Documentation/git-mktree.txt
@ -8,6 +8,7 @@ git-mktree - Build a tree-object from ls-tree formatted text
				@@ -8,6 +8,7 @@ git-mktree - Build a tree-object from ls-tree formatted text

 SYNOPSIS
 --------
+[verse]
 'git mktree' [-z] [--missing] [--batch]

 DESCRIPTION
--- a/Documentation/git-mv.txt
+++ b/Documentation/git-mv.txt
@ -8,6 +8,7 @@ git-mv - Move or rename a file, a directory, or a symlink
				@@ -8,6 +8,7 @@ git-mv - Move or rename a file, a directory, or a symlink

 SYNOPSIS
 --------
+[verse]
 'git mv' <options>... <args>...

 DESCRIPTION
--- a/Documentation/git-pack-redundant.txt
+++ b/Documentation/git-pack-redundant.txt
@ -8,6 +8,7 @@ git-pack-redundant - Find redundant pack files
				@@ -8,6 +8,7 @@ git-pack-redundant - Find redundant pack files

 SYNOPSIS
 --------
+[verse]
 'git pack-redundant' [ --verbose ] [ --alt-odb ] < --all | .pack filename ... >

 DESCRIPTION
--- a/Documentation/git-pack-refs.txt
+++ b/Documentation/git-pack-refs.txt
@ -7,6 +7,7 @@ git-pack-refs - Pack heads and tags for efficient repository access
				@@ -7,6 +7,7 @@ git-pack-refs - Pack heads and tags for efficient repository access

 SYNOPSIS
 --------
+[verse]
 'git pack-refs' [--all] [--no-prune]

 DESCRIPTION
--- a/Documentation/git-parse-remote.txt
+++ b/Documentation/git-parse-remote.txt
@ -8,6 +8,7 @@ git-parse-remote - Routines to help parsing remote repository access parameters
				@@ -8,6 +8,7 @@ git-parse-remote - Routines to help parsing remote repository access parameters

 SYNOPSIS
 --------
+[verse]
 '. "$(git --exec-path)/git-parse-remote"'

 DESCRIPTION
--- a/Documentation/git-patch-id.txt
+++ b/Documentation/git-patch-id.txt
@ -7,6 +7,7 @@ git-patch-id - Compute unique ID for a patch
				@@ -7,6 +7,7 @@ git-patch-id - Compute unique ID for a patch

 SYNOPSIS
 --------
+[verse]
 'git patch-id' < <patch>

 DESCRIPTION
--- a/Documentation/git-peek-remote.txt
+++ b/Documentation/git-peek-remote.txt
@ -8,6 +8,7 @@ git-peek-remote - List the references in a remote repository
				@@ -8,6 +8,7 @@ git-peek-remote - List the references in a remote repository

 SYNOPSIS
 --------
+[verse]
 'git peek-remote' [--upload-pack=<git-upload-pack>] [<host>:]<directory>

 DESCRIPTION
--- a/Documentation/git-prune-packed.txt
+++ b/Documentation/git-prune-packed.txt
@ -8,6 +8,7 @@ git-prune-packed - Remove extra objects that are already in pack files
				@@ -8,6 +8,7 @@ git-prune-packed - Remove extra objects that are already in pack files

 SYNOPSIS
 --------
+[verse]
 'git prune-packed' [-n|--dry-run] [-q|--quiet]


--- a/Documentation/git-prune.txt
+++ b/Documentation/git-prune.txt
@ -8,6 +8,7 @@ git-prune - Prune all unreachable objects from the object database
				@@ -8,6 +8,7 @@ git-prune - Prune all unreachable objects from the object database

 SYNOPSIS
 --------
+[verse]
 'git prune' [-n] [-v] [--expire <expire>] [--] [<head>...]

 DESCRIPTION
--- a/Documentation/git-pull.txt
+++ b/Documentation/git-pull.txt
@ -8,6 +8,7 @@ git-pull - Fetch from and merge with another repository or a local branch
				@@ -8,6 +8,7 @@ git-pull - Fetch from and merge with another repository or a local branch

 SYNOPSIS
 --------
+[verse]
 'git pull' [options] [<repository> [<refspec>...]]


--- a/Documentation/git-read-tree.txt
+++ b/Documentation/git-read-tree.txt
@ -8,6 +8,7 @@ git-read-tree - Reads tree information into the index
				@@ -8,6 +8,7 @@ git-read-tree - Reads tree information into the index

 SYNOPSIS
 --------
+[verse]
 'git read-tree' [[-m [--trivial] [--aggressive] | --reset | --prefix=<prefix>]
 		[-u [--exclude-per-directory=<gitignore>] | -i]]
 		[--index-output=<file>] [--no-sparse-checkout]
--- a/Documentation/git-rebase.txt
+++ b/Documentation/git-rebase.txt
@ -12,7 +12,6 @@ SYNOPSIS
				@@ -12,7 +12,6 @@ SYNOPSIS
 	[<upstream>] [<branch>]
 'git rebase' [-i | --interactive] [options] --onto <newbase>
 	--root [<branch>]
-
 'git rebase' --continue | --skip | --abort

 DESCRIPTION
--- a/Documentation/git-receive-pack.txt
+++ b/Documentation/git-receive-pack.txt
@ -8,6 +8,7 @@ git-receive-pack - Receive what is pushed into the repository
				@@ -8,6 +8,7 @@ git-receive-pack - Receive what is pushed into the repository

 SYNOPSIS
 --------
+[verse]
 'git-receive-pack' <directory>

 DESCRIPTION
--- a/Documentation/git-reflog.txt
+++ b/Documentation/git-reflog.txt
@ -8,6 +8,7 @@ git-reflog - Manage reflog information
				@@ -8,6 +8,7 @@ git-reflog - Manage reflog information

 SYNOPSIS
 --------
+[verse]
 'git reflog' <subcommand> <options>

 DESCRIPTION
--- a/Documentation/git-relink.txt
+++ b/Documentation/git-relink.txt
@ -7,6 +7,7 @@ git-relink - Hardlink common objects in local repositories
				@@ -7,6 +7,7 @@ git-relink - Hardlink common objects in local repositories

 SYNOPSIS
 --------
+[verse]
 'git relink' [--safe] <dir>... <master_dir>

 DESCRIPTION
--- a/Documentation/git-remote-ext.txt
+++ b/Documentation/git-remote-ext.txt
@ -7,6 +7,7 @@ git-remote-ext - Bridge smart transport to external command.
				@@ -7,6 +7,7 @@ git-remote-ext - Bridge smart transport to external command.

 SYNOPSIS
 --------
+[verse]
 git remote add <nick> "ext::<command>[ <arguments>...]"

 DESCRIPTION
--- a/Documentation/git-remote-helpers.txt
+++ b/Documentation/git-remote-helpers.txt
@ -7,6 +7,7 @@ git-remote-helpers - Helper programs to interact with remote repositories
				@@ -7,6 +7,7 @@ git-remote-helpers - Helper programs to interact with remote repositories

 SYNOPSIS
 --------
+[verse]
 'git remote-<transport>' <repository> [<URL>]

 DESCRIPTION
--- a/Documentation/git-repack.txt
+++ b/Documentation/git-repack.txt
@ -8,6 +8,7 @@ git-repack - Pack unpacked objects in a repository
				@@ -8,6 +8,7 @@ git-repack - Pack unpacked objects in a repository

 SYNOPSIS
 --------
+[verse]
 'git repack' [-a] [-A] [-d] [-f] [-F] [-l] [-n] [-q] [--window=<n>] [--depth=<n>]

 DESCRIPTION
--- a/Documentation/git-repo-config.txt
+++ b/Documentation/git-repo-config.txt
@ -8,6 +8,7 @@ git-repo-config - Get and set repository or global options
				@@ -8,6 +8,7 @@ git-repo-config - Get and set repository or global options

 SYNOPSIS
 --------
+[verse]
 'git repo-config' ...


--- a/Documentation/git-request-pull.txt
+++ b/Documentation/git-request-pull.txt
@ -7,6 +7,7 @@ git-request-pull - Generates a summary of pending changes
				@@ -7,6 +7,7 @@ git-request-pull - Generates a summary of pending changes

 SYNOPSIS
 --------
+[verse]
 'git request-pull' [-p] <start> <url> [<end>]

 DESCRIPTION
--- a/Documentation/git-rerere.txt
+++ b/Documentation/git-rerere.txt
@ -7,6 +7,7 @@ git-rerere - Reuse recorded resolution of conflicted merges
				@@ -7,6 +7,7 @@ git-rerere - Reuse recorded resolution of conflicted merges

 SYNOPSIS
 --------
+[verse]
 'git rerere' ['clear'|'forget' <pathspec>|'diff'|'status'|'gc']

 DESCRIPTION
--- a/Documentation/git-rev-parse.txt
+++ b/Documentation/git-rev-parse.txt
@ -8,6 +8,7 @@ git-rev-parse - Pick out and massage parameters
				@@ -8,6 +8,7 @@ git-rev-parse - Pick out and massage parameters

 SYNOPSIS
 --------
+[verse]
 'git rev-parse' [ --option ] <args>...

 DESCRIPTION
--- a/Documentation/git-revert.txt
+++ b/Documentation/git-revert.txt
@ -7,6 +7,7 @@ git-revert - Revert some existing commits
				@@ -7,6 +7,7 @@ git-revert - Revert some existing commits

 SYNOPSIS
 --------
+[verse]
 'git revert' [--edit | --no-edit] [-n] [-m parent-number] [-s] <commit>...

 DESCRIPTION
--- a/Documentation/git-rm.txt
+++ b/Documentation/git-rm.txt
@ -7,6 +7,7 @@ git-rm - Remove files from the working tree and from the index
				@@ -7,6 +7,7 @@ git-rm - Remove files from the working tree and from the index

 SYNOPSIS
 --------
+[verse]
 'git rm' [-f | --force] [-n] [-r] [--cached] [--ignore-unmatch] [--quiet] [--] <file>...

 DESCRIPTION
--- a/Documentation/git-send-email.txt
+++ b/Documentation/git-send-email.txt
@ -8,6 +8,7 @@ git-send-email - Send a collection of patches as emails
				@@ -8,6 +8,7 @@ git-send-email - Send a collection of patches as emails

 SYNOPSIS
 --------
+[verse]
 'git send-email' [options] <file|directory|rev-list options>...


--- a/Documentation/git-send-pack.txt
+++ b/Documentation/git-send-pack.txt
@ -8,6 +8,7 @@ git-send-pack - Push objects over git protocol to another repository
				@@ -8,6 +8,7 @@ git-send-pack - Push objects over git protocol to another repository

 SYNOPSIS
 --------
+[verse]
 'git send-pack' [--all] [--dry-run] [--force] [--receive-pack=<git-receive-pack>] [--verbose] [--thin] [<host>:]<directory> [<ref>...]

 DESCRIPTION
--- a/Documentation/git-sh-i18n.txt
+++ b/Documentation/git-sh-i18n.txt
@ -7,6 +7,7 @@ git-sh-i18n - Git's i18n setup code for shell scripts
				@@ -7,6 +7,7 @@ git-sh-i18n - Git's i18n setup code for shell scripts

 SYNOPSIS
 --------
+[verse]
 '. "$(git --exec-path)/git-sh-i18n"'

 DESCRIPTION
--- a/Documentation/git-sh-setup.txt
+++ b/Documentation/git-sh-setup.txt
@ -7,6 +7,7 @@ git-sh-setup - Common git shell script setup code
				@@ -7,6 +7,7 @@ git-sh-setup - Common git shell script setup code

 SYNOPSIS
 --------
+[verse]
 '. "$(git --exec-path)/git-sh-setup"'

 DESCRIPTION
--- a/Documentation/git-shell.txt
+++ b/Documentation/git-shell.txt
@ -8,6 +8,7 @@ git-shell - Restricted login shell for Git-only SSH access
				@@ -8,6 +8,7 @@ git-shell - Restricted login shell for Git-only SSH access

 SYNOPSIS
 --------
+[verse]
 'git shell' [-c <command> <argument>]

 DESCRIPTION
--- a/Documentation/git-show-branch.txt
+++ b/Documentation/git-show-branch.txt
@ -13,7 +13,6 @@ SYNOPSIS
				@@ -13,7 +13,6 @@ SYNOPSIS
 		[--more=<n> | --list | --independent | --merge-base]
 		[--no-name | --sha1-name] [--topics]
 		[(<rev> | <glob>)...]
-
 'git show-branch' (-g|--reflog)[=<n>[,<base>]] [--list] [<ref>]

 DESCRIPTION
--- a/Documentation/git-show-index.txt
+++ b/Documentation/git-show-index.txt
@ -8,6 +8,7 @@ git-show-index - Show packed archive index
				@@ -8,6 +8,7 @@ git-show-index - Show packed archive index

 SYNOPSIS
 --------
+[verse]
 'git show-index' < idx-file


--- a/Documentation/git-show.txt
+++ b/Documentation/git-show.txt
@ -8,6 +8,7 @@ git-show - Show various types of objects
				@@ -8,6 +8,7 @@ git-show - Show various types of objects

 SYNOPSIS
 --------
+[verse]
 'git show' [options] <object>...

 DESCRIPTION
--- a/Documentation/git-status.txt
+++ b/Documentation/git-status.txt
@ -8,6 +8,7 @@ git-status - Show the working tree status
				@@ -8,6 +8,7 @@ git-status - Show the working tree status

 SYNOPSIS
 --------
+[verse]
 'git status' [<options>...] [--] [<pathspec>...]

 DESCRIPTION
--- a/Documentation/git-stripspace.txt
+++ b/Documentation/git-stripspace.txt
@ -8,6 +8,7 @@ git-stripspace - Filter out empty lines
				@@ -8,6 +8,7 @@ git-stripspace - Filter out empty lines

 SYNOPSIS
 --------
+[verse]
 'git stripspace' [-s | --strip-comments] < <stream>

 DESCRIPTION
--- a/Documentation/git-svn.txt
+++ b/Documentation/git-svn.txt
@ -7,6 +7,7 @@ git-svn - Bidirectional operation between a Subversion repository and git
				@@ -7,6 +7,7 @@ git-svn - Bidirectional operation between a Subversion repository and git

 SYNOPSIS
 --------
+[verse]
 'git svn' <command> [options] [arguments]

 DESCRIPTION
--- a/Documentation/git-symbolic-ref.txt
+++ b/Documentation/git-symbolic-ref.txt
@ -7,6 +7,7 @@ git-symbolic-ref - Read and modify symbolic refs
				@@ -7,6 +7,7 @@ git-symbolic-ref - Read and modify symbolic refs

 SYNOPSIS
 --------
+[verse]
 'git symbolic-ref' [-q] [-m <reason>] <name> [<ref>]

 DESCRIPTION
--- a/Documentation/git-tar-tree.txt
+++ b/Documentation/git-tar-tree.txt
@ -8,6 +8,7 @@ git-tar-tree - Create a tar archive of the files in the named tree object
				@@ -8,6 +8,7 @@ git-tar-tree - Create a tar archive of the files in the named tree object

 SYNOPSIS
 --------
+[verse]
 'git tar-tree' [--remote=<repo>] <tree-ish> [ <base> ]

 DESCRIPTION
--- a/Documentation/git-unpack-file.txt
+++ b/Documentation/git-unpack-file.txt
@ -9,6 +9,7 @@ git-unpack-file - Creates a temporary file with a blob's contents
				@@ -9,6 +9,7 @@ git-unpack-file - Creates a temporary file with a blob's contents

 SYNOPSIS
 --------
+[verse]
 'git unpack-file' <blob>

 DESCRIPTION
--- a/Documentation/git-unpack-objects.txt
+++ b/Documentation/git-unpack-objects.txt
@ -8,6 +8,7 @@ git-unpack-objects - Unpack objects from a packed archive
				@@ -8,6 +8,7 @@ git-unpack-objects - Unpack objects from a packed archive

 SYNOPSIS
 --------
+[verse]
 'git unpack-objects' [-n] [-q] [-r] [--strict] <pack-file


--- a/Documentation/git-update-ref.txt
+++ b/Documentation/git-update-ref.txt
@ -7,6 +7,7 @@ git-update-ref - Update the object name stored in a ref safely
				@@ -7,6 +7,7 @@ git-update-ref - Update the object name stored in a ref safely

 SYNOPSIS
 --------
+[verse]
 'git update-ref' [-m <reason>] (-d <ref> [<oldvalue>] | [--no-deref] <ref> <newvalue> [<oldvalue>])

 DESCRIPTION
--- a/Documentation/git-update-server-info.txt
+++ b/Documentation/git-update-server-info.txt
@ -8,6 +8,7 @@ git-update-server-info - Update auxiliary info file to help dumb servers
				@@ -8,6 +8,7 @@ git-update-server-info - Update auxiliary info file to help dumb servers

 SYNOPSIS
 --------
+[verse]
 'git update-server-info' [--force]

 DESCRIPTION
--- a/Documentation/git-upload-archive.txt
+++ b/Documentation/git-upload-archive.txt
@ -8,6 +8,7 @@ git-upload-archive - Send archive back to git-archive
				@@ -8,6 +8,7 @@ git-upload-archive - Send archive back to git-archive

 SYNOPSIS
 --------
+[verse]
 'git upload-archive' <directory>

 DESCRIPTION
--- a/Documentation/git-upload-pack.txt
+++ b/Documentation/git-upload-pack.txt
@ -8,6 +8,7 @@ git-upload-pack - Send objects packed back to git-fetch-pack
				@@ -8,6 +8,7 @@ git-upload-pack - Send objects packed back to git-fetch-pack

 SYNOPSIS
 --------
+[verse]
 'git-upload-pack' [--strict] [--timeout=<n>] <directory>

 DESCRIPTION
--- a/Documentation/git-var.txt
+++ b/Documentation/git-var.txt
@ -8,6 +8,7 @@ git-var - Show a git logical variable
				@@ -8,6 +8,7 @@ git-var - Show a git logical variable

 SYNOPSIS
 --------
+[verse]
 'git var' ( -l | <variable> )

 DESCRIPTION
--- a/Documentation/git-verify-pack.txt
+++ b/Documentation/git-verify-pack.txt
@ -8,6 +8,7 @@ git-verify-pack - Validate packed git archive files
				@@ -8,6 +8,7 @@ git-verify-pack - Validate packed git archive files

 SYNOPSIS
 --------
+[verse]
 'git verify-pack' [-v|--verbose] [-s|--stat-only] [--] <pack>.idx ...


--- a/Documentation/git-verify-tag.txt
+++ b/Documentation/git-verify-tag.txt
@ -7,6 +7,7 @@ git-verify-tag - Check the GPG signature of tags
				@@ -7,6 +7,7 @@ git-verify-tag - Check the GPG signature of tags

 SYNOPSIS
 --------
+[verse]
 'git verify-tag' <tag>...

 DESCRIPTION
--- a/Documentation/git-web--browse.txt
+++ b/Documentation/git-web--browse.txt
@ -7,6 +7,7 @@ git-web--browse - git helper script to launch a web browser
				@@ -7,6 +7,7 @@ git-web--browse - git helper script to launch a web browser

 SYNOPSIS
 --------
+[verse]
 'git web{litdd}browse' [OPTIONS] URL/FILE ...

 DESCRIPTION
--- a/Documentation/git-whatchanged.txt
+++ b/Documentation/git-whatchanged.txt
@ -8,6 +8,7 @@ git-whatchanged - Show logs with difference each commit introduces
				@@ -8,6 +8,7 @@ git-whatchanged - Show logs with difference each commit introduces

 SYNOPSIS
 --------
+[verse]
 'git whatchanged' <option>...

 DESCRIPTION
--- a/Documentation/git-write-tree.txt
+++ b/Documentation/git-write-tree.txt
@ -8,6 +8,7 @@ git-write-tree - Create a tree object from the current index
				@@ -8,6 +8,7 @@ git-write-tree - Create a tree object from the current index

 SYNOPSIS
 --------
+[verse]
 'git write-tree' [--missing-ok] [--prefix=<prefix>/]

 DESCRIPTION
--- a/Documentation/gitcvs-migration.txt
+++ b/Documentation/gitcvs-migration.txt
@ -7,7 +7,8 @@ gitcvs-migration - git for CVS users
				@@ -7,7 +7,8 @@ gitcvs-migration - git for CVS users

 SYNOPSIS
 --------
-git cvsimport *
+[verse]
+'git cvsimport' *

 DESCRIPTION
 -----------
--- a/Documentation/gitdiffcore.txt
+++ b/Documentation/gitdiffcore.txt
@ -7,6 +7,7 @@ gitdiffcore - Tweaking diff output
				@@ -7,6 +7,7 @@ gitdiffcore - Tweaking diff output

 SYNOPSIS
 --------
+[verse]
 'git diff' *

 DESCRIPTION
--- a/Documentation/gitk.txt
+++ b/Documentation/gitk.txt
@ -7,6 +7,7 @@ gitk - The git repository browser
				@@ -7,6 +7,7 @@ gitk - The git repository browser

 SYNOPSIS
 --------
+[verse]
 'gitk' [<option>...] [<revs>] [--] [<path>...]

 DESCRIPTION
--- a/Documentation/gittutorial-2.txt
+++ b/Documentation/gittutorial-2.txt
@ -7,6 +7,7 @@ gittutorial-2 - A tutorial introduction to git: part two
				@@ -7,6 +7,7 @@ gittutorial-2 - A tutorial introduction to git: part two

 SYNOPSIS
 --------
+[verse]
 git *

 DESCRIPTION
--- a/Documentation/gittutorial.txt
+++ b/Documentation/gittutorial.txt
@ -7,6 +7,7 @@ gittutorial - A tutorial introduction to git (for version 1.5.1 or newer)
				@@ -7,6 +7,7 @@ gittutorial - A tutorial introduction to git (for version 1.5.1 or newer)

 SYNOPSIS
 --------
+[verse]
 git *

 DESCRIPTION
--- a/Documentation/gitworkflows.txt
+++ b/Documentation/gitworkflows.txt
@ -7,6 +7,7 @@ gitworkflows - An overview of recommended workflows with git
				@@ -7,6 +7,7 @@ gitworkflows - An overview of recommended workflows with git

 SYNOPSIS
 --------
+[verse]
 git *


--- a/contrib/convert-objects/git-convert-objects.txt
+++ b/contrib/convert-objects/git-convert-objects.txt
@ -8,6 +8,7 @@ git-convert-objects - Converts old-style git repository
				@@ -8,6 +8,7 @@ git-convert-objects - Converts old-style git repository

 SYNOPSIS
 --------
+[verse]
 'git-convert-objects'

 DESCRIPTION
--- a/contrib/gitview/gitview.txt
+++ b/contrib/gitview/gitview.txt
@ -7,6 +7,7 @@ gitview - A GTK based repository browser for git
				@@ -7,6 +7,7 @@ gitview - A GTK based repository browser for git

 SYNOPSIS
 --------
+[verse]
 'gitview' [options] [args]

 DESCRIPTION
--- a/contrib/svn-fe/svn-fe.txt
+++ b/contrib/svn-fe/svn-fe.txt
@ -7,6 +7,7 @@ svn-fe - convert an SVN "dumpfile" to a fast-import stream
				@@ -7,6 +7,7 @@ svn-fe - convert an SVN "dumpfile" to a fast-import stream

 SYNOPSIS
 --------
+[verse]
 svnadmin dump --incremental REPO | svn-fe [url] | git fast-import

 DESCRIPTION