{"thread":{"id":"35667","subject":"[PATCH] provide a Git user-manual man page","startedAt":"2014-01-15T23:10:51Z","lastAt":"2014-01-15T23:10:52Z","messageCount":2,"participants":["Philip Oakley"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"233177","messageId":"1389827452-3896-1-git-send-email-philipoakley@iee.org","threadId":"35667","inReplyTo":null,"subject":"[PATCH] provide a Git user-manual man page","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2014-01-15T23:10:51Z","receivedAt":"2014-01-15T23:10:51Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"The Git User Manual is formatted as a doc book, rather than as\na man page so isn't directly accessible via the 'hit help <guide>'\ncommand.\n\nThis patch provides a simple man page with onward links to the true\nUser-Manual. \n\nThe man page is based directly on a very cut down version of the git(1)\npage.\n\nThis patch is based on master, so the update to the help.c list of\nguides may need a simple merge resolution with the 'git help everyday'\npatch currently in pu.\n\nPhilip Oakley (1):\n  Provide a 'git help user-manual' route to the docbook\n\n Documentation/Makefile           |  1 +\n Documentation/gituser-manual.txt | 34 ++++++++++++++++++++++++++++++++++\n builtin/help.c                   |  1 +\n 3 files changed, 36 insertions(+)\n create mode 100644 Documentation/gituser-manual.txt\n\n-- \n1.8.3.msysgit.0\n"},{"id":"233178","messageId":"1389827452-3896-2-git-send-email-philipoakley@iee.org","threadId":"35667","inReplyTo":"1389827452-3896-1-git-send-email-philipoakley@iee.org","subject":"[PATCH] Provide a 'git help user-manual' route to the docbook","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2014-01-15T23:10:52Z","receivedAt":"2014-01-15T23:10:52Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"Signed-off-by: Philip Oakley <philipoakley@iee.org>\n---\n Documentation/Makefile           |  1 +\n Documentation/gituser-manual.txt | 34 ++++++++++++++++++++++++++++++++++\n builtin/help.c                   |  1 +\n 3 files changed, 36 insertions(+)\n create mode 100644 Documentation/gituser-manual.txt\n\ndiff --git a/Documentation/Makefile b/Documentation/Makefile\nindex 36c58fc..3793e4c 100644\n--- a/Documentation/Makefile\n+++ b/Documentation/Makefile\n@@ -28,6 +28,7 @@ MAN7_TXT += gitnamespaces.txt\n MAN7_TXT += gitrevisions.txt\n MAN7_TXT += gittutorial-2.txt\n MAN7_TXT += gittutorial.txt\n+MAN7_TXT += gituser-manual.txt\n MAN7_TXT += gitworkflows.txt\n \n MAN_TXT = $(MAN1_TXT) $(MAN5_TXT) $(MAN7_TXT)\ndiff --git a/Documentation/gituser-manual.txt b/Documentation/gituser-manual.txt\nnew file mode 100644\nindex 0000000..9fd4744\n--- /dev/null\n+++ b/Documentation/gituser-manual.txt\n@@ -0,0 +1,34 @@\n+gituser-manual(7)\n+=================\n+\n+NAME\n+----\n+gituser-manual - a link to the user-manual docbook\n+\n+\n+SYNOPSIS\n+--------\n+[verse]\n+'git help user-manual'\n+\n+link:user-manual.html[Git User's Manual]\n+\n+DESCRIPTION\n+-----------\n+Git is a fast, scalable, distributed revision control system with an\n+unusually rich command set that provides both high-level operations\n+and full access to internals.\n+\n+The link:user-manual.html[Git User's Manual] provides an\n+in-depth introduction to Git.\n+\n+SEE ALSO\n+--------\n+linkgit:gittutorial[7],\n+linkgit:giteveryday[7],\n+linkgit:gitcli[7],\n+linkgit:gitworkflows[7]\n+\n+GIT\n+---\n+Part of the linkgit:git[1] suite\ndiff --git a/builtin/help.c b/builtin/help.c\nindex 1fdefeb..be7c39d 100644\n--- a/builtin/help.c\n+++ b/builtin/help.c\n@@ -427,6 +427,7 @@ static struct {\n \t{ \"modules\", N_(\"Defining submodule properties\") },\n \t{ \"revisions\", N_(\"Specifying revisions and ranges for Git\") },\n \t{ \"tutorial\", N_(\"A tutorial introduction to Git (for version 1.5.1 or newer)\") },\n+\t{ \"user-manual\", N_(\"A link to the user-manual docbook\") },\n \t{ \"workflows\", N_(\"An overview of recommended workflows with Git\") },\n };\n \n-- \n1.8.3.msysgit.0\n"}]}