{"thread":{"id":"1864","subject":"[PATCH][COGITO] Broken Documentation","startedAt":"2005-09-19T20:23:10Z","lastAt":"2005-09-19T20:23:10Z","messageCount":1,"participants":["Martin Atukunda"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"8899","messageId":"20050919202310.GB17503@igloo.ds.co.ug","threadId":"1864","inReplyTo":null,"subject":"[PATCH][COGITO] Broken Documentation","fromName":"Martin Atukunda","fromEmail":"matlads@dsmagic.com","sentAt":"2005-09-19T20:23:10Z","receivedAt":"2005-09-19T20:23:10Z","isPatch":true,"sender":{"key":"matlads@dsmagic.com","avatar":null},"body":"As noted by Horst von Brand <vonbrand@inf.utfsm.cl>, cg-parent-id.txt\nand cg-tree-id.txt don't validate as xml, and this breaks the Documentation build.\n\nI traced this to the fact that cg-parent-id and cg-tree-id do not have\nUSAGE=... lines. btw, this also affects cg-commit-id.\n\nPatch below adds USAGE lines to cg-parent-id, cg-tree-id, and\ncg-commit-id.\n\nSigned-Off-By: Martin Atukunda <matlads@dsmagic.com>\n\n---\n\ndiff --git a/cg-commit-id b/cg-commit-id\n--- a/cg-commit-id\n+++ b/cg-commit-id\n@@ -5,6 +5,8 @@\n #\n # Takes the appropriate ID, defaults to HEAD.\n \n+USAGE=\"cg-commit-id [COMMIT_ID]\"\n+\n id=\"$1\"\n normid=$(. ${COGITO_LIB}cg-Xnormid \"$id\") || exit 1\n type=${normid#* }\ndiff --git a/cg-parent-id b/cg-parent-id\n--- a/cg-parent-id\n+++ b/cg-parent-id\n@@ -7,5 +7,7 @@\n #\n # NOTE: Will return multiple SHA1s if ID is a commit with multiple parents.\n \n+USAGE=\"cg-parent-id [COMMIT_ID]\"\n+\n normid=$(. ${COGITO_LIB}cg-Xnormid \"$1\"^)\n echo ${normid%% *}\ndiff --git a/cg-tree-id b/cg-tree-id\n--- a/cg-tree-id\n+++ b/cg-tree-id\n@@ -5,6 +5,8 @@\n #\n # Takes ID of the appropriate commit, defaults to HEAD.\n \n+USAGE=\"cg-tree-id [COMMIT_ID]\"\n+\n id=\"$1\"\n normid=$(. ${COGITO_LIB}cg-Xnormid \"$id\") || exit 1\n type=${normid#* }\n"}]}