{"thread":{"id":"903","subject":"minor doc patch for cogito","startedAt":"2005-06-11T04:23:51Z","lastAt":"2005-06-11T04:23:51Z","messageCount":1,"participants":["Sebastian Kuzminsky"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"4851","messageId":"E1DgxXD-0004Ky-SE@highlab.com","threadId":"903","inReplyTo":null,"subject":"minor doc patch for cogito","fromName":"Sebastian Kuzminsky","fromEmail":"seb@highlab.com","sentAt":"2005-06-11T04:23:51Z","receivedAt":"2005-06-11T04:23:51Z","isPatch":false,"sender":{"key":"seb@highlab.com","avatar":"https://gravatar.com/avatar/f7ddd092ba3cf6999434f4d0d2f4b90fd174c2c3851617e8cffc0a2fee47becc?d=mp&s=160"},"body":"Here are some minor changes to the Cogito docs, to add the manpage\nsection to the asciidoc links.  It also adds a 'txt' target to\nDocumentation/Makefile, so we can make the Cogito .txt docs if we want.\n\n\n Makefile             |    4 +++-\n make-cg-asciidoc     |    4 ++--\n make-cogito-asciidoc |   15 +++++++++++----\n 3 files changed, 16 insertions(+), 7 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/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,13 +114,13 @@ $(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-- \nSebastian Kuzminsky\n\n-- \nSebastian Kuzminsky\n"}]}