{"thread":{"id":"817","subject":"documentation polish","startedAt":"2005-06-03T07:13:19Z","lastAt":"2005-06-03T07:26:37Z","messageCount":2,"participants":["Sebastian Kuzminsky","Petr Baudis"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"4474","messageId":"E1De6Mp-0001AD-OQ@highlab.com","threadId":"817","inReplyTo":null,"subject":"documentation polish","fromName":"Sebastian Kuzminsky","fromEmail":"seb@highlab.com","sentAt":"2005-06-03T07:13:19Z","receivedAt":"2005-06-03T07:13:19Z","isPatch":false,"sender":{"key":"seb@highlab.com","avatar":"https://gravatar.com/avatar/f7ddd092ba3cf6999434f4d0d2f4b90fd174c2c3851617e8cffc0a2fee47becc?d=mp&s=160"},"body":"This large but repetitive patch polishes the docs a bit.  It does not\ntouch any files outside the Documentation directory.\n\n\nIt's against cogito-0.11.1, I can split it out into separate patches\nfor git and cogito if people want - let me know.\n\n\nHere's the change list:\n\n    Added a txt target to Documentation/Makefile, to explicitly make\n    cogito.txt and the cg-*.txt files.\n\n    Fixed what looked like a typo in Documentation/git-commit-tree.txt\n\n    Fixed an incorrect manpage section in Documentation/make-cg-asciidoc\n\n    The git and cogito manpages have links to other manpages, and\n    those links are often missing the section, (1) or (7).  Fixed that\n    everywhere it seemed appropriate.\n\n\n\n\n Makefile                      |    4 +\n git-apply-patch-script.txt    |    2 \n git-cat-file.txt              |    2 \n git-check-files.txt           |    4 -\n git-checkout-cache.txt        |    2 \n git-commit-tree.txt           |    6 +-\n git-convert-cache.txt         |    2 \n git-diff-cache.txt            |    2 \n git-diff-files.txt            |    2 \n git-diff-helper.txt           |    4 -\n git-diff-tree.txt             |    2 \n git-export.txt                |    2 \n git-fsck-cache.txt            |    2 \n git-http-pull.txt             |    2 \n git-init-db.txt               |    2 \n git-local-pull.txt            |    2 \n git-ls-files.txt              |    2 \n git-ls-tree.txt               |    2 \n git-merge-base.txt            |    2 \n git-merge-cache.txt           |    2 \n git-merge-one-file-script.txt |    2 \n git-mkdelta.txt               |    2 \n git-mktag.txt                 |    2 \n git-prune-script.txt          |    2 \n git-pull-script.txt           |    2 \n git-read-tree.txt             |    4 -\n git-resolve-script.txt        |    2 \n git-rev-list.txt              |    2 \n git-rev-tree.txt              |    2 \n git-rpull.txt                 |    2 \n git-rpush.txt                 |    2 \n git-tag-script.txt            |    2 \n git-tar-tree.txt              |    2 \n git-unpack-file.txt           |    2 \n git-update-cache.txt          |    2 \n git-write-blob.txt            |    2 \n git-write-tree.txt            |    2 \n git.txt                       |   86 +++++++++++++++++++++---------------------\n make-cg-asciidoc              |    4 -\n make-cogito-asciidoc          |   19 ++++++---\n 40 files changed, 102 insertions(+), 93 deletions(-)\n\n\ndiff --git a/Documentation/Makefile b/Documentation/Makefile\n--- a/Documentation/Makefile\n+++ b/Documentation/Makefile\n@@ -18,7 +18,9 @@ DOC_MAN7=$(patsubst %.txt,%.7,$(MAN7_TXT\n # yourself - yes, all 6 characters of it!\n #\n \n-all: html man\n+all: txt html man\n+\n+txt: $(MAN1_TXT) $(MAN7_TXT)\n \n html: $(DOC_HTML)\n \ndiff --git a/Documentation/git-apply-patch-script.txt b/Documentation/git-apply-patch-script.txt\n--- a/Documentation/git-apply-patch-script.txt\n+++ b/Documentation/git-apply-patch-script.txt\n@@ -28,5 +28,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-cat-file.txt b/Documentation/git-cat-file.txt\n--- a/Documentation/git-cat-file.txt\n+++ b/Documentation/git-cat-file.txt\n@@ -51,5 +51,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-check-files.txt b/Documentation/git-check-files.txt\n--- a/Documentation/git-check-files.txt\n+++ b/Documentation/git-check-files.txt\n@@ -33,7 +33,7 @@ up-to-date.\n \n See Also\n --------\n-link:git-update-cache.html[git-update-cache]\n+link:git-update-cache.html[git-update-cache(1)]\n \n \n Author\n@@ -46,5 +46,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-checkout-cache.txt b/Documentation/git-checkout-cache.txt\n--- a/Documentation/git-checkout-cache.txt\n+++ b/Documentation/git-checkout-cache.txt\n@@ -102,5 +102,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-commit-tree.txt b/Documentation/git-commit-tree.txt\n--- a/Documentation/git-commit-tree.txt\n+++ b/Documentation/git-commit-tree.txt\n@@ -9,7 +9,7 @@ git-commit-tree - Creates a new commit o\n \n SYNOPSIS\n --------\n-'git-commit-tree' <tree> [-p <parent commit>]\\   < changelog\n+'git-commit-tree' <tree> [-p <parent commit>]  < changelog\n \n DESCRIPTION\n -----------\n@@ -71,7 +71,7 @@ You don't exist. Go away!::\n \n See Also\n --------\n-link:git-write-tree.html[git-write-tree]\n+link:git-write-tree.html[git-write-tree(1)]\n \n \n Author\n@@ -84,5 +84,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-convert-cache.txt b/Documentation/git-convert-cache.txt\n--- a/Documentation/git-convert-cache.txt\n+++ b/Documentation/git-convert-cache.txt\n@@ -26,5 +26,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-diff-cache.txt b/Documentation/git-diff-cache.txt\n--- a/Documentation/git-diff-cache.txt\n+++ b/Documentation/git-diff-cache.txt\n@@ -163,5 +163,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-diff-files.txt b/Documentation/git-diff-files.txt\n--- a/Documentation/git-diff-files.txt\n+++ b/Documentation/git-diff-files.txt\n@@ -71,5 +71,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-diff-helper.txt b/Documentation/git-diff-helper.txt\n--- a/Documentation/git-diff-helper.txt\n+++ b/Documentation/git-diff-helper.txt\n@@ -27,7 +27,7 @@ OPTIONS\n \n See Also\n --------\n-The section on generating patches in link:git-diff-cache.html[git-diff-cache]\n+The section on generating patches in link:git-diff-cache.html[git-diff-cache(1)]\n \n \n Author\n@@ -41,5 +41,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-diff-tree.txt b/Documentation/git-diff-tree.txt\n--- a/Documentation/git-diff-tree.txt\n+++ b/Documentation/git-diff-tree.txt\n@@ -153,5 +153,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-export.txt b/Documentation/git-export.txt\n--- a/Documentation/git-export.txt\n+++ b/Documentation/git-export.txt\n@@ -27,5 +27,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-fsck-cache.txt b/Documentation/git-fsck-cache.txt\n--- a/Documentation/git-fsck-cache.txt\n+++ b/Documentation/git-fsck-cache.txt\n@@ -124,5 +124,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-http-pull.txt b/Documentation/git-http-pull.txt\n--- a/Documentation/git-http-pull.txt\n+++ b/Documentation/git-http-pull.txt\n@@ -35,5 +35,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-init-db.txt b/Documentation/git-init-db.txt\n--- a/Documentation/git-init-db.txt\n+++ b/Documentation/git-init-db.txt\n@@ -36,5 +36,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-local-pull.txt b/Documentation/git-local-pull.txt\n--- a/Documentation/git-local-pull.txt\n+++ b/Documentation/git-local-pull.txt\n@@ -36,5 +36,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-ls-files.txt b/Documentation/git-ls-files.txt\n--- a/Documentation/git-ls-files.txt\n+++ b/Documentation/git-ls-files.txt\n@@ -104,5 +104,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-ls-tree.txt b/Documentation/git-ls-tree.txt\n--- a/Documentation/git-ls-tree.txt\n+++ b/Documentation/git-ls-tree.txt\n@@ -51,5 +51,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-merge-base.txt b/Documentation/git-merge-base.txt\n--- a/Documentation/git-merge-base.txt\n+++ b/Documentation/git-merge-base.txt\n@@ -30,5 +30,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-merge-cache.txt b/Documentation/git-merge-cache.txt\n--- a/Documentation/git-merge-cache.txt\n+++ b/Documentation/git-merge-cache.txt\n@@ -80,5 +80,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-merge-one-file-script.txt b/Documentation/git-merge-one-file-script.txt\n--- a/Documentation/git-merge-one-file-script.txt\n+++ b/Documentation/git-merge-one-file-script.txt\n@@ -26,5 +26,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-mkdelta.txt b/Documentation/git-mkdelta.txt\n--- a/Documentation/git-mkdelta.txt\n+++ b/Documentation/git-mkdelta.txt\n@@ -41,5 +41,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-mktag.txt b/Documentation/git-mktag.txt\n--- a/Documentation/git-mktag.txt\n+++ b/Documentation/git-mktag.txt\n@@ -44,5 +44,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-prune-script.txt b/Documentation/git-prune-script.txt\n--- a/Documentation/git-prune-script.txt\n+++ b/Documentation/git-prune-script.txt\n@@ -28,5 +28,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-pull-script.txt b/Documentation/git-pull-script.txt\n--- a/Documentation/git-pull-script.txt\n+++ b/Documentation/git-pull-script.txt\n@@ -27,5 +27,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-read-tree.txt b/Documentation/git-read-tree.txt\n--- a/Documentation/git-read-tree.txt\n+++ b/Documentation/git-read-tree.txt\n@@ -135,7 +135,7 @@ and never used.\n \n See Also\n --------\n-link:git-write-tree.html[git-write-tree]; link:git-ls-files.html[git-ls-files]\n+link:git-write-tree.html[git-write-tree(1)]; link:git-ls-files.html[git-ls-files(1)]\n \n \n Author\n@@ -148,5 +148,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-resolve-script.txt b/Documentation/git-resolve-script.txt\n--- a/Documentation/git-resolve-script.txt\n+++ b/Documentation/git-resolve-script.txt\n@@ -26,5 +26,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-rev-list.txt b/Documentation/git-rev-list.txt\n--- a/Documentation/git-rev-list.txt\n+++ b/Documentation/git-rev-list.txt\n@@ -28,5 +28,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-rev-tree.txt b/Documentation/git-rev-tree.txt\n--- a/Documentation/git-rev-tree.txt\n+++ b/Documentation/git-rev-tree.txt\n@@ -84,5 +84,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-rpull.txt b/Documentation/git-rpull.txt\n--- a/Documentation/git-rpull.txt\n+++ b/Documentation/git-rpull.txt\n@@ -39,5 +39,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-rpush.txt b/Documentation/git-rpush.txt\n--- a/Documentation/git-rpush.txt\n+++ b/Documentation/git-rpush.txt\n@@ -26,5 +26,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-tag-script.txt b/Documentation/git-tag-script.txt\n--- a/Documentation/git-tag-script.txt\n+++ b/Documentation/git-tag-script.txt\n@@ -28,5 +28,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-tar-tree.txt b/Documentation/git-tar-tree.txt\n--- a/Documentation/git-tar-tree.txt\n+++ b/Documentation/git-tar-tree.txt\n@@ -28,5 +28,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-unpack-file.txt b/Documentation/git-unpack-file.txt\n--- a/Documentation/git-unpack-file.txt\n+++ b/Documentation/git-unpack-file.txt\n@@ -33,5 +33,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-update-cache.txt b/Documentation/git-update-cache.txt\n--- a/Documentation/git-update-cache.txt\n+++ b/Documentation/git-update-cache.txt\n@@ -104,5 +104,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-write-blob.txt b/Documentation/git-write-blob.txt\n--- a/Documentation/git-write-blob.txt\n+++ b/Documentation/git-write-blob.txt\n@@ -29,5 +29,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git-write-tree.txt b/Documentation/git-write-tree.txt\n--- a/Documentation/git-write-tree.txt\n+++ b/Documentation/git-write-tree.txt\n@@ -48,5 +48,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/git.txt b/Documentation/git.txt\n--- a/Documentation/git.txt\n+++ b/Documentation/git.txt\n@@ -18,8 +18,8 @@ This is reference information for the co\n \n The Discussion section below contains much useful definition and\n clarification info - read that first.  And of the commands, I suggest\n-reading link:git-update-cache.html[git-update-cache] and\n-link:git-read-tree.html[git-read-tree] first - I wish I had!\n+reading link:git-update-cache.html[git-update-cache(1)] and\n+link:git-read-tree.html[git-read-tree(1)] first - I wish I had!\n \n David Greaves <david@dgreaves.com>\n 08/05/05\n@@ -39,78 +39,78 @@ SCMs layered over git.\n \n Manipulation commands\n ~~~~~~~~~~~~~~~~~~~~~\n-link:git-checkout-cache.html[git-checkout-cache]::\n+link:git-checkout-cache.html[git-checkout-cache(1)]::\n \tCopy files from the cache to the working directory\n \n-link:git-commit-tree.html[git-commit-tree]::\n+link:git-commit-tree.html[git-commit-tree(1)]::\n \tCreates a new commit object\n \n-link:git-init-db.html[git-init-db]::\n+link:git-init-db.html[git-init-db(1)]::\n \tCreates an empty git object database\n \n-link:git-merge-base.html[git-merge-base]::\n+link:git-merge-base.html[git-merge-base(1)]::\n \tFinds as good a common ancestor as possible for a merge\n \n-link:git-mkdelta.html[git-mkdelta]::\n+link:git-mkdelta.html[git-mkdelta(1)]::\n \tCreates a delta object\n \n-link:git-mktag.html[git-mktag]::\n+link:git-mktag.html[git-mktag(1)]::\n \tCreates a tag object\n \n-link:git-read-tree.html[git-read-tree]::\n+link:git-read-tree.html[git-read-tree(1)]::\n \tReads tree information into the directory cache\n \n-link:git-update-cache.html[git-update-cache]::\n+link:git-update-cache.html[git-update-cache(1)]::\n \tModifies the index or directory cache\n \n-link:git-write-blob.html[git-write-blob]::\n+link:git-write-blob.html[git-write-blob(1)]::\n \tCreates a blob from a file\n \n-link:git-write-tree.html[git-write-tree]::\n+link:git-write-tree.html[git-write-tree(1)]::\n \tCreates a tree from the current cache\n \n Interrogation commands\n ~~~~~~~~~~~~~~~~~~~~~~\n-link:git-cat-file.html[git-cat-file]::\n+link:git-cat-file.html[git-cat-file(1)]::\n \tProvide content or type information for repository objects\n \n-link:git-check-files.html[git-check-files]::\n+link:git-check-files.html[git-check-files(1)]::\n \tVerify a list of files are up-to-date\n \n-link:git-diff-cache.html[git-diff-cache]::\n+link:git-diff-cache.html[git-diff-cache(1)]::\n \tCompares content and mode of blobs between the cache and repository\n \n-link:git-diff-files.html[git-diff-files]::\n+link:git-diff-files.html[git-diff-files(1)]::\n \tCompares files in the working tree and the cache\n \n-link:git-diff-tree.html[git-diff-tree]::\n+link:git-diff-tree.html[git-diff-tree(1)]::\n \tCompares the content and mode of blobs found via two tree objects\n \n-link:git-export.html[git-export]::\n+link:git-export.html[git-export(1)]::\n \tExports each commit and a diff against each of its parents\n \n-link:git-fsck-cache.html[git-fsck-cache]::\n+link:git-fsck-cache.html[git-fsck-cache(1)]::\n \tVerifies the connectivity and validity of the objects in the database\n \n-link:git-ls-files.html[git-ls-files]::\n+link:git-ls-files.html[git-ls-files(1)]::\n \tInformation about files in the cache/working directory\n \n-link:git-ls-tree.html[git-ls-tree]::\n+link:git-ls-tree.html[git-ls-tree(1)]::\n \tDisplays a tree object in human readable form\n \n-link:git-merge-cache.html[git-merge-cache]::\n+link:git-merge-cache.html[git-merge-cache(1)]::\n \tRuns a merge for files needing merging\n \n-link:git-rev-list.html[git-rev-list]::\n+link:git-rev-list.html[git-rev-list(1)]::\n \tLists commit objects in reverse chronological order\n \n-link:git-rev-tree.html[git-rev-tree]::\n+link:git-rev-tree.html[git-rev-tree(1)]::\n \tProvides the revision tree for one or more commits\n \n-link:git-tar-tree.html[git-tar-tree]::\n+link:git-tar-tree.html[git-tar-tree(1)]::\n \tCreates a tar archive of the files in the named tree\n \n-link:git-unpack-file.html[git-unpack-file]::\n+link:git-unpack-file.html[git-unpack-file(1)]::\n \tCreates a temporary file with a blob's contents\n \n The interrogate commands may create files - and you can force them to\n@@ -121,42 +121,42 @@ Ancilliary Commands\n -------------------\n Manipulators:\n \n-link:git-apply-patch-script.html[git-apply-patch-script]::\n+link:git-apply-patch-script.html[git-apply-patch-script(1)]::\n \tSample script to apply the diffs from git-diff-*\n \n-link:git-convert-cache.html[git-convert-cache]::\n+link:git-convert-cache.html[git-convert-cache(1)]::\n \tConverts old-style GIT repository\n \n-link:git-http-pull.html[git-http-pull]::\n+link:git-http-pull.html[git-http-pull(1)]::\n \tDownloads a remote GIT repository via HTTP\n \n-link:git-local-pull.html[git-local-pull]::\n+link:git-local-pull.html[git-local-pull(1)]::\n \tDuplicates another GIT repository on a local system\n \n-link:git-merge-one-file-script.html[git-merge-one-file-script]::\n+link:git-merge-one-file-script.html[git-merge-one-file-script(1)]::\n \tThe standard helper program to use with \"git-merge-cache\"\n \n-link:git-pull-script.html[git-pull-script]::\n+link:git-pull-script.html[git-pull-script(1)]::\n \tScript used by Linus to pull and merge a remote repository\n \n-link:git-prune-script.html[git-prune-script]::\n+link:git-prune-script.html[git-prune-script(1)]::\n \tPrunes all unreachable objects from the object database\n \n-link:git-resolve-script.html[git-resolve-script]::\n+link:git-resolve-script.html[git-resolve-script(1)]::\n \tScript used to merge two trees\n \n-link:git-tag-script.html[git-tag-script]::\n+link:git-tag-script.html[git-tag-script(1)]::\n \tAn example script to create a tag object signed with GPG\n \n-link:git-rpull.html[git-rpull]::\n+link:git-rpull.html[git-rpull(1)]::\n \tPulls from a remote repository over ssh connection\n \n Interogators:\n \n-link:git-diff-helper.html[git-diff-helper]::\n+link:git-diff-helper.html[git-diff-helper(1)]::\n \tGenerates patch format output for git-diff-*\n \n-link:git-rpush.html[git-rpush]::\n+link:git-rpush.html[git-rpush(1)]::\n \tHelper \"server-side\" program used by git-rpull\n \n \n@@ -279,16 +279,16 @@ git Commits\n 'GIT_AUTHOR_DATE'::\n 'GIT_COMMITTER_NAME'::\n 'GIT_COMMITTER_EMAIL'::\n-\tsee link:git-commit-tree.html[git-commit-tree]\n+\tsee link:git-commit-tree.html[git-commit-tree(1)]\n \n git Diffs\n ~~~~~~~~~\n 'GIT_DIFF_OPTS'::\n 'GIT_EXTERNAL_DIFF'::\n \tsee the \"generating patches\" section in :\n-\tlink:git-diff-cache.html[git-diff-cache];\n-\tlink:git-diff-files.html[git-diff-files];\n-\tlink:git-diff-tree.html[git-diff-tree]\n+\tlink:git-diff-cache.html[git-diff-cache(1)];\n+\tlink:git-diff-files.html[git-diff-files(1)];\n+\tlink:git-diff-tree.html[git-diff-tree(1)]\n \n Discussion\n ----------\n@@ -304,5 +304,5 @@ Documentation by David Greaves, Junio C \n \n GIT\n ---\n-Part of the link:git.html[git] suite\n+Part of the link:git.html[git(7)] suite\n \ndiff --git a/Documentation/make-cg-asciidoc b/Documentation/make-cg-asciidoc\n--- a/Documentation/make-cg-asciidoc\n+++ b/Documentation/make-cg-asciidoc\n@@ -40,7 +40,7 @@ CAPTION=$(echo \"$HEADER\" | head -n 1 | t\n # were referenced as \"`cg-command`\". This way references from cg-* combos in\n # code listings will be ignored.\n BODY=$(echo \"$HEADER\" | sed '0,/^$/d' \\\n-\t\t      | sed 's/`\\(cg-[a-z-]\\+\\)`/link:\\1.html[\\1]/')\n+\t\t      | sed 's/`\\(cg-[a-z-]\\+\\)`/link:\\1.html[\\1(1)]/')\n \n DESCRIPTION=\n OPTIONS=\n@@ -109,5 +109,5 @@ $COPYRIGHT\n SEE ALSO\n --------\n $COMMAND command is part of link:cogito.html[cogito(7)],\n-a toolkit for managing link:git.html[git(1)] trees.\n+a toolkit for managing link:git.html[git(7)] trees.\n __END__\ndiff --git a/Documentation/make-cogito-asciidoc b/Documentation/make-cogito-asciidoc\n--- a/Documentation/make-cogito-asciidoc\n+++ b/Documentation/make-cogito-asciidoc\n@@ -11,7 +11,14 @@ HELPER_COMMANDS=\"$(ls ../cg-X*) $(ls ../\n link()\n {\n \tcommand=\"$1\"\n-\techo \"link:$command.html['$command']\"\n+\n+        if [ ! -z \"$2\" ]; then\n+            section=\"($2)\"\n+        else\n+            section=\"\"\n+        fi\n+\n+\techo \"link:$command.html['$command$section']\"\n }\n \n # Print description list entry.\n@@ -62,7 +69,7 @@ storage system. Amongst some of the note\n for branching, tagging and multiple backends for distributing repositories\n (local files, rsync, HTTP, ssh).\n \n-'Cogito' is implemented as a series of 'bash(1)' scripts on top of $(link git)\n+'Cogito' is implemented as a series of 'bash(1)' scripts on top of $(link git 7)\n (a content-tracking filesystem) with the goal of providing an interface for\n working with the 'GIT' database in a manner similar to other SCM tools (like\n 'CVS', 'BitKeeper' or 'Monotone').\n@@ -107,21 +114,21 @@ $(print_command_listing $HELPER_COMMANDS\n Command Identifiers\n -------------------\n BRANCH_NAME::\n-\tIndicates a branch name added with the $(link cg-branch-add) command.\n+\tIndicates a branch name added with the $(link cg-branch-add 1) command.\n \n COMMAND::\n \tIndicates a 'Cogito' command. The \\`cg-\\` prefix is optional.\n \n LOCATION::\n-\tIndicates a local file path or a URI. See $(link cg-branch-add) for a\n+\tIndicates a local file path or a URI. See $(link cg-branch-add 1) for a\n \tlist of supported URI schemes.\n \n COMMIT_ID, FROM_ID, TO_ID, BASE_COMMIT::\n \tIndicates an ID resolving to a commit. The following expressions can\n \tbe used interchangably as IDs:\n \t- empty string, 'this' or 'HEAD' (current HEAD)\n-\t- branch name (as registered with $(link cg-branch-add))\n-\t- tag name (as registered with $(link cg-tag))\n+\t- branch name (as registered with $(link cg-branch-add 1))\n+\t- tag name (as registered with $(link cg-tag 1))\n \t- shortcut object hash (shorted unambiguous hash lead)\n \t- commit object hash (as returned by 'commit-id')\n \t- tree object hash (as returned by 'tree-id')\n\n\n-- \nSebastian Kuzminsky\n"},{"id":"4475","messageId":"20050603072637.GB16619@pasky.ji.cz","threadId":"817","inReplyTo":"E1De6Mp-0001AD-OQ@highlab.com","subject":"Re: documentation polish","fromName":"Petr Baudis","fromEmail":"pasky@ucw.cz","sentAt":"2005-06-03T07:26:37Z","receivedAt":"2005-06-03T07:26:37Z","isPatch":false,"sender":{"key":"pasky@ucw.cz","avatar":"https://avatars.githubusercontent.com/u/18439?v=4"},"body":"Dear diary, on Fri, Jun 03, 2005 at 09:13:19AM CEST, I got a letter\nwhere Sebastian Kuzminsky <seb@highlab.com> told me that...\n> This large but repetitive patch polishes the docs a bit.  It does not\n> touch any files outside the Documentation directory.\n> \n> \n> It's against cogito-0.11.1, I can split it out into separate patches\n> for git and cogito if people want - let me know.\n\nThat'd be really great. :-)\n\nThanks,\n\n-- \n\t\t\t\tPetr \"Pasky\" Baudis\nStuff: http://pasky.or.cz/\nC++: an octopus made by nailing extra legs onto a dog. -- Steve Taylor\n"}]}