{"thread":{"id":"23124","subject":"[PATCH 0/4] Various unrelated documentation fixes","startedAt":"2010-03-21T17:30:15Z","lastAt":"2010-03-21T17:30:19Z","messageCount":5,"participants":["Michael J Gruber"],"isPatch":true,"patchVersion":1,"patchTotal":4},"messages":[{"id":"137459","messageId":"cover.1269192495.git.git@drmicha.warpmail.net","threadId":"23124","inReplyTo":null,"subject":"[PATCH 0/4] Various unrelated documentation fixes","fromName":"Michael J Gruber","fromEmail":"git@drmicha.warpmail.net","sentAt":"2010-03-21T17:30:15Z","receivedAt":"2010-03-21T17:30:15Z","isPatch":true,"sender":{"key":"git@grubix.eu","avatar":"https://avatars.githubusercontent.com/u/233215?v=4"},"body":"Here come 4 fixes to the documentation for issues which I spotted\nwhen skimming the doc for something else. They are not interrelated\n(and therefore described there, not here ;) ).\n\nMichael J Gruber (4):\n  Documentation/git-reflog: Fix formatting of command lists\n  Documentation/gitdiffcore: Remove misleading date in heading\n  Documentation/urls: Remove spurious example markers\n  Documentation/git-clone: Transform description list into item list\n\n Documentation/git-clone.txt   |   10 +++++-----\n Documentation/git-reflog.txt  |    2 --\n Documentation/gitdiffcore.txt |    2 +-\n Documentation/urls.txt        |    6 ------\n 4 files changed, 6 insertions(+), 14 deletions(-)\n"},{"id":"137460","messageId":"5f1de63293499e3f8362bfd0c6bf93046d771077.1269192495.git.git@drmicha.warpmail.net","threadId":"23124","inReplyTo":"cover.1269192495.git.git@drmicha.warpmail.net","subject":"[PATCH 1/4] Documentation/git-reflog: Fix formatting of command lists","fromName":"Michael J Gruber","fromEmail":"git@drmicha.warpmail.net","sentAt":"2010-03-21T17:30:16Z","receivedAt":"2010-03-21T17:30:16Z","isPatch":true,"sender":{"key":"git@grubix.eu","avatar":"https://avatars.githubusercontent.com/u/233215?v=4"},"body":"A misplaced list continuation mark appears literally in the\nrendered doc. Fix this by removing it.\n\nSigned-off-by: Michael J Gruber <git@drmicha.warpmail.net>\n---\n Documentation/git-reflog.txt |    2 --\n 1 files changed, 0 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/git-reflog.txt b/Documentation/git-reflog.txt\nindex 802bd57..4eaa62b 100644\n--- a/Documentation/git-reflog.txt\n+++ b/Documentation/git-reflog.txt\n@@ -18,9 +18,7 @@ depending on the subcommand:\n [verse]\n 'git reflog expire' [--dry-run] [--stale-fix] [--verbose]\n \t[--expire=<time>] [--expire-unreachable=<time>] [--all] <refs>...\n-+\n 'git reflog delete' ref@\\{specifier\\}...\n-+\n 'git reflog' ['show'] [log-options] [<ref>]\n \n Reflog is a mechanism to record when the tip of branches are\n-- \n1.7.0.2.358.g30511\n"},{"id":"137461","messageId":"adf3d89cc4c3f586e9946017e2f17c0454bc509e.1269192495.git.git@drmicha.warpmail.net","threadId":"23124","inReplyTo":"cover.1269192495.git.git@drmicha.warpmail.net","subject":"[PATCH 2/4] Documentation/gitdiffcore: Remove misleading date in heading","fromName":"Michael J Gruber","fromEmail":"git@drmicha.warpmail.net","sentAt":"2010-03-21T17:30:17Z","receivedAt":"2010-03-21T17:30:17Z","isPatch":true,"sender":{"key":"git@grubix.eu","avatar":"https://avatars.githubusercontent.com/u/233215?v=4"},"body":"Ever since the automatic conversion into man form, the heading\ncontained a misidentified subheading reading \"June 2005\".\nRemove this since the documentation is more recent, and the correct\ndate is in the footer.\n\nSigned-off-by: Michael J Gruber <git@drmicha.warpmail.net>\n---\n Documentation/gitdiffcore.txt |    2 +-\n 1 files changed, 1 insertions(+), 1 deletions(-)\n\ndiff --git a/Documentation/gitdiffcore.txt b/Documentation/gitdiffcore.txt\nindex dcdea54..9de8caf 100644\n--- a/Documentation/gitdiffcore.txt\n+++ b/Documentation/gitdiffcore.txt\n@@ -3,7 +3,7 @@ gitdiffcore(7)\n \n NAME\n ----\n-gitdiffcore - Tweaking diff output (June 2005)\n+gitdiffcore - Tweaking diff output\n \n SYNOPSIS\n --------\n-- \n1.7.0.2.358.g30511\n"},{"id":"137462","messageId":"837485763fd0598576e0c9470ae80f05750900e4.1269192495.git.git@drmicha.warpmail.net","threadId":"23124","inReplyTo":"cover.1269192495.git.git@drmicha.warpmail.net","subject":"[PATCH 3/4] Documentation/urls: Remove spurious example markers","fromName":"Michael J Gruber","fromEmail":"git@drmicha.warpmail.net","sentAt":"2010-03-21T17:30:18Z","receivedAt":"2010-03-21T17:30:18Z","isPatch":true,"sender":{"key":"git@grubix.eu","avatar":"https://avatars.githubusercontent.com/u/233215?v=4"},"body":"In urls.txt (which is included from git-{clone,fetch,push}.txt)\nseveral item lists are surrounded by example block markers. This is\nproblematic for two reasons:\n\n- None of these lists are example lists, so they should not be marked as\n  such semantically.\n- The html output looks weird (bulleted list with left sidebar).\n\nTherefore, remove the example block markers. Output by the man backend\nis uneffected.\n\nSigned-off-by: Michael J Gruber <git@drmicha.warpmail.net>\n---\n Documentation/urls.txt |    6 ------\n 1 files changed, 0 insertions(+), 6 deletions(-)\n\ndiff --git a/Documentation/urls.txt b/Documentation/urls.txt\nindex d813ceb..459a394 100644\n--- a/Documentation/urls.txt\n+++ b/Documentation/urls.txt\n@@ -4,7 +4,6 @@ GIT URLS[[URLS]]\n One of the following notations can be used\n to name the remote repository:\n \n-===============================================================\n - rsync://host.xz/path/to/repo.git/\n - http://host.xz{startsb}:port{endsb}/path/to/repo.git/\n - https://host.xz{startsb}:port{endsb}/path/to/repo.git/\n@@ -14,7 +13,6 @@ to name the remote repository:\n - ssh://{startsb}user@{endsb}host.xz/path/to/repo.git/\n - ssh://{startsb}user@{endsb}host.xz/~user/path/to/repo.git/\n - ssh://{startsb}user@{endsb}host.xz/~/path/to/repo.git\n-===============================================================\n \n SSH is the default transport protocol over the network.  You can\n optionally specify which user to log-in as, and an alternate,\n@@ -23,18 +21,14 @@ username expansion, as does the native git protocol, but\n only the former supports port specification. The following\n three are identical to the last three above, respectively:\n \n-===============================================================\n - {startsb}user@{endsb}host.xz:/path/to/repo.git/\n - {startsb}user@{endsb}host.xz:~user/path/to/repo.git/\n - {startsb}user@{endsb}host.xz:path/to/repo.git\n-===============================================================\n \n To sync with a local directory, you can use:\n \n-===============================================================\n - /path/to/repo.git/\n - file:///path/to/repo.git/\n-===============================================================\n \n ifndef::git-clone[]\n They are mostly equivalent, except when cloning.  See\n-- \n1.7.0.2.358.g30511\n"},{"id":"137463","messageId":"e42082555a7956ada34713d2972d05bc3950d757.1269192495.git.git@drmicha.warpmail.net","threadId":"23124","inReplyTo":"cover.1269192495.git.git@drmicha.warpmail.net","subject":"[PATCH 4/4] Documentation/git-clone: Transform description list into item list","fromName":"Michael J Gruber","fromEmail":"git@drmicha.warpmail.net","sentAt":"2010-03-21T17:30:19Z","receivedAt":"2010-03-21T17:30:19Z","isPatch":true,"sender":{"key":"git@grubix.eu","avatar":"https://avatars.githubusercontent.com/u/233215?v=4"},"body":"so that the list of examples is formatted in the same way as for\ngit-fetch, and, more importantly, the different identation for the\ncode blocks in the examples (compared to the immediately preceding code\nblocks from url.txt) doesn't look like misformatted, but is clarified by\nthe items' bullets.\n\nSigned-off-by: Michael J Gruber <git@drmicha.warpmail.net>\n---\n Documentation/git-clone.txt |   10 +++++-----\n 1 files changed, 5 insertions(+), 5 deletions(-)\n\ndiff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt\nindex 43cfba0..dc7d3d1 100644\n--- a/Documentation/git-clone.txt\n+++ b/Documentation/git-clone.txt\n@@ -187,7 +187,7 @@ include::urls.txt[]\n Examples\n --------\n \n-Clone from upstream::\n+* Clone from upstream:\n +\n ------------\n $ git clone git://git.kernel.org/pub/scm/.../linux-2.6 my2.6\n@@ -196,7 +196,7 @@ $ make\n ------------\n \n \n-Make a local clone that borrows from the current directory, without checking things out::\n+* Make a local clone that borrows from the current directory, without checking things out:\n +\n ------------\n $ git clone -l -s -n . ../copy\n@@ -205,7 +205,7 @@ $ git show-branch\n ------------\n \n \n-Clone from upstream while borrowing from an existing local directory::\n+* Clone from upstream while borrowing from an existing local directory:\n +\n ------------\n $ git clone --reference my2.6 \\\n@@ -215,14 +215,14 @@ $ cd my2.7\n ------------\n \n \n-Create a bare repository to publish your changes to the public::\n+* Create a bare repository to publish your changes to the public:\n +\n ------------\n $ git clone --bare -l /home/proj/.git /pub/scm/proj.git\n ------------\n \n \n-Create a repository on the kernel.org machine that borrows from Linus::\n+* Create a repository on the kernel.org machine that borrows from Linus:\n +\n ------------\n $ git clone --bare -l -s /pub/scm/.../torvalds/linux-2.6.git \\\n-- \n1.7.0.2.358.g30511\n"}]}