{"thread":{"id":"48386","subject":"[PATCH] doc: keep first level section header in upper case","startedAt":"2018-04-30T15:36:10Z","lastAt":"2018-04-30T15:36:10Z","messageCount":1,"participants":["Nguyễn Thái Ngọc Duy"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"346163","messageId":"20180430153533.13119-1-pclouds@gmail.com","threadId":"48386","inReplyTo":null,"subject":"[PATCH] doc: keep first level section header in upper case","fromName":"Nguyễn Thái Ngọc Duy","fromEmail":"pclouds@gmail.com","sentAt":"2018-04-30T15:35:33Z","receivedAt":"2018-04-30T15:36:10Z","isPatch":true,"sender":{"key":"pclouds@gmail.com","avatar":"https://avatars.githubusercontent.com/u/720?v=4"},"body":"When formatted as a man page, 1st section header is always in upper\ncase even if we write it otherwise. Make all 1st section headers\nuppercase to keep it close to the final output.\n\nThis does affect html since case is kept there, but I still think it's\na good idea to maintain a consistent style for 1st section headers.\n\nSome sections perhaps should become second sections instead, where\ncase is kept, and for better organization. I will update if anyone has\nsuggestions about this.\n\nWhile at there I also make some header more consistent (e.g. examples\nvs example) and fix a couple minor things here and there.\n\nSigned-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com>\n---\n Documentation/git-add.txt           |  4 ++--\n Documentation/git-apply.txt         |  4 ++--\n Documentation/git-branch.txt        |  4 ++--\n Documentation/git-bundle.txt        |  4 ++--\n Documentation/git-clone.txt         |  2 +-\n Documentation/git-cvsserver.txt     | 10 +++++-----\n Documentation/git-diff-index.txt    |  6 +++---\n Documentation/git-diff-tree.txt     |  2 +-\n Documentation/git-fast-export.txt   |  2 +-\n Documentation/git-fast-import.txt   | 22 +++++++++++-----------\n Documentation/git-filter-branch.txt |  6 +++---\n Documentation/git-fmt-merge-msg.txt |  4 ++--\n Documentation/git-gc.txt            |  4 ++--\n Documentation/git-grep.txt          |  2 +-\n Documentation/git-http-push.txt     |  2 +-\n Documentation/git-imap-send.txt     |  4 ++--\n Documentation/git-index-pack.txt    |  4 ++--\n Documentation/git-ls-files.txt      |  4 ++--\n Documentation/git-name-rev.txt      |  4 ++--\n Documentation/git-p4.txt            |  4 ++--\n Documentation/git-prune.txt         |  6 +++---\n Documentation/git-push.txt          |  4 ++--\n Documentation/git-read-tree.txt     |  4 ++--\n Documentation/git-receive-pack.txt  | 10 +++++-----\n Documentation/git-remote-ext.txt    | 12 ++++++------\n Documentation/git-remote.txt        |  2 +-\n Documentation/git-request-pull.txt  |  4 ++--\n Documentation/git-send-email.txt    |  4 ++--\n Documentation/git-send-pack.txt     |  2 +-\n Documentation/git-shell.txt         |  4 ++--\n Documentation/git-show-branch.txt   |  4 ++--\n Documentation/git-show-ref.txt      |  4 ++--\n Documentation/git-show.txt          |  2 +-\n Documentation/git-update-index.txt  | 20 ++++++++++----------\n Documentation/git-update-ref.txt    |  2 +-\n Documentation/git-var.txt           |  4 ++--\n Documentation/git-web--browse.txt   |  2 +-\n Documentation/gitattributes.txt     |  4 ++--\n 38 files changed, 96 insertions(+), 96 deletions(-)\n\ndiff --git a/Documentation/git-add.txt b/Documentation/git-add.txt\nindex d50fa339dc..45652fe4a6 100644\n--- a/Documentation/git-add.txt\n+++ b/Documentation/git-add.txt\n@@ -193,7 +193,7 @@ for \"git add --no-all <pathspec>...\", i.e. ignored removed files.\n \tfor command-line options).\n \n \n-Configuration\n+CONFIGURATION\n -------------\n \n The optional configuration variable `core.excludesFile` indicates a path to a\n@@ -226,7 +226,7 @@ Because this example lets the shell expand the asterisk (i.e. you are\n listing the files explicitly), it does not consider\n `subdir/git-foo.sh`.\n \n-Interactive mode\n+INTERACTIVE MODE\n ----------------\n When the command enters the interactive mode, it shows the\n output of the 'status' subcommand, and then goes into its\ndiff --git a/Documentation/git-apply.txt b/Documentation/git-apply.txt\nindex 4ebc3d3271..ad0888bfcb 100644\n--- a/Documentation/git-apply.txt\n+++ b/Documentation/git-apply.txt\n@@ -240,7 +240,7 @@ When `git apply` is used as a \"better GNU patch\", the user can pass\n the `--unsafe-paths` option to override this safety check.  This option\n has no effect when `--index` or `--cached` is in use.\n \n-Configuration\n+CONFIGURATION\n -------------\n \n apply.ignoreWhitespace::\n@@ -251,7 +251,7 @@ apply.whitespace::\n \tWhen no `--whitespace` flag is given from the command\n \tline, this configuration item is used as the default.\n \n-Submodules\n+SUBMODULES\n ----------\n If the patch contains any changes to submodules then 'git apply'\n treats these changes as follows.\ndiff --git a/Documentation/git-branch.txt b/Documentation/git-branch.txt\nindex b3084c99c1..02eccbb931 100644\n--- a/Documentation/git-branch.txt\n+++ b/Documentation/git-branch.txt\n@@ -287,7 +287,7 @@ CONFIGURATION\n `--list` is used or implied. The default is to use a pager.\n See linkgit:git-config[1].\n \n-Examples\n+EXAMPLES\n --------\n \n Start development from a known tag::\n@@ -318,7 +318,7 @@ See linkgit:git-fetch[1].\n is currently checked out) does not have all commits from the test branch.\n \n \n-Notes\n+NOTES\n -----\n \n If you are creating a branch that you want to checkout immediately, it is\ndiff --git a/Documentation/git-bundle.txt b/Documentation/git-bundle.txt\nindex 3a8120c3b3..7d6c9dcd17 100644\n--- a/Documentation/git-bundle.txt\n+++ b/Documentation/git-bundle.txt\n@@ -92,8 +92,8 @@ It is okay to err on the side of caution, causing the bundle file\n to contain objects already in the destination, as these are ignored\n when unpacking at the destination.\n \n-EXAMPLE\n--------\n+EXAMPLES\n+--------\n \n Assume you want to transfer the history from a repository R1 on machine A\n to another repository R2 on machine B.\ndiff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt\nindex 42ca7b5095..5a863f9a4c 100644\n--- a/Documentation/git-clone.txt\n+++ b/Documentation/git-clone.txt\n@@ -273,7 +273,7 @@ or `--mirror` is given)\n :git-clone: 1\n include::urls.txt[]\n \n-Examples\n+EXAMPLES\n --------\n \n * Clone from upstream:\ndiff --git a/Documentation/git-cvsserver.txt b/Documentation/git-cvsserver.txt\nindex ba90066f10..37b96c5453 100644\n--- a/Documentation/git-cvsserver.txt\n+++ b/Documentation/git-cvsserver.txt\n@@ -207,7 +207,7 @@ allowing access over SSH.\n ------\n \n [[dbbackend]]\n-Database Backend\n+DATABASE BACKEND\n ----------------\n \n 'git-cvsserver' uses one database per Git head (i.e. CVS module) to\n@@ -321,7 +321,7 @@ git-cvsserver, as described above.\n When these environment variables are set, the corresponding\n command-line arguments may not be used.\n \n-Eclipse CVS Client Notes\n+ECLIPSE CVS CLIENT NOTES\n ------------------------\n \n To get a checkout with the Eclipse CVS client:\n@@ -346,7 +346,7 @@ offer. In that case CVS_SERVER is ignored, and you will have to replace\n the cvs utility on the server with 'git-cvsserver' or manipulate your `.bashrc`\n so that calling 'cvs' effectively calls 'git-cvsserver'.\n \n-Clients known to work\n+CLIENTS KNOWN TO WORK\n ---------------------\n \n - CVS 1.12.9 on Debian\n@@ -354,7 +354,7 @@ Clients known to work\n - Eclipse 3.0, 3.1.2 on MacOSX (see Eclipse CVS Client Notes)\n - TortoiseCVS\n \n-Operations supported\n+OPERATIONS SUPPORTED\n --------------------\n \n All the operations required for normal use are supported, including\n@@ -424,7 +424,7 @@ For best consistency with 'cvs', it is probably best to override the\n defaults by setting `gitcvs.usecrlfattr` to true,\n and `gitcvs.allBinary` to \"guess\".\n \n-Dependencies\n+DEPENDENCIES\n ------------\n 'git-cvsserver' depends on DBD::SQLite.\n \ndiff --git a/Documentation/git-diff-index.txt b/Documentation/git-diff-index.txt\nindex b380677718..f4bd8155c0 100644\n--- a/Documentation/git-diff-index.txt\n+++ b/Documentation/git-diff-index.txt\n@@ -37,14 +37,14 @@ include::diff-options.txt[]\n \n include::diff-format.txt[]\n \n-Operating Modes\n+OPERATING MODES\n ---------------\n You can choose whether you want to trust the index file entirely\n (using the `--cached` flag) or ask the diff logic to show any files\n that don't match the stat state as being \"tentatively changed\".  Both\n of these operations are very useful indeed.\n \n-Cached Mode\n+CACHED MODE\n -----------\n If `--cached` is specified, it allows you to ask:\n \n@@ -77,7 +77,7 @@ So doing a `git diff-index --cached` is basically very useful when you are\n asking yourself \"what have I already marked for being committed, and\n what's the difference to a previous tree\".\n \n-Non-cached Mode\n+NON-CACHED MODE\n ---------------\n The \"non-cached\" mode takes a different approach, and is potentially\n the more useful of the two in that what it does can't be emulated with\ndiff --git a/Documentation/git-diff-tree.txt b/Documentation/git-diff-tree.txt\nindex 7870e175b7..2319b2b192 100644\n--- a/Documentation/git-diff-tree.txt\n+++ b/Documentation/git-diff-tree.txt\n@@ -116,7 +116,7 @@ include::pretty-options.txt[]\n include::pretty-formats.txt[]\n \n \n-Limiting Output\n+LIMITING OUTPUT\n ---------------\n If you're only interested in differences in a subset of files, for\n example some architecture-specific files, you might do:\ndiff --git a/Documentation/git-fast-export.txt b/Documentation/git-fast-export.txt\nindex ed57c684db..44098595dd 100644\n--- a/Documentation/git-fast-export.txt\n+++ b/Documentation/git-fast-export.txt\n@@ -202,7 +202,7 @@ smaller output, and it is usually easy to quickly confirm that there is\n no private data in the stream.\n \n \n-Limitations\n+LIMITATIONS\n -----------\n \n Since 'git fast-import' cannot tag trees, you will not be\ndiff --git a/Documentation/git-fast-import.txt b/Documentation/git-fast-import.txt\nindex 3d3d219e58..cdf696ff7f 100644\n--- a/Documentation/git-fast-import.txt\n+++ b/Documentation/git-fast-import.txt\n@@ -139,7 +139,7 @@ Performance and Compression Tuning\n fastimport.unpackLimit::\n \tSee linkgit:git-config[1]\n \n-Performance\n+PERFORMANCE\n -----------\n The design of fast-import allows it to import large projects in a minimum\n amount of memory usage and processing time.  Assuming the frontend\n@@ -155,7 +155,7 @@ faster if the source data is stored on a different drive than the\n destination Git repository (due to less IO contention).\n \n \n-Development Cost\n+DEVELOPMENT COST\n ----------------\n A typical frontend for fast-import tends to weigh in at approximately 200\n lines of Perl/Python/Ruby code.  Most developers have been able to\n@@ -165,7 +165,7 @@ an ideal situation, given that most conversion tools are throw-away\n (use once, and never look back).\n \n \n-Parallel Operation\n+PARALLEL OPERATION\n ------------------\n Like 'git push' or 'git fetch', imports handled by fast-import are safe to\n run alongside parallel `git repack -a -d` or `git gc` invocations,\n@@ -186,7 +186,7 @@ this only be used on an otherwise quiet repository.  Using --force\n is not necessary for an initial import into an empty repository.\n \n \n-Technical Discussion\n+TECHNICAL DISCUSSION\n --------------------\n fast-import tracks a set of branches in memory.  Any branch can be created\n or modified at any point during the import process by sending a\n@@ -204,7 +204,7 @@ directory also allows fast-import to run very quickly, as it does not\n need to perform any costly file update operations when switching\n between branches.\n \n-Input Format\n+INPUT FORMAT\n ------------\n With the exception of raw file data (which Git does not interpret)\n the fast-import input format is text (ASCII) based.  This text based\n@@ -1131,7 +1131,7 @@ If the `--done` command-line option or `feature done` command is\n in use, the `done` command is mandatory and marks the end of the\n stream.\n \n-Responses To Commands\n+RESPONSES TO COMMANDS\n ---------------------\n New objects written by fast-import are not available immediately.\n Most fast-import commands have no visible effect until the next\n@@ -1160,7 +1160,7 @@ To avoid deadlock, such frontends must completely consume any\n pending output from `progress`, `ls`, `get-mark`, and `cat-blob` before\n performing writes to fast-import that might block.\n \n-Crash Reports\n+CRASH REPORTS\n -------------\n If fast-import is supplied invalid input it will terminate with a\n non-zero exit status and create a crash report in the top level of\n@@ -1247,7 +1247,7 @@ An example crash:\n \tEND OF CRASH REPORT\n ====\n \n-Tips and Tricks\n+TIPS AND TRICKS\n ---------------\n The following tips and tricks have been collected from various\n users of fast-import, and are offered here as suggestions.\n@@ -1349,7 +1349,7 @@ Your users will feel better knowing how much of the data stream\n has been processed.\n \n \n-Packfile Optimization\n+PACKFILE OPTIMIZATION\n ---------------------\n When packing a blob fast-import always attempts to deltify against the last\n blob written.  Unless specifically arranged for by the frontend,\n@@ -1380,7 +1380,7 @@ to force recomputation of all deltas can significantly reduce the\n final packfile size (30-50% smaller can be quite typical).\n \n \n-Memory Utilization\n+MEMORY UTILIZATION\n ------------------\n There are a number of factors which affect how much memory fast-import\n requires to perform an import.  Like critical sections of core\n@@ -1458,7 +1458,7 @@ and lazy loading of subtrees, allows fast-import to efficiently import\n projects with 2,000+ branches and 45,114+ files in a very limited\n memory footprint (less than 2.7 MiB per active branch).\n \n-Signals\n+SIGNALS\n -------\n Sending *SIGUSR1* to the 'git fast-import' process ends the current\n packfile early, simulating a `checkpoint` command.  The impatient\ndiff --git a/Documentation/git-filter-branch.txt b/Documentation/git-filter-branch.txt\nindex b634043183..aae0253379 100644\n--- a/Documentation/git-filter-branch.txt\n+++ b/Documentation/git-filter-branch.txt\n@@ -230,7 +230,7 @@ rewrite, the exit status is `2`.  On any other error, the exit status may be\n any other non-zero value.\n \n \n-Examples\n+EXAMPLES\n --------\n \n Suppose you want to remove a file (containing confidential information\n@@ -406,7 +406,7 @@ git filter-branch --index-filter \\\n \n \n \n-Checklist for Shrinking a Repository\n+CHECKLIST FOR SHRINKING A REPOSITORY\n ------------------------------------\n \n git-filter-branch can be used to get rid of a subset of files,\n@@ -445,7 +445,7 @@ warned.\n   (or if your git-gc is not new enough to support arguments to\n   `--prune`, use `git repack -ad; git prune` instead).\n \n-Notes\n+NOTES\n -----\n \n git-filter-branch allows you to make complex shell-scripted rewrites\ndiff --git a/Documentation/git-fmt-merge-msg.txt b/Documentation/git-fmt-merge-msg.txt\nindex 44892c447e..423b6e033b 100644\n--- a/Documentation/git-fmt-merge-msg.txt\n+++ b/Documentation/git-fmt-merge-msg.txt\n@@ -57,8 +57,8 @@ merge.summary::\n \tSynonym to `merge.log`; this is deprecated and will be removed in\n \tthe future.\n \n-EXAMPLE\n--------\n+EXAMPLES\n+--------\n \n ---------\n $ git fetch origin master\ndiff --git a/Documentation/git-gc.txt b/Documentation/git-gc.txt\nindex 3126e0dd00..b61fb5751f 100644\n--- a/Documentation/git-gc.txt\n+++ b/Documentation/git-gc.txt\n@@ -84,7 +84,7 @@ be performed as well.\n \tForce `git gc` to run even if there may be another `git gc`\n \tinstance running on this repository.\n \n-Configuration\n+CONFIGURATION\n -------------\n \n The optional configuration variable `gc.reflogExpire` can be\n@@ -144,7 +144,7 @@ old a stale working tree should be before `git worktree prune` deletes\n it. Default is \"3 months ago\".\n \n \n-Notes\n+NOTES\n -----\n \n 'git gc' tries very hard not to delete objects that are referenced\ndiff --git a/Documentation/git-grep.txt b/Documentation/git-grep.txt\nindex 18b494731f..312409a607 100644\n--- a/Documentation/git-grep.txt\n+++ b/Documentation/git-grep.txt\n@@ -293,7 +293,7 @@ providing this option will cause it to die.\n For more details about the <pathspec> syntax, see the 'pathspec' entry\n in linkgit:gitglossary[7].\n \n-Examples\n+EXAMPLES\n --------\n \n `git grep 'time_t' -- '*.[ch]'`::\ndiff --git a/Documentation/git-http-push.txt b/Documentation/git-http-push.txt\nindex 2aceb6f26d..ea03a4eeb0 100644\n--- a/Documentation/git-http-push.txt\n+++ b/Documentation/git-http-push.txt\n@@ -55,7 +55,7 @@ OPTIONS\n \tThe remote refs to update.\n \n \n-Specifying the Refs\n+SPECIFYING THE REFS\n -------------------\n \n A '<ref>' specification can be either a single pattern, or a pair\ndiff --git a/Documentation/git-imap-send.txt b/Documentation/git-imap-send.txt\nindex 5d1e4c80cd..032613c420 100644\n--- a/Documentation/git-imap-send.txt\n+++ b/Documentation/git-imap-send.txt\n@@ -136,8 +136,8 @@ Using direct mode with SSL:\n .........................\n \n \n-EXAMPLE\n--------\n+EXAMPLES\n+--------\n To submit patches using GMail's IMAP interface, first, edit your ~/.gitconfig\n to specify your account settings:\n \ndiff --git a/Documentation/git-index-pack.txt b/Documentation/git-index-pack.txt\nindex 138edb47b6..d5b7560bfe 100644\n--- a/Documentation/git-index-pack.txt\n+++ b/Documentation/git-index-pack.txt\n@@ -93,8 +93,8 @@ OPTIONS\n --max-input-size=<size>::\n \tDie, if the pack is larger than <size>.\n \n-Note\n-----\n+NOTES\n+-----\n \n Once the index has been created, the list of object names is sorted\n and the SHA-1 hash of that list is printed to stdout. If --stdin was\ndiff --git a/Documentation/git-ls-files.txt b/Documentation/git-ls-files.txt\nindex 3ac3e3a77d..0f2cee7c26 100644\n--- a/Documentation/git-ls-files.txt\n+++ b/Documentation/git-ls-files.txt\n@@ -183,7 +183,7 @@ followed by the  (\"attr/<eolattr>\").\n \tFiles to show. If no files are given all files which match the other\n \tspecified criteria are shown.\n \n-Output\n+OUTPUT\n ------\n 'git ls-files' just outputs the filenames unless `--stage` is specified in\n which case it outputs:\n@@ -208,7 +208,7 @@ quoted as explained for the configuration variable `core.quotePath`\n verbatim and the line is terminated by a NUL byte.\n \n \n-Exclude Patterns\n+EXCLUDE PATTERNS\n ----------------\n \n 'git ls-files' can use a list of \"exclude patterns\" when\ndiff --git a/Documentation/git-name-rev.txt b/Documentation/git-name-rev.txt\nindex e8e68f528c..5cb0eb0855 100644\n--- a/Documentation/git-name-rev.txt\n+++ b/Documentation/git-name-rev.txt\n@@ -61,8 +61,8 @@ OPTIONS\n --always::\n \tShow uniquely abbreviated commit object as fallback.\n \n-EXAMPLE\n--------\n+EXAMPLES\n+--------\n \n Given a commit, find out where it is relative to the local refs. Say somebody\n wrote you about that fantastic commit 33db5f4d9027a10e477ccf054b2c1ab94f74c85a.\ndiff --git a/Documentation/git-p4.txt b/Documentation/git-p4.txt\nindex d8c8f11c9f..b0abe2cb07 100644\n--- a/Documentation/git-p4.txt\n+++ b/Documentation/git-p4.txt\n@@ -29,8 +29,8 @@ Submit Git changes back to p4 using 'git p4 submit'.  The command\n the updated p4 remote branch.\n \n \n-EXAMPLE\n--------\n+EXAMPLES\n+--------\n * Clone a repository:\n +\n ------------\ndiff --git a/Documentation/git-prune.txt b/Documentation/git-prune.txt\nindex a37c0af931..03552dd86f 100644\n--- a/Documentation/git-prune.txt\n+++ b/Documentation/git-prune.txt\n@@ -56,8 +56,8 @@ OPTIONS\n \treachable from any of our references, keep objects\n \treachable from listed <head>s.\n \n-EXAMPLE\n--------\n+EXAMPLES\n+--------\n \n To prune objects not used by your repository or another that\n borrows from your repository via its\n@@ -67,7 +67,7 @@ borrows from your repository via its\n $ git prune $(cd ../another && git rev-parse --all)\n ------------\n \n-Notes\n+NOTES\n -----\n \n In most cases, users will not need to call 'git prune' directly, but\ndiff --git a/Documentation/git-push.txt b/Documentation/git-push.txt\nindex 5b08302fc2..241c4ddbbe 100644\n--- a/Documentation/git-push.txt\n+++ b/Documentation/git-push.txt\n@@ -423,7 +423,7 @@ reason::\n \trefs, no explanation is needed. For a failed ref, the reason for\n \tfailure is described.\n \n-Note about fast-forwards\n+NOTE ABOUT FAST-FORWARDS\n ------------------------\n \n When an update changes a branch (or more in general, a ref) that used to\n@@ -510,7 +510,7 @@ overwrite it. In other words, \"git push --force\" is a method reserved for\n a case where you do mean to lose history.\n \n \n-Examples\n+EXAMPLES\n --------\n \n `git push`::\ndiff --git a/Documentation/git-read-tree.txt b/Documentation/git-read-tree.txt\nindex f2a07d54d6..5c70bc2878 100644\n--- a/Documentation/git-read-tree.txt\n+++ b/Documentation/git-read-tree.txt\n@@ -132,7 +132,7 @@ OPTIONS\n \tThe id of the tree object(s) to be read/merged.\n \n \n-Merging\n+MERGING\n -------\n If `-m` is specified, 'git read-tree' can perform 3 kinds of\n merge, a single tree merge if only 1 tree is given, a\n@@ -382,7 +382,7 @@ middle of doing, and when your working tree is ready (i.e. you\n have finished your work-in-progress), attempt the merge again.\n \n \n-Sparse checkout\n+SPARSE CHECKOUT\n ---------------\n \n \"Sparse checkout\" allows populating the working directory sparsely.\ndiff --git a/Documentation/git-receive-pack.txt b/Documentation/git-receive-pack.txt\nindex 86a4b32f0f..dedf97efbb 100644\n--- a/Documentation/git-receive-pack.txt\n+++ b/Documentation/git-receive-pack.txt\n@@ -41,7 +41,7 @@ OPTIONS\n <directory>::\n \tThe repository to sync into.\n \n-pre-receive Hook\n+PRE-RECEIVE HOOK\n ----------------\n Before any ref is updated, if $GIT_DIR/hooks/pre-receive file exists\n and is executable, it will be invoked once with no parameters.  The\n@@ -116,7 +116,7 @@ bail out if the update is not to be supported.\n \n See the notes on the quarantine environment below.\n \n-update Hook\n+UPDATE HOOK\n -----------\n Before each ref is updated, if $GIT_DIR/hooks/update file exists\n and is executable, it is invoked once per ref, with three parameters:\n@@ -138,7 +138,7 @@ ensure the ref will actually be updated, it is only a prerequisite.\n As such it is not a good idea to send notices (e.g. email) from\n this hook.  Consider using the post-receive hook instead.\n \n-post-receive Hook\n+POST-RECEIVE HOOK\n -----------------\n After all refs were updated (or attempted to be updated), if any\n ref update was successful, and if $GIT_DIR/hooks/post-receive\n@@ -198,7 +198,7 @@ after it was updated by 'git-receive-pack', but before the hook was able\n to evaluate it.  It is recommended that hooks rely on sha1-new\n rather than the current value of refname.\n \n-post-update Hook\n+POST-UPDATE HOOK\n ----------------\n After all other processing, if at least one ref was updated, and\n if $GIT_DIR/hooks/post-update file exists and is executable, then\n@@ -216,7 +216,7 @@ if the repository is packed and is served via a dumb transport.\n \texec git update-server-info\n \n \n-Quarantine Environment\n+QUARANTINE ENVIRONMENT\n ----------------------\n \n When `receive-pack` takes in objects, they are placed into a temporary\ndiff --git a/Documentation/git-remote-ext.txt b/Documentation/git-remote-ext.txt\nindex b25d0b5996..3fc5d94336 100644\n--- a/Documentation/git-remote-ext.txt\n+++ b/Documentation/git-remote-ext.txt\n@@ -55,14 +55,14 @@ some tunnel.\n \tthe vhost field in the git:// service request (to rest of the argument).\n \tDefault is not to send vhost in such request (if sent).\n \n-ENVIRONMENT VARIABLES:\n-----------------------\n+ENVIRONMENT VARIABLES\n+---------------------\n \n GIT_TRANSLOOP_DEBUG::\n \tIf set, prints debugging information about various reads/writes.\n \n-ENVIRONMENT VARIABLES PASSED TO COMMAND:\n-----------------------------------------\n+ENVIRONMENT VARIABLES PASSED TO COMMAND\n+---------------------------------------\n \n GIT_EXT_SERVICE::\n \tSet to long name (git-upload-pack, etc...) of service helper needs\n@@ -73,8 +73,8 @@ GIT_EXT_SERVICE_NOPREFIX::\n \tto invoke.\n \n \n-EXAMPLES:\n----------\n+EXAMPLES\n+--------\n This remote helper is transparently used by Git when\n you use commands such as \"git fetch <URL>\", \"git clone <URL>\",\n , \"git push <URL>\" or \"git remote add <nick> <URL>\", where <URL>\ndiff --git a/Documentation/git-remote.txt b/Documentation/git-remote.txt\nindex 4feddc0293..595948da53 100644\n--- a/Documentation/git-remote.txt\n+++ b/Documentation/git-remote.txt\n@@ -203,7 +203,7 @@ The remote configuration is achieved using the `remote.origin.url` and\n `remote.origin.fetch` configuration variables.  (See\n linkgit:git-config[1]).\n \n-Examples\n+EXAMPLES\n --------\n \n * Add a new remote, fetch, and check out a branch from it\ndiff --git a/Documentation/git-request-pull.txt b/Documentation/git-request-pull.txt\nindex c32cb0bea1..4d4392d0f8 100644\n--- a/Documentation/git-request-pull.txt\n+++ b/Documentation/git-request-pull.txt\n@@ -46,8 +46,8 @@ ref that is different from the ref you have locally, you can use the\n its remote name.\n \n \n-EXAMPLE\n--------\n+EXAMPLES\n+--------\n \n Imagine that you built your work on your `master` branch on top of\n the `v1.0` release, and want it to be integrated to the project.\ndiff --git a/Documentation/git-send-email.txt b/Documentation/git-send-email.txt\nindex 60cf96f4c1..464c15b94f 100644\n--- a/Documentation/git-send-email.txt\n+++ b/Documentation/git-send-email.txt\n@@ -458,8 +458,8 @@ sendemail.confirm::\n \tone of 'always', 'never', 'cc', 'compose', or 'auto'. See `--confirm`\n \tin the previous section for the meaning of these values.\n \n-EXAMPLE\n--------\n+EXAMPLES\n+--------\n Use gmail as the smtp server\n ~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n To use 'git send-email' to send your patches through the GMail SMTP server,\ndiff --git a/Documentation/git-send-pack.txt b/Documentation/git-send-pack.txt\nindex f51c64939b..44fd146b91 100644\n--- a/Documentation/git-send-pack.txt\n+++ b/Documentation/git-send-pack.txt\n@@ -99,7 +99,7 @@ be in a separate packet, and the list must end with a flush packet.\n \tThe remote refs to update.\n \n \n-Specifying the Refs\n+SPECIFYING THE REFS\n -------------------\n \n There are three ways to specify which refs to update on the\ndiff --git a/Documentation/git-shell.txt b/Documentation/git-shell.txt\nindex 54cf2560be..11361f33e9 100644\n--- a/Documentation/git-shell.txt\n+++ b/Documentation/git-shell.txt\n@@ -62,8 +62,8 @@ permissions.\n If a `no-interactive-login` command exists, then it is run and the\n interactive shell is aborted.\n \n-EXAMPLE\n--------\n+EXAMPLES\n+--------\n \n To disable interactive logins, displaying a greeting instead:\n \ndiff --git a/Documentation/git-show-branch.txt b/Documentation/git-show-branch.txt\nindex 7818e0f098..262db049d7 100644\n--- a/Documentation/git-show-branch.txt\n+++ b/Documentation/git-show-branch.txt\n@@ -173,8 +173,8 @@ The \"fixes\" branch adds one commit \"Introduce \"reset type\" flag to\n The current branch is \"master\".\n \n \n-EXAMPLE\n--------\n+EXAMPLES\n+--------\n \n If you keep your primary branches immediately under\n `refs/heads`, and topic branches in subdirectories of\ndiff --git a/Documentation/git-show-ref.txt b/Documentation/git-show-ref.txt\nindex c0aa871c9e..d28e6154c6 100644\n--- a/Documentation/git-show-ref.txt\n+++ b/Documentation/git-show-ref.txt\n@@ -120,8 +120,8 @@ $ git show-ref --heads --hash\n ...\n -----------------------------------------------------------------------------\n \n-EXAMPLE\n--------\n+EXAMPLES\n+--------\n \n To show all references called \"master\", whether tags or heads or anything\n else, and regardless of how deep in the reference naming hierarchy they are,\ndiff --git a/Documentation/git-show.txt b/Documentation/git-show.txt\nindex e73ef54017..0e1695df35 100644\n--- a/Documentation/git-show.txt\n+++ b/Documentation/git-show.txt\n@@ -77,7 +77,7 @@ EXAMPLES\n \tConcatenates the contents of said Makefiles in the head\n \tof the branch `master`.\n \n-Discussion\n+DISCUSSION\n ----------\n \n include::i18n.txt[]\ndiff --git a/Documentation/git-update-index.txt b/Documentation/git-update-index.txt\nindex 3897a59ee9..4e8e762e68 100644\n--- a/Documentation/git-update-index.txt\n+++ b/Documentation/git-update-index.txt\n@@ -228,7 +228,7 @@ will remove the intended effect of the option.\n \tcleaner names.\n \tThe same applies to directories ending '/' and paths with '//'\n \n-Using --refresh\n+USING --REFRESH\n ---------------\n `--refresh` does not calculate a new sha1 file or bring the index\n up to date for mode/content changes. But what it *does* do is to\n@@ -239,7 +239,7 @@ the stat entry is out of date.\n For example, you'd want to do this after doing a 'git read-tree', to link\n up the stat index details with the proper files.\n \n-Using --cacheinfo or --info-only\n+USING --CACHEINFO OR --INFO-ONLY\n --------------------------------\n `--cacheinfo` is used to register a file that is not in the\n current working directory.  This is useful for minimum-checkout\n@@ -261,7 +261,7 @@ useful when the file is available, but you do not wish to update the\n object database.\n \n \n-Using --index-info\n+USING --INDEX-INFO\n ------------------\n \n `--index-info` is a more powerful mechanism that lets you feed\n@@ -317,7 +317,7 @@ $ git ls-files -s\n ------------\n \n \n-Using ``assume unchanged'' bit\n+USING ``ASSUME UNCHANGED'' BIT\n ------------------------------\n \n Many operations in Git depend on your filesystem to have an\n@@ -350,7 +350,7 @@ the index (use `git update-index --really-refresh` if you want\n to mark them as \"assume unchanged\").\n \n \n-Examples\n+EXAMPLES\n --------\n To update and refresh only the files already checked out:\n \n@@ -387,7 +387,7 @@ M foo.c\n <9> now it checks with lstat(2) and finds it has been changed.\n \n \n-Skip-worktree bit\n+SKIP-WORKTREE BIT\n -----------------\n \n Skip-worktree bit can be defined in one (long) sentence: When reading\n@@ -407,7 +407,7 @@ Although this bit looks similar to assume-unchanged bit, its goal is\n different from assume-unchanged bit's. Skip-worktree also takes\n precedence over assume-unchanged bit when both are set.\n \n-Split index\n+SPLIT INDEX\n -----------\n \n This mode is designed for repositories with very large indexes, and\n@@ -432,7 +432,7 @@ To avoid deleting a shared index file that is still used, its\n modification time is updated to the current time everytime a new split\n index based on the shared index file is either created or read from.\n \n-Untracked cache\n+UNTRACKED CACHE\n ---------------\n \n This cache is meant to speed up commands that involve determining\n@@ -490,7 +490,7 @@ As with the bug described above the solution is to one-off do a \"git\n status\" run with `core.untrackedCache=false` to flush out the leftover\n bad data.\n \n-File System Monitor\n+FILE SYSTEM MONITOR\n -------------------\n \n This feature is intended to speed up git operations for repos that have\n@@ -518,7 +518,7 @@ file system monitor is added to or removed from the index the next time\n a command reads the index. When `--[no-]fsmonitor` are used, the file\n system monitor is immediately added to or removed from the index.\n \n-Configuration\n+CONFIGURATION\n -------------\n \n The command honors `core.filemode` configuration variable.  If\ndiff --git a/Documentation/git-update-ref.txt b/Documentation/git-update-ref.txt\nindex 969bfab2ab..bc8fdfd469 100644\n--- a/Documentation/git-update-ref.txt\n+++ b/Documentation/git-update-ref.txt\n@@ -120,7 +120,7 @@ modifications are performed.  Note that while each individual\n <ref> is updated or deleted atomically, a concurrent reader may\n still see a subset of the modifications.\n \n-Logging Updates\n+LOGGING UPDATES\n ---------------\n If config parameter \"core.logAllRefUpdates\" is true and the ref is one under\n \"refs/heads/\", \"refs/remotes/\", \"refs/notes/\", or the symbolic ref HEAD; or\ndiff --git a/Documentation/git-var.txt b/Documentation/git-var.txt\nindex 44ff9541df..6072f936ab 100644\n--- a/Documentation/git-var.txt\n+++ b/Documentation/git-var.txt\n@@ -23,14 +23,14 @@ OPTIONS\n \tas well. (However, the configuration variables listing functionality\n \tis deprecated in favor of `git config -l`.)\n \n-EXAMPLE\n+EXAMPLES\n --------\n \t$ git var GIT_AUTHOR_IDENT\n \tEric W. Biederman <ebiederm@lnxi.com> 1121223278 -0600\n \n \n VARIABLES\n-----------\n+---------\n GIT_AUTHOR_IDENT::\n     The author of a piece of code.\n \ndiff --git a/Documentation/git-web--browse.txt b/Documentation/git-web--browse.txt\nindex 2d6b09a43c..a4ec25b450 100644\n--- a/Documentation/git-web--browse.txt\n+++ b/Documentation/git-web--browse.txt\n@@ -84,7 +84,7 @@ variable exists then 'git web{litdd}browse' will treat the specified tool\n as a custom command and will use a shell eval to run the command with\n the URLs passed as arguments.\n \n-Note about konqueror\n+NOTE ABOUT KONQUEROR\n --------------------\n \n When 'konqueror' is specified by a command-line option or a\ndiff --git a/Documentation/gitattributes.txt b/Documentation/gitattributes.txt\nindex 1094fe2b5b..ee95d8531d 100644\n--- a/Documentation/gitattributes.txt\n+++ b/Documentation/gitattributes.txt\n@@ -1141,8 +1141,8 @@ to:\n ------------\n \n \n-EXAMPLE\n--------\n+EXAMPLES\n+--------\n \n If you have these three `gitattributes` file:\n \n-- \n2.17.0.705.g3525833791\n\n"}]}