{"thread":{"id":"20532","subject":"RFC: default version of the documentation tool chain (git 1.7)","startedAt":"2009-08-11T09:28:37Z","lastAt":"2009-08-12T02:53:18Z","messageCount":2,"participants":["Michael J Gruber","Junio C Hamano"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"120225","messageId":"4A8139C5.9030703@drmicha.warpmail.net","threadId":"20532","inReplyTo":null,"subject":"RFC: default version of the documentation tool chain (git 1.7)","fromName":"Michael J Gruber","fromEmail":"git@drmicha.warpmail.net","sentAt":"2009-08-11T09:28:37Z","receivedAt":"2009-08-11T09:28:37Z","isPatch":false,"sender":{"key":"git@grubix.eu","avatar":"https://avatars.githubusercontent.com/u/233215?v=4"},"body":"The current defaults for building the documentation are so that asciidoc\nup to 7.1.2 and docbook-xsl 1.69.0 and 1.71.1 need no extra settings,\nwhereas all other versions need extra options (1 or more of ASCIIDOC8,\nASCIIDOC_NO_ROFF, DOCBOOK_XSL_172, DOCBOOK_SUPPRESS_SP), see below. This\nbasically means that all current distros need extra options.\n\nI suggest changing the defaults for the git-1.7 cycle. Below I list the\npackage versions in current mainstream distros, without using third\nparty repositories, but including the leading edge which foreshadows\nupcoming versions.\n\nBased on that, I suggest the following defaults for the git-1.7\ndocumentation build file:\n- ASCIIDOC8=yes. Caters for everything non-EOLed (8.0 and above)\n- ASCIIDOC_NO_ROFF=yes. Caters for everything non-EOLed (1.73 and above,\n1.68.1 and below)\n\n[I'm not sure RHEL is EOLed but I don't think we need to care.]\n\nIt would be helpful if people with newer versions (asciidoc 8.4,\ndocbook-xsl 1.75) could test building the git documentation, in order to\nverify \"and above\" ;)\nAlso, I don't know about the two proprietary OSes we support.\n\nCheers,\nMichael\n\nCurrent mainstream versions of asciidoc are:\nDebian Etch (EOLed): 7.1.2\nDebian Lenny: 8.2.7\nDebian Squeeze: 8.4.4\nDebian Sid: 8.4.4\nUbuntu Dapper (EOLed): 7.0.2\nUbuntu Hardy: 8.2.2\nUbuntu Intrepid: 8.2.6\nUbuntu Jaunty: 8.2.7\nUbuntu Karmic: 8.4.4\nFedora 9 (EOLed): 8.2.5\nFedora 10: 8.2.5\nFedora 11: 8.2.5\nFedora rawhide: 8.2.5\nFedora Koji (12): 8.4.5\nRedhat EL4 extras: 7.0.2\nRedhat EL5 extras: 8.1.0\nOpenSUSE 10: 8.2.1\nOpenSUSE 11: 8.2.7\nOpenSUSE factory: 8.4.5\nOpenBSD 4.3: 8.2.5\nOpenBSD 4.4: 8.2.6\nOpenBSD 4.5: 8.2.7\n\nCurrent mainstream versions of docbook-xsl are:\nDebian Etch (EOLed): 1.71.0\nDebian Lenny: 1.73.2\nDebian Squeeze: 1.75.2\nDebian Sid: 1.75.2\nUbuntu Dapper (EOLed): 1.68.1\nUbuntu Hardy: 1.73.2\nUbuntu Intrepid: 1.73.2\nUbuntu Jaunty: 1.73.2\nUbuntu Karmic: 1.75.1\nFedora 9 (EOLed): 1.73.2\nFedora 10: 1.74.0\nFedora 11: 1.74.3\nFedora rawhide: 1.75.2\nFedora Koji (12): 1.75.2\nRedhat EL4: 1.65.1\nOpenSUSE 11: 1.74.0\nOpenSUSE factory: 1.75.2\nOpenBSD 4.3: 1.68\nOpenBSD 4.4: 1.68\nOpenBSD 4.5: 1.68\n\n>From Documentation/Makefile:\n\n#\n# For asciidoc ...\n#       -7.1.2, no extra settings are needed.\n#       8.0-,   set ASCIIDOC8.\n#\n\n#\n# For docbook-xsl ...\n#       -1.68.1,        set ASCIIDOC_NO_ROFF? (based on changelog from\n1.73.0)\n#       1.69.0,         no extra settings are needed?\n#       1.69.1-1.71.0,  set DOCBOOK_SUPPRESS_SP?\n#       1.71.1,         no extra settings are needed?\n#       1.72.0,         set DOCBOOK_XSL_172.\n#       1.73.0-,        set ASCIIDOC_NO_ROFF\n#\n\n#\n# If you had been using DOCBOOK_XSL_172 in an attempt to get rid\n# of 'the \".ft C\" problem' in your generated manpages, and you\n# instead ended up with weird characters around callouts, try\n# using ASCIIDOC_NO_ROFF instead (it works fine with ASCIIDOC8).\n#\n"},{"id":"120355","messageId":"7v8whpbv4x.fsf@alter.siamese.dyndns.org","threadId":"20532","inReplyTo":"4A8139C5.9030703@drmicha.warpmail.net","subject":"Re: RFC: default version of the documentation tool chain (git 1.7)","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2009-08-12T02:53:18Z","receivedAt":"2009-08-12T02:53:18Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Michael J Gruber <git@drmicha.warpmail.net> writes:\n\n> The current defaults for building the documentation are so that asciidoc\n> up to 7.1.2 and docbook-xsl 1.69.0 and 1.71.1 need no extra settings,\n> whereas all other versions need extra options (1 or more of ASCIIDOC8,\n> ASCIIDOC_NO_ROFF, DOCBOOK_XSL_172, DOCBOOK_SUPPRESS_SP), see below. This\n> basically means that all current distros need extra options.\n>\n> I suggest changing the defaults for the git-1.7 cycle.\n\nDo you mean that people with older asciidoc would set a new option, say\nASCIIDOC7, instead of not setting ASCIIDOC8?\n\n> Based on that, I suggest the following defaults for the git-1.7\n> documentation build file:\n> - ASCIIDOC8=yes. Caters for everything non-EOLed (8.0 and above)\n> - ASCIIDOC_NO_ROFF=yes. Caters for everything non-EOLed (1.73 and above,\n> 1.68.1 and below)\n\nI would say that is a sensible default.\n"}]}