{"thread":{"id":"742","subject":"[RFC] Removing git-*.html references from manpages","startedAt":"2005-05-27T22:58:50Z","lastAt":"2005-06-08T19:24:15Z","messageCount":4,"participants":["Jonas Fonseca","Petr Baudis","David Greaves"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"4111","messageId":"20050527225850.GA25491@diku.dk","threadId":"742","inReplyTo":null,"subject":"[RFC] Removing git-*.html references from manpages","fromName":"Jonas Fonseca","fromEmail":"fonseca@diku.dk","sentAt":"2005-05-27T22:58:50Z","receivedAt":"2005-05-27T22:58:50Z","isPatch":false,"sender":{"key":"fonseca@diku.dk","avatar":"https://gravatar.com/avatar/f82f3ad698717c51873b020c750a92438c820a24056dc39fe4d07baa10a92264?d=mp&s=160"},"body":"Hello,\n\nJust a minor issue but still. Currently the manpages contains the\nfollowing:\n\n\tgit-export: git-export.html\n\nI'd like to have the interlinking references removed from the manpages\nso it becomes just:\n\n\tgit-export\n\nor what ever was put between the square brackets of the link: macro.\n\nThe fix requires the introduction of an asciidoc.conf file and a new\nlink macro which I've called gitlink: but it could be shorter (and also\nsmarter so link:git-CMD.html[git-CMD] could become man:git-CMD[]).\n\nBelow is a small patch probe to show the basic idea.\n\nWhat do you think?\n\n--- a/Documentation/Makefile  (mode:100644)\n+++ b/Documentation/Makefile  (mode:100644)\n@@ -32,10 +32,10 @@\n \trm -f *.xml *.html *.1 *.7\n \n %.html : %.txt\n-\tasciidoc -b css-embedded -d manpage $<\n+\tasciidoc -b css-embedded -d manpage -f asciidoc.conf $<\n \n %.1 %.7 : %.xml\n \txmlto man $<\n \n %.xml : %.txt\n-\tasciidoc -b docbook -d manpage $<\n+\tasciidoc -b docbook -d manpage -f asciidoc.conf $<\n--- /dev/null  (tree:f6db9be9d431080d9e7f61edb616b8bac8c9618f)\n+++ b/Documentation/asciidoc.conf  (mode:100644)\n@@ -0,0 +1,14 @@\n+ifdef::backend-docbook[]\n+\n+# Don't show the link target to git-*.html pages in the man page\n+[gitlink-inlinemacro]\n+<emphasis>{attrlist}</emphasis>\n+\n+endif::backend-docbook[]\n+\n+ifdef::backend-css-embedded[]\n+\n+[gitlink-inlinemacro]\n+<a href=\"{target}\">{0={target}}</a>\n+\n+endif::backend-css-embedded[]\n--- a/Documentation/git.txt  (mode:100644)\n+++ b/Documentation/git.txt  (mode:100644)\n@@ -39,34 +39,34 @@\n \n Manipulation commands\n ~~~~~~~~~~~~~~~~~~~~~\n-link:git-checkout-cache.html[git-checkout-cache]::\n+gitlink:git-checkout-cache.html[git-checkout-cache]::\n \tCopy files from the cache to the working directory\n \n-link:git-commit-tree.html[git-commit-tree]::\n+gitlink:git-commit-tree.html[git-commit-tree]::\n \tCreates a new commit object\n \n-link:git-init-db.html[git-init-db]::\n+gitlink:git-init-db.html[git-init-db]::\n \tCreates an empty git object database\n \n-link:git-merge-base.html[git-merge-base]::\n+gitlink:git-merge-base.html[git-merge-base]::\n \tFinds as good a common ancestor as possible for a merge\n \n-link:git-mkdelta.html[git-mkdelta]::\n+gitlink:git-mkdelta.html[git-mkdelta]::\n \tCreates a delta object\n \n-link:git-mktag.html[git-mktag]::\n+gitlink:git-mktag.html[git-mktag]::\n \tCreates a tag object\n \n-link:git-read-tree.html[git-read-tree]::\n+gitlink:git-read-tree.html[git-read-tree]::\n \tReads tree information into the directory cache\n \n-link:git-update-cache.html[git-update-cache]::\n+gitlink:git-update-cache.html[git-update-cache]::\n \tModifies the index or directory cache\n \n-link:git-write-blob.html[git-write-blob]::\n+gitlink:git-write-blob.html[git-write-blob]::\n \tCreates a blob from a file\n \n-link:git-write-tree.html[git-write-tree]::\n+gitlink:git-write-tree.html[git-write-tree]::\n \tCreates a tree from the current cache\n \n Interrogation commands\n\n-- \nJonas Fonseca\n"},{"id":"4151","messageId":"20050529015213.GC7520@diku.dk","threadId":"742","inReplyTo":"20050527225850.GA25491@diku.dk","subject":"Re: [RFC] Removing git-*.html references from manpages","fromName":"Jonas Fonseca","fromEmail":"fonseca@diku.dk","sentAt":"2005-05-29T01:52:13Z","receivedAt":"2005-05-29T01:52:13Z","isPatch":false,"sender":{"key":"fonseca@diku.dk","avatar":"https://gravatar.com/avatar/f82f3ad698717c51873b020c750a92438c820a24056dc39fe4d07baa10a92264?d=mp&s=160"},"body":"Jonas Fonseca <fonseca@diku.dk> wrote Sat, May 28, 2005:\n> Just a minor issue but still.\n\nAnother issue: `--' gets replaced with `&#8212;'. The debian cogito\npackage mentions this. Seems it can be fixed by overwriting the default\nreplacement rule using the following in asciidoc.conf:\n\n\t[replacements]\n\t(^|[^-])--($|[^-])=\\1--\\2\n\nMaybe it can be done smarter.\n\n-- \nJonas Fonseca\n"},{"id":"4715","messageId":"20050608185914.GJ982@pasky.ji.cz","threadId":"742","inReplyTo":"20050527225850.GA25491@diku.dk","subject":"Re: [RFC] Removing git-*.html references from manpages","fromName":"Petr Baudis","fromEmail":"pasky@ucw.cz","sentAt":"2005-06-08T18:59:14Z","receivedAt":"2005-06-08T18:59:14Z","isPatch":false,"sender":{"key":"pasky@ucw.cz","avatar":"https://avatars.githubusercontent.com/u/18439?v=4"},"body":"Dear diary, on Sat, May 28, 2005 at 12:58:50AM CEST, I got a letter\nwhere Jonas Fonseca <fonseca@diku.dk> told me that...\n> Hello,\n\nHi,\n\n> What do you think?\n\nso, what do people think? It sounds as a good thing, but I miss any\ndiscussion. I assume that means everyone likes it? ;-)\n\n> --- a/Documentation/git.txt  (mode:100644)\n> +++ b/Documentation/git.txt  (mode:100644)\n> @@ -39,34 +39,34 @@\n>  \n>  Manipulation commands\n>  ~~~~~~~~~~~~~~~~~~~~~\n> -link:git-checkout-cache.html[git-checkout-cache]::\n> +gitlink:git-checkout-cache.html[git-checkout-cache]::\n>  \tCopy files from the cache to the working directory\n\nSo wasn't the point that this would rather be\n\n\t+gitlink:git-checkout-cache::\n\nthan to what you change it to now?\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"},{"id":"4716","messageId":"42A745DF.70104@dgreaves.com","threadId":"742","inReplyTo":"20050608185914.GJ982@pasky.ji.cz","subject":"Re: [RFC] Removing git-*.html references from manpages","fromName":"David Greaves","fromEmail":"david@dgreaves.com","sentAt":"2005-06-08T19:24:15Z","receivedAt":"2005-06-08T19:24:15Z","isPatch":false,"sender":{"key":"david@dgreaves.com","avatar":"https://gravatar.com/avatar/ca67bad50999edcdd137c9a65da2381557d175bea99ae956afdabc5785e42b79?d=mp&s=160"},"body":"Petr Baudis wrote:\n\n>Dear diary, on Sat, May 28, 2005 at 12:58:50AM CEST, I got a letter\n>where Jonas Fonseca <fonseca@diku.dk> told me that...\n>  \n>\n>>Hello,\n>>    \n>>\n>\n>Hi,\n>\n>  \n>\n>>What do you think?\n>>    \n>>\n>\n>so, what do people think? It sounds as a good thing, but I miss any\n>discussion. I assume that means everyone likes it? ;-)\n>  \n>\n\nI certainly like it :)\n\nAlthough I'm moving house at the moment so I'm somewhat behind...\n\nDavid\n"}]}