Note: This document lists changes only since the 1.72.0 release. If you instead want a record of the complete list of changes for the codebase over its entire history, you can obtain one by running the following commands: svn checkout https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/xsl svn log --xml --verbose xsl > ChangeHistory.xml The following is a list of changes that have been made since the 1.72.0 release. The following changes have been made to the gentext code since the 1.72.0 release. Mauritz Jeanson: locale/de.xmlApplied patch #1766009. Michael(tm) Smith: locale/lv.xmlAdded localization for ProductionSet. Michael(tm) Smith: locale/lv.xml; MakefileAdded Latvian localization file, from Girts Ziemelis. Robert Stayton: xsl/xsl.xslAdd comment explaining %t etc. Dongsheng Song: locale/zh_cn.xmlBrought up to date with en.xml in terms of items. A few strings marked for translation. Dongsheng Song: locale/eo.xmlRemove svn:executable property from xml files. Jirka Kosek: locale/cs.xmlAdded missing translations Robert Stayton: locale/eo.xmlNew locale for Esperanto. Robert Stayton: locale/mn.xmlUpdate from Ganbold Tsagaankhuu. Jirka Kosek: locale/en.xml; locale/cs.xmlRules for normalizing glossary entries before they are sorted can be now different for each language. Robert Stayton: locale/Auditlocale.plFix context comparison bug. Norman Walsh: locale/sr.xmlFix broken locale: you can't have a comment in a start tag Michael(tm) Smith: locale/sr_Latn.xml; locale/sr.xmlCommitted changes from Miloš Komarčević to Serbian files. Michael(tm) Smith: MakefileRenamed cvstools dir to buildtools, and replaced all references to "cvstools" in makefiles and elsewhere with "buildtools". Jirka Kosek: xsl/xsl.xslChanged variable expression assignment from RTF to node set, so boolean tests work correctly. Jirka Kosek: xsl/xsl.xslEmpty translation in gentext is copied to target locale file (it is not replaced by English variant). Michael(tm) Smith: xsl/xsl.xslRefined gentext build so that transform of gentext sources to output is same whether generated by xsltproc or saxon. Jirka Kosek: locale/en.xml; locale/cs.xmlAdded support for formatting biblioentries according to ISO690 citation style. New bibliography style can be turned on by setting parameter bibliography.style to "iso690" The code was provided by Jana Dvorakova Robert Stayton: locale/ja.xmlFix chapter in context xref-number-and-title Robert Stayton: locale/it.xmlImproved version from contributor. Mauritz Jeanson: locale/uk.xmlApplied patch 1592083. The following changes have been made to the common code since the 1.72.0 release. Michael(tm) Smith: stripns.xslReverted stripns.xsl to not rely on message-logging template. Thanks to Ville-Pekka Vainio, whose testing with Moin/4suite exposed a problem this caused. Michael(tm) Smith: charmap.xslSet keywords on a number of files. Michael(tm) Smith: l10n.xmlAdded Latvian locale Michael(tm) Smith: charmap.xslFixed typo. Michael(tm) Smith: pi.xslMark up PIs with tag@class=xmlpi so that they can get picked up an formatted correctly by the doc build. Michael(tm) Smith: .cvsignore; MakefileAdded Latvian localization file, from Girts Ziemelis. Michael(tm) Smith: charmap.xslMoved charmap templates out of lib.xweb and into common/charmap.xsl, and added charmap doc to doc build. Michael(tm) Smith: utility.xslFixed typo. Michael(tm) Smith: refentry.xsl; utility.xsl; table.xsl; common.xslMake all common stylesheets with embedded doc valid against our litprog grammar. Michael(tm) Smith: pi.xslMake pi.xsl files valid against our litprog grammar. Michael(tm) Smith: pi.xslMake PI source files valid against our litprog schema. Michael(tm) Smith: labels.xslChanged handling of reference auto-labeling such that reference (when it appears at the component level) is now affected by the label.from.part param, just as preface, chapter, and appendix. Michael(tm) Smith: refentry.xsl; utility.xsl; common.xslUpdated embedded doc in XSL source files: - added dbhtml@dir PIs to control where output goes when generation HTML version of docs - put xml:id instances on root elements of embedded doc - changed all *info instances to just info (DocBook 5) and some @id instance to @xml-id Michael(tm) Smith: .cvsignoreSet updated ignore properties and adjusted for fact that shared makefile now expects a "PARAMBASE" value to be specified (to indicate base filename for the type of content being built: either PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce redundancy in the lib build, and just have it use the same makefile "infrastructure" as the param builds for all the param.xsl files. The reason for that is, lib use the same *.xweb system for embedding documentation that the builds for the various output formats use (as opposed to the jrefentry-based system that used for building the template and PI docs in common etc. Michael(tm) Smith: common.xsl; pi.xslAdded doc for the dbchoice choice PI, and fixes some problems with the db* start PI handling. Michael(tm) Smith: common.xsl; pi.xslAdded embedded documentation on the following PIs: - dbhtml_start - dbfo_start - dbtex_delims - dbtimestamp Michael(tm) Smith: utility.xslMade minor editorial change to embedded doc for utility templates. Michael(tm) Smith: MakefileSet XJPARSEFLAGS = -E 0 -w for xsl/common build too. Michael(tm) Smith: MakefileFor docbook-xsl builds, feed xjparse the -EO and -w switches. -E0 suppresses the "Parse succeeded... with no errors and no warnings" messages that xjparse (actually, the XML Commons resolver) otherwise emits. -w cause xjparse/resolver to only do a well-formedness check, instead of trying to do validation; the reason for adding this is that xjparse gets run against what are now doctype-less, namespaced DocBook instances (after recent changes to the build) and fails to validate those (because they don't have a doctype) What we really need to do long-term is replace xjparse with a better, RELAXNG-aware validation mechanism, so that we can have the build properly validate stuff that it should be checking. That maybe amounts to making an "xslt" wrapper tool that either calls jing or rnv (depending on what the builder wants to use). But for now we'll need to tolerate that fact that xjparse isn't doing anything more for us than just simply WF checking... Michael(tm) Smith: common.xslAdded support to the HTML stylesheets for proper processing of orgname as a child of author. Michael(tm) Smith: targets.xsl; utility.xsl; titles.xsl; pi.xsl; subtitles.xsl; table.xsl;⋯In files that still referred to nwalsh.com URL in the copyright header, changed to docbook.sf.net URL. Michael(tm) Smith: MakefileAdded -E0 switch to default xjparse options, in order to suppress "Parse succeeded... with no errors and no warnings." messages. Thanks Norm for letting me know which flag to set. Michael(tm) Smith: refentry.xsl; subtitles.xsl; labels.xsl; utility.xsl; titles.xsl; table⋯Added IDs in a bunch of places in embedded template docs that could use them. Michael(tm) Smith: stripns.xsl; utility.xsl; common.xslMoved logging template and related templates to separate utility.xsl file so that can be imported without importing the whole common.xsl file (which is necessary for the build and for using the logging template in standalone namespace-stripping because the common.xsl file assumes it will be imported along with all the params, which it can't be when building lib.xsl). Michael(tm) Smith: stripns.xsl; common.xslUpdated stylesheets to use common logging template to log messages emitted during namespace-stripping. Also, moved pad-string template from lib to common because it's needed in order to use logging template in the profiling stylesheets, and the lib build relies on the profiling apparatus (so the profiling apparatus can't rely on lib being built first...) Michael(tm) Smith: .cvsignoresvn-ignore newly add eo.xml file Michael(tm) Smith: entities.entRemoved all "Do not edit this file" admonitions that get output in generated stylesheets; such admonitions have in the past been judged by the free-software police to be at-risk of interpretation as license restrictions. Also, made various updates to work around some funkiness is xsltproc output. Michael(tm) Smith: refentry.xslRefined logging output of refentry metadata-gathering template; for some cases of "missing" elements (refmiscinfo stuff, etc.), the log messages now include URL to corresponding page in the Definitive Guide (TDG). Michael(tm) Smith: common.xslImproved general logging template to parameterize some parts that were hardcoded previously. Robert Stayton: l10n.xml; MakefileAdd eo.xml Esperanto. Robert Stayton: entities.entAdd xmlns:xsl declaration to elements in entities. Jirka Kosek: entities.entRules for normalizing glossary entries before they are sorted can be now different for each language. Robert Stayton: titles.xslfix caption plus title in cals table producing double caption. Michael(tm) Smith: MakefileRenamed cvstools dir to buildtools, and replaced all references to "cvstools" in makefiles and elsewhere with "buildtools". Robert Stayton: table.xslFix bug 1668629 valign on tbody not inherited. Robert Stayton: titles.xslAdd refsection/info/title support. Michael(tm) Smith: titles.xslAdded support for correct handling of xref to elements that contain info/title descendants but no title children. This should be further refined so that it handles any *info elements. And there are probably some other places where similar handling for *info/title should be added. Michael(tm) Smith: refentry.xslUpdated copyright notices. Mauritz Jeanson: pi.xslModified <xsl:when> in datetime.format template to work around Xalan bug. The following changes have been made to the fo code since the 1.72.0 release. Michael(tm) Smith: highlight.xslSet keywords on a number of files. Mauritz Jeanson: footnote.xslFixed typo (introduced by me in r6773). Closes bug #1778340. Mauritz Jeanson: table.xslModified the tgroup template so that, for tables with multiple tgroups, a width attribute is output on all corresponding fo:tables. Previously, there was a test prohibiting this (and a comment saying that outputting more than one width attribute will cause an error). But this seems to be no longer relevant; it is not a problem with FOP 0.93 or XEP 4.10. Closes bug #1760559. Mauritz Jeanson: graphics.xslReplaced useless <a> elements with warning messages (textinsert extension). Mauritz Jeanson: admon.xslEnabled generation of ids (on fo:wrapper) for indexterms in admonition titles, so that page references in the index can be created. Closes bug #1775086. Mauritz Jeanson: pi.xslFixed typo. Mauritz Jeanson: pi.xslAdded missing equals sign (dbfo-need). Michael(tm) Smith: pi.xslMark up PIs with tag@class=xmlpi so that they can get picked up an formatted correctly by the doc build. Michael(tm) Smith: pi.xslShortened some refpurpose text for embedded doc for PIs. Michael(tm) Smith: table.xslMake fo/table.xsl file valid against our litprog schema. Michael(tm) Smith: pi.xslMake pi.xsl files valid against our litprog grammar. Michael(tm) Smith: .cvsignoreIgnore another build-generated kludge. Yeah, I know it's ridiculous. If you can come up with a prettier way of doing it, all of my riches will be yours. Michael(tm) Smith: pi.xslMake PI source files valid against our litprog schema. Michael(tm) Smith: param.xwebMake *.xweb instances valid against the https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/params/refentry.rnc grammar. Robert Stayton: component.xslAdd parameters to the page.sequence utility template. Michael(tm) Smith: MakefileMake sure that *template.xml files under version control don't get removed when we clean. Michael(tm) Smith: table.xslUpdated embedded doc in XSL source files: - added dbhtml@dir PIs to control where output goes when generation HTML version of docs - put xml:id instances on root elements of embedded doc - changed all *info instances to just info (DocBook 5) and some @id instance to @xml-id Michael(tm) Smith: param.xwebChanged url for page.png Mauritz Jeanson: xref.xslAdded template for xref to area/areaset. Part of fix for bug #1675513 (xref to area broken). Michael(tm) Smith: .cvsignoreIgnore intermediate params file. Michael(tm) Smith: .cvsignore; MakefileSet updated ignore properties and adjusted for fact that shared makefile now expects a "PARAMBASE" value to be specified (to indicate base filename for the type of content being built: either PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce redundancy in the lib build, and just have it use the same makefile "infrastructure" as the param builds for all the param.xsl files. The reason for that is, lib use the same *.xweb system for embedding documentation that the builds for the various output formats use (as opposed to the jrefentry-based system that used for building the template and PI docs in common etc. Michael(tm) Smith: lists.xslAdded doc for the dbchoice choice PI, and fixes some problems with the db* start PI handling. Michael(tm) Smith: pi.xslAdded embedded documentation on the following PIs: - dbhtml_start - dbfo_start - dbtex_delims - dbtimestamp Michael(tm) Smith: pi.xslmade some cleanup to the fo/pi.xsl params doc. Also fixed a couple typos. Michael(tm) Smith: pi.xslAdded TCG links and param links to embedded doc of FO PIs. This completes the work on adding this doc for the FO stylesheets. Michael(tm) Smith: pi.xslMade minor editorial to embedded documentation. Michael(tm) Smith: verbatim.xslMade the following changed in the mode="hyphenate.verbatim" template: - <xsl:apply-templates select="node()|@*" mode="hyphenate.verbatim"/> + <xsl:copy-of select="@*"/> + <xsl:apply-templates mode="hyphenate.verbatim"/> ...because as was it caused xsltproc to raise a fatal "Attribute nodes must be added before any child nodes to an element." (though not saxon) Michael(tm) Smith: lists.xsl; titlepage.xsl; formal.xsl; graphics.xsl; qandaset.xsl; gloss⋯Consolidated processing of all FO PIs into wrapper templates in one place (the fo/pi.xsl file) and added embedded documentation for all of them. This makes it possible to now include generated documentation for the PIs in the output docs. Next stop: HTML PIs, then on to the common ones... This touched a lot of files and it is likely that I made some mistakes in moving the PI processing over. Meaning that some PIs might quit working or not work as expected after this change. So it will need to tested. Which is why we do dot-zero releases... Michael(tm) Smith: param.xwebAdded an ID on mediaobject that illustrates FO page regions, so that the ID can get picked up and used as the filename for the "long description" chunk for that mediaobject in HTML output. Mauritz Jeanson: lists.xslFixed bug #1711508. Michael(tm) Smith: division.xsl; toc.xsl; biblio-iso690.xsl; block.xsl; graphics.xsl; html⋯In files that still referred to nwalsh.com URL in the copyright header, changed to docbook.sf.net URL. Norman Walsh: graphics.xslURIs that start with '/' are absolute too Robert Stayton: xep.xslWhitespace adjustment. Michael(tm) Smith: docbook.xsl; table.xslMoved logging template and related templates to separate utility.xsl file so that can be imported without importing the whole common.xsl file (which is necessary for the build and for using the logging template in standalone namespace-stripping because the common.xsl file assumes it will be imported along with all the params, which it can't be when building lib.xsl). Michael(tm) Smith: docbook.xslUpdated stylesheets to use common logging template to log messages emitted during namespace-stripping. Also, moved pad-string template from lib to common because it's needed in order to use logging template in the profiling stylesheets, and the lib build relies on the profiling apparatus (so the profiling apparatus can't rely on lib being built first...) Michael(tm) Smith: inline.xslAdded template match for person element to fo stylesheet. Michael(tm) Smith: param.xwebRemoved all "Do not edit this file" admonitions that get output in generated stylesheets; such admonitions have in the past been judged by the free-software police to be at-risk of interpretation as license restrictions. Also, made various updates to work around some funkiness is xsltproc output. Mauritz Jeanson: fo-patch-for-fop.xslfo-patch-for-fop.xsl deleted (obsolete). Robert Stayton: docbook.xslChanged the comments regarding namespace striping to mention the docbook5 namedspaced stylesheets. Robert Stayton: lists.xslRemoved old varlistentry accidentally left in. Robert Stayton: lists.xslAdded support for spacing="compact" in variablelist, per bug report #1722540. Robert Stayton: table.xsltable pgwide="1" should also use pgwide.properties attribute-set. Mauritz Jeanson: inline.xslMake citations numbered if bibliography.numbered != 0. Robert Stayton: table.xslFixed bug in handling of columns width sum. Robert Stayton: callout.xslFixed missing quote. Robert Stayton: callout.xslChanged param name to callout.icon.size Robert Stayton: param.xweb; param.entAdd new profiling parameters for audience and wordsize. Robert Stayton: callout.xslline break fix Robert Stayton: callout.xslAdd callout.icon.size parameter. Robert Stayton: param.xweb; param.entAdded callout.icon.size parameter. Robert Stayton: inline.xsl; xref.xslAdd support for xlink as olink. Mauritz Jeanson: footnote.xslFixed bug #1669601. Robert Stayton: pagesetup.xslset.flow.properties now strips '-draft' from master name before tests. Robert Stayton: autotoc.xsl; param.xweb; param.entAdd support for qanda.in.toc to fo TOC. Robert Stayton: component.xslImproved the page.sequence utility template for use with book. Robert Stayton: division.xslUse named templates for front and back cover templates. Robert Stayton: division.xslRefactored the big book template into smaller pieces. Used the "page.sequence" utility template in component.xsl to shorten the toc piece. Added placeholder templates for front.cover and back.cover. Jirka Kosek: glossary.xslRules for normalizing glossary entries before they are sorted can be now different for each language. Jirka Kosek: sections.xsluse-attribute-sets is used without prefix on XSLT elements Robert Stayton: component.xslAdjust whitespace. Robert Stayton: param.xweb; param.ent; sections.xslAdd section.container.element parameter to enable pgwide spans inside sections. Robert Stayton: param.xweb; param.ent; component.xslAdd component.titlepage.properties attribute-set to support span="all" and other properties. Mauritz Jeanson: inline.xslFixed #1680755 (keycombo joinchar default incorrect). Mauritz Jeanson: lists.xslCorrected typo in calloutlist template. Robert Stayton: lists.xslFix number test in termlength when NaN. Robert Stayton: htmltbl.xsl; table.xslApply table.row.properties template to html tr rows too. Add keep-with-next to table.row.properties when row is in thead. Jirka Kosek: math.xslMathML must be surrounded by fo:instream-foreign-object Michael(tm) Smith: MakefileRenamed cvstools dir to buildtools, and replaced all references to "cvstools" in makefiles and elsewhere with "buildtools". Robert Stayton: param.xweb; param.entAdd default.table.frame parameter to fo too. Robert Stayton: table.xslAdd support for default.table.frame parameter. Fix bug 1575446 rowsep last check for @morerows. Robert Stayton: refentry.xslAdd support for info/title in refsections. Robert Stayton: xref.xslFixed bug 1652360 empty link with xlink:href. Michael(tm) Smith: MakefilePort from docs-in-db5 branch of all DocBook5-formatted params and all associated build changes needed for building the param.xsl files and docs from them. David Cramer: qandaset.xslMake fo questions and answers behave the same way as html Jirka Kosek: lists.xslAdded missing attribute set for procedure Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent; biblio-iso690.xslAdded support for formatting biblioentries according to ISO690 citation style. New bibliography style can be turned on by setting parameter bibliography.style to "iso690" The code was provided by Jana Dvorakova Robert Stayton: param.xweb; param.ent; pagesetup.xslAdd header.table.properties and footer.table.properties attribute-sets. Robert Stayton: inline.xslAdd fop1.extensions for menuchoice arrow handling exception. Robert Stayton: pagesetup.xslFixed master-name used in axf crop mark template call. Robert Stayton: autotoc.xslMoved the end-indent properties from toc.line to the toc.line.properties attribute-set. Michael(tm) Smith: param.xwebUpdated copyright notices. The following changes have been made to the html code since the 1.72.0 release. Michael(tm) Smith: highlight.xslSet keywords on a number of files. Mauritz Jeanson: titlepage.xslAdded <xsl:call-template name="process.footnotes"/> to abstract template so that footnotes in info/abstract are processed. Closes bug #1760907. Michael(tm) Smith: pi.xsl; synop.xslChanged handling of HTML output for the cmdsynopsis and funcsynopsis elements, such that a@id instances are generated for them if they are descendants of any element containing a dbcmdlist or dbfunclist PI. Also, update the embedded reference docs for the dbcmdlist and dbfunclist PIs to make it clear that they can be used within any element for which cmdsynopsis or funcsynopsis are valid children. Michael(tm) Smith: formal.xslReverted the part of revision 6952 that caused a@id anchors to be generated for output of informal objects. Thanks to Sam Steingold for reporting. Robert Stayton: glossary.xslAccount for a glossary with no glossdiv or glossentry children. Mauritz Jeanson: titlepage.xslModified legalnotice template so that the base.name parameter is calculated in the same way as for revhistory chunks. Using <xsl:apply-templates mode="chunk-filename" select="."/> did not work for single-page output since the template with that mode is in chunk-code.xsl. Mauritz Jeanson: graphics.xslUpdated support for SVG (must be a child of imagedata in DB 5). Added support for MathML in imagedata. Mauritz Jeanson: pi.xslFixed typo. Mauritz Jeanson: inline.xslFixed typo in tests for @xlink:title. Mauritz Jeanson: pi.xslAdded documentation for the dbhh PI (used for context-sensitive HTML Help). (The two templates matching 'dbhh' are still in htmlhelp-common.xsl). Mauritz Jeanson: pi.xslCorrected synopsis of dbhtml-include PI. Mauritz Jeanson: docbook.xsl; highlight.xslReplaced <font> with <span> and/or inline styles. This fixes the problem with <span class="ERROR"> in XHTML (and <font> is deprecated anyway). Closes bug #1715774. Michael(tm) Smith: titlepage.xslFixed test for abstract.notitle.enabled. The way I had it, it was having an effect opposite to its documented effect; that is, it was generating an abstract title only if abstract.notitle.enabled was not zero; but it should actually generate the title only if abstract.notitle.enabled *is* zero. Thanks to Marie Sauvage for testing and reporting this very quickly after 1.73.0 was released. Michael(tm) Smith: xref.xsl; pi.xslMark up PIs with tag@class=xmlpi so that they can get picked up an formatted correctly by the doc build. Mauritz Jeanson: param.xweb; param.entMoved declaration and documentation of javahelp.encoding from javahelp.xsl to the regular "parameter machinery". Michael(tm) Smith: autotoc.xsl; chunk-common.xslFixed a bug that caused broken links in some TOCs. This change affects the code for generating links in HTML output. It adds a new optional "toc.context" parameter to the href.target template, and based on the value of that parameter, handles link-generation in TOCs differently under a certain condition. The gory details: The code now checks to see if the output dir of any file being linked to in a particular TOC is different from the output dir the TOC is written to. If it is different, we do not call the trim.common.uri.paths[1] template. The reason is that, given the following case: 1. we are chunking into separate dirs 2. output for the TOC is written to current dir, but the file being linked to is written to some subdir "foo". For that case, links to that file in that TOC did not show the correct path - they omitted the "foo". The cause of that problem was that the trim.common.uri.paths template was being called under all conditions. But it's apparent that we don't want to call trim.common.uri.paths in the case where a linked file is being written to a different directory than the TOC that contains the link, because doing so will cause a necessary (not redundant) directory-name part of the link to get inadvertently trimmed, resulting in a broken link to that file. Thus, the conditional check was added to catch this case and to handle it differently [1] The purpose of the trim.common.uri.paths template is to prevent cases where, if we didn't call it, we end up with unnecessary, redundant directory names getting output; for example, "foo/foo/refname.html". Michael(tm) Smith: pi.xslShortened some refpurpose text for embedded doc for PIs. Michael(tm) Smith: admon.xslChanged handling of titles for note, warning, caution, important, tip admonitions: We now output and HTML h3 head only if admon.textlabel is non-zero or if the admonition actually contains a title; otherwise, we don't output an h3 head at all. (Previously, we were outputting an empty h3 if the admon.textlabel was zero and if the admonition had no title.) Michael(tm) Smith: pi.xslMake pi.xsl files valid against our litprog grammar. Michael(tm) Smith: .cvsignoreIgnore another build-generated kludge. Yeah, I know it's ridiculous. If you can come up with a prettier way of doing it, all of my riches will be yours. Michael(tm) Smith: pi.xslMake PI source files valid against our litprog schema. Michael(tm) Smith: param.xwebMake *.xweb instances valid against the https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/params/refentry.rnc grammar. Michael(tm) Smith: MakefileMake sure that *template.xml files under version control don't get removed when we clean. Mauritz Jeanson: table.xslFixed bug #1737581 (table.borders.with.css should suppress border attribute). Mauritz Jeanson: xref.xslAdded template for xref to area/areaset. Part of fix for bug #1675513 (xref to area broken). Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; sections.xslAdded fixes to avoid duplicate ids when generate.id.attributes = 1. This (hopefully) closes bug #1671052. Michael(tm) Smith: .cvsignoreIgnore intermediate params file. Michael(tm) Smith: .cvsignore; MakefileSet updated ignore properties and adjusted for fact that shared makefile now expects a "PARAMBASE" value to be specified (to indicate base filename for the type of content being built: either PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce redundancy in the lib build, and just have it use the same makefile "infrastructure" as the param builds for all the param.xsl files. The reason for that is, lib use the same *.xweb system for embedding documentation that the builds for the various output formats use (as opposed to the jrefentry-based system that used for building the template and PI docs in common etc. Michael(tm) Smith: lists.xslAdded doc for the dbchoice choice PI, and fixes some problems with the db* start PI handling. Michael(tm) Smith: pi.xsl; math.xslAdded embedded documentation on the following PIs: - dbhtml_start - dbfo_start - dbtex_delims - dbtimestamp Michael(tm) Smith: pi.xslmade some cleanup to the fo/pi.xsl params doc. Also fixed a couple typos. Michael(tm) Smith: pi.xslCompleting adding all doc for HTML PIs. Added "see also" sections with links to related global params, plus links to DocBook XSL: TCG Also tried out adding some additional doc to param doc for the textinsert.extension param that back-references the PI documentation, plus added some TCG links there too. Michael(tm) Smith: pi.xslAdded doc for the dbhtml img.src.path PI. Michael(tm) Smith: formal.xsl; pi.xslMade the dbfunclist PI work as intended. Also added doc for dbfunclist and dbcmdlist PIs. Michael(tm) Smith: pi.xsl; synop.xslMade the dbcmdlist work the way it appears to have been intended to work. Restored dbhtml-dir template back to pi.xsl. Michael(tm) Smith: lists.xsl; pi.xslfixed WF error and removed duplicate template Michael(tm) Smith: graphics.xslFixed WF error. Michael(tm) Smith: chunk-common.xsl; pi.xslAdd x-ref links from embedded PI doc to sections in Bob's book. Also, moved dbhtml-dir template to chunk-common.xsl file, because it doesn't really belong in the PI file. Michael(tm) Smith: table.xsl; pi.xslConsolidated all PIs for HTML table stuff into wrapper templates in the "master" pi list (html/pi.xsl) and added embedded doc for all of them. May have made some flubs in copying over, so this change may break some table handling. Michael(tm) Smith: pi.xsl; verbatim.xslAdded a verbatim PI that I missed in last commit. Michael(tm) Smith: pi.xsl; synop.xsl; verbatim.xslConsolidated all PIs for HTML synopsis and verbatim stuff into wrapper templates in the "master" pi list (html/pi.xsl) and added embedded doc for all of them. May have made some flubs in copying over, so this change may break some synopsis and verbatim handling. Note: Also added refsee@role=params instances so that we can link to the corresponding global params (if any) for each PI. Michael(tm) Smith: qandaset.xsl; pi.xslConsolidated all PIs for qandaset into wrapper templates in one place (html/pi.xsl) and added embedded doc for all of them. May have made some flubs in copying over, so this change may break some qandaset handling. Michael(tm) Smith: lists.xsl; graphics.xsl; pi.xslConsolidated all PIs for graphics and lists into wrapper templates in one place (html/pi.xsl) and added embedded doc for all of them. May have made some flubs in copying over, so this change may break some graphics and list handling. Michael(tm) Smith: chunktoc.xsl; chunk-code.xsl; pi.xslInitial reorganization of HTML PI processing mechanism. Michael(tm) Smith: titlepage.xsl; param.xweb; param.entAdded new param abstract.notitle.enabled. If non-zero, in output of the abstract element on titlepages, display of the abstract title is suppressed. Because sometimes you really don't want or need that title there... Michael(tm) Smith: chunk-code.xsl; graphics.xslWhen we are chunking long descriptions for mediaobject instances into separate HTML output files, and use.id.as.filename is non-zero, if a mediaobject has an ID, use that ID as the basename for the long-description file (otherwise, we generate an ID for it and use that ID as the basename for the file). The parallels the recent change made to cause IDs for legalnotice instances to be used as basenames for legalnotice chunks. Also, made some minor refinements to the recent changes for legalnotice chunk handling. Michael(tm) Smith: titlepage.xslAdded support to the HTML stylesheets for proper processing of orgname as a child of author. Michael(tm) Smith: chunk-code.xslWhen $generate.legalnotice.link is non-zero and $use.id.as.filename is also non-zero, if a legalnotice has an ID, then instead of assigning the "ln-<generatedID>" basename to the output file for that legalnotice, just use its real ID as the basename for the file -- as we do when chunking other elements that have IDs. Michael(tm) Smith: table.xsl; changebars.xsl; qandaset.xsl; index.xsl; maketoc.xsl; glossa⋯In files that still referred to nwalsh.com URL in the copyright header, changed to docbook.sf.net URL. Michael(tm) Smith: docbook.xslMoved logging template and related templates to separate utility.xsl file so that can be imported without importing the whole common.xsl file (which is necessary for the build and for using the logging template in standalone namespace-stripping because the common.xsl file assumes it will be imported along with all the params, which it can't be when building lib.xsl). Michael(tm) Smith: chunk-code.xsl; docbook.xslUpdated stylesheets to use common logging template to log messages emitted during namespace-stripping. Also, moved pad-string template from lib to common because it's needed in order to use logging template in the profiling stylesheets, and the lib build relies on the profiling apparatus (so the profiling apparatus can't rely on lib being built first...) Michael(tm) Smith: db5strip.xslRemoved the db5strip.xsl stylesheet because it has been obsoleted by the stripns.xsl stylesheet. Michael(tm) Smith: inline.xsl; autoidx-kimber.xsl; biblio-iso690.xsl; autoidx-kosek.xsl; p⋯Removed all "Do not edit this file" admonitions that get output in generated stylesheets; such admonitions have in the past been judged by the free-software police to be at-risk of interpretation as license restrictions. Also, made various updates to work around some funkiness is xsltproc output. David Cramer: xref.xslHandle alt text on xrefs to steps when the step doesn't have a title. David Cramer: lists.xslAdded <p> element around term in variablelist when formatted as table to avoid misalignment of term and listitem in xhtml (non-quirks mode) output David Cramer: qandaset.xslAdded <p> element around question and answer labels to avoid misalignment of label and listitem in xhtml (non-quirks mode) output David Cramer: lists.xslAdded <p> element around callouts to avoid misalignment of callout and listitem in xhtml (non-quirks mode) output Robert Stayton: footnote.xslFixed bug #1717196 footnoteref not finding the right chunk for the target. Robert Stayton: chunk-code.xsl; docbook.xslChanged the comments regarding namespace striping to mention the docbook5 namedspaced stylesheets. Mauritz Jeanson: inline.xslMake citations numbered if bibliography.numbered != 0. Robert Stayton: param.xweb; param.entAdd support for new profiling attributes audience and wordsize. Robert Stayton: inline.xsl; xref.xslAdd support for xlink olinks. Mauritz Jeanson: titlepage.xslFixed bug #1644874. Jirka Kosek: xref.xslDo not output xlink namespace declaration into HTML output Jirka Kosek: profile-chunk.xslSync profiling stylesheet with base stylesheet Jirka Kosek: glossary.xslRules for normalizing glossary entries before they are sorted can be now different for each language. Robert Stayton: inline.xslFix a couple of class attributes. Robert Stayton: titlepage.xslRemove redundant ./ from xpath statements. Mauritz Jeanson: inline.xslFixed #1680755 (keycombo joinchar default incorrect). Mauritz Jeanson: lists.xslCorrected typo in calloutlist template. Robert Stayton: formal.xslSet formal object class value with class.value mode. Robert Stayton: graphics.xslFix bug in contentdepth outputting empty height attribute. Michael(tm) Smith: MakefileRenamed cvstools dir to buildtools, and replaced all references to "cvstools" in makefiles and elsewhere with "buildtools". Robert Stayton: chunk-common.xsl; chunk-code.xsl; manifest.xsl; chunk.xslRefactored the chunking modules to move all named templates to chunk-common.xsl and all match templates to chunk-code.xsl, in order to enable better chunk customization. See the comments in chunk.xsl for more details. Robert Stayton: lists.xslAdd anchor for xml:id for listitem in varlistentry. Robert Stayton: refentry.xslAdd support for info/title in refsections for db5. Robert Stayton: xref.xslFixed bug 1652360 empty link with xlink:href. Robert Stayton: changebars.xslAdd underline style to "added". Michael(tm) Smith: MakefilePort from docs-in-db5 branch of all DocBook5-formatted params and all associated build changes needed for building the param.xsl files and docs from them. Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent; biblio-iso690.xslAdded support for formatting biblioentries according to ISO690 citation style. New bibliography style can be turned on by setting parameter bibliography.style to "iso690" The code was provided by Jana Dvorakova Robert Stayton: callout.xsl; glossary.xsl; annotations.xsl; autoidx.xsl; footnote.xslAdd call to class.attribute on output <a>. Robert Stayton: inline.xsl; xref.xslAdd call to class.attribute to <a> output elements so they can have a class value too. Robert Stayton: html.xslAdd mode=class.value to generate just the value, not the attribute. Michael(tm) Smith: param.xwebUpdated copyright notices. Mauritz Jeanson: glossary.xslFixed bug #1644881: * Added curly braces around all $language attribute values. * Moved declaration of language variable to top level of stylesheet. Tested with Xalan, Saxon, and xsltproc. The following changes have been made to the manpages code since the 1.72.0 release. Michael(tm) Smith: endnotes.xslIn manpages output, generate warnings about notesources with non-para children only if the notesource is a footnote or annotation. Thanks to Sam Steingold for reporting problems with the existing handling. Michael(tm) Smith: synop.xslMade italic handling of Michael(tm) Smith: table.xslProblem: Rows in tables with more than 10 rows get sorted into incorrect order. Cause: Code in manpages table handler does sorting, using xsl:sort, to deal with instances of cells that span multiple rows. But that sorting was being done alphabetically rather than numerically -- the reason being that the default sort method for xsl:sort is "text" (alphabetical). Fix: Added @data-type=number to relevant xsl:sort instances in table code. Closes #1763332. Thanks to kesuke. Michael(tm) Smith: docbook.xslAdded import of common/charmap.xsl to fix problem of calls to missing named templates. Closes #1760697. Thanks to Daniel Leidert. Michael(tm) Smith: param.xweb; docbook.xsl; param.entAdded the man.authors.section.enabled and man.copyright.section.enabled parameters. Set those to zero when you want to suppress display of the auto-generated AUTHORS and COPYRIGHT sections. Closes request #1467806. Thanks to Daniel Leidert. Michael(tm) Smith: info.xslFixed minor typo. Michael(tm) Smith: .cvsignoreIgnore another build-generated kludge. Yeah, I know it's ridiculous. If you can come up with a prettier way of doing it, all of my riches will be yours. Michael(tm) Smith: param.xwebMake *.xweb instances valid against the https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/params/refentry.rnc grammar. Michael(tm) Smith: .cvsignoreIgnore intermediate params file. Michael(tm) Smith: Makefile; .cvsignoreSet updated ignore properties and adjusted for fact that shared makefile now expects a "PARAMBASE" value to be specified (to indicate base filename for the type of content being built: either PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce redundancy in the lib build, and just have it use the same makefile "infrastructure" as the param builds for all the param.xsl files. The reason for that is, lib use the same *.xweb system for embedding documentation that the builds for the various output formats use (as opposed to the jrefentry-based system that used for building the template and PI docs in common etc. Michael(tm) Smith: docbook.xslTook the test that the manpages stylesheet does to see if there are any Refentry chilren in current doc, and made it namespace-agnostic. Reason for that is because the test otherwise won't work when it is copied over into the generated profile-docbook.xsl stylesheet. Michael(tm) Smith: MakefileAdded a manpages/profile-docbook.xsl file to enable single-pass profiling for manpages output. KNOWN ISSUE: Single-pass namespace stripping does not yet work in combination with the manpages/profile-docbook.xsl stylesheet. Michael(tm) Smith: param.xwebIn files that still referred to nwalsh.com URL in the copyright header, changed to docbook.sf.net URL. Michael(tm) Smith: info.xslOutput copyright and legalnotice in man-page output in whatever place they are in in document order. Closes #1690539. Thanks to Daniel Leidert for reporting. Michael(tm) Smith: docbook.xslRestored support for single-pass namespace stripping to manpages stylesheet. Michael(tm) Smith: docbook.xsl; other.xslAdded check to have the manpages stylesheet log/emit an error message if it is given a namespaced DocBook document, with instructions to instead either use the docbook5-xsl stylesheets to directly process the document, or to use the stripns.xsl stylesheet to pre-process it. Michael(tm) Smith: param.xwebRemoved all "Do not edit this file" admonitions that get output in generated stylesheets; such admonitions have in the past been judged by the free-software police to be at-risk of interpretation as license restrictions. Also, made various updates to work around some funkiness is xsltproc output. Michael(tm) Smith: table.xsl; endnotes.xsl; other.xslUpdated manpages logging to work with new-and-improved logging template. Michael(tm) Smith: synop.xsl; block.xsl; info.xsl; inline.xsl; lists.xsl; endnotes.xsl; ut⋯Changed handling of bold and italic/underline output in manpages output. Should be transparent to users, but... This touches handling of all bold and italic/underline output. The exact change is that the mode="bold" and mode="italic" utility templates were changed to named templates. (I think maybe I've changed it back and forth from mode to named before, so this is maybe re-reverting it yet again). Anyway, the reason for the change is that the templates are sometimes call on dynamically node-sets, and using modes to format those doesn't allow passing info about the current/real context node from the source (not the node-set created by the stylesheet) to that formatting stage. The named templates allow the context to be passed in as a parameter, so that the bold/ital formatting template can use context-aware condition checking. This was basically necessary in order to suppress bold formatting in titles, which otherwise gets screwed up because of the numbnut way that roff handles nested bold/ital. Closes #1674534). Much thanks to Daniel Leidert, whose in his docbook-xsl bug-finding kung-fu has achieved Grand Master status. Michael(tm) Smith: block.xslFixed handling of example instances by adding the example element to the same template we use for processing figure. Closes #1674538. Thanks to Daniel Leidert. Michael(tm) Smith: utility.xslDon't include lang in manpages filename/pathname if lang=en (that is, only generate lang-qualified file-/pathnames for non-English). Michael(tm) Smith: endnotes.xslIn manpages output, emit warnings for notesources (footnote, etc.) that have something other than para as a child. The numbered-with-hanging-indent formatting that's used for rendering endnotes in the NOTES section of man pages places some limits/assumptions on how the DocBook source is marked up; namely, for notesources (footnote, annotation, etc.) that can contain block-level children, if the they have a block-level child such as a table or itemizedlist or orderedlist that is the first child of a footnote, we have no way of rendering/indenting its content properly in the endnotes list. Thus, the manpages stylesheet not emits a warning message for that case, and suggests the "fix" (which is to wrap the table or itemizedlist or whatever in a para that has some preferatory text. Michael(tm) Smith: utility.xslAdded support to mixed-block template for handling tables in mixed-blocks (e.g., as child of para) correctly. Michael(tm) Smith: endnotes.xslAdded comment to endnotes code. Michael(tm) Smith: endnotes.xslNormalize text-only endnotes properly. Michael(tm) Smith: utility.xslFixed problem with lang values not getting added to filenames as expected for all cases. Closes #1674564. Thanks to Daniel Leidert for reporting. Michael(tm) Smith: param.xweb; param.ent; other.xsl; utility.xslMade some minor updates to param docs and comments in manpages stylesheet. Also, removed some params for manpages doc that are already doc'ed as HTML params. Michael(tm) Smith: MakefileRenamed cvstools dir to buildtools, and replaced all references to "cvstools" in makefiles and elsewhere with "buildtools". Michael(tm) Smith: table.xsl; synop.xsl; block.xsl; info.xsl; lists.xsl; refentry.xsl; end⋯Reverted necessary escaping of backslash, dot, and dash out of the well-intentioned (but it now appears, misguided) "marker" mechanism (introduced in the 1.72.0 release) -- which made use of alternative "marker" characters as internal representations of those characters, and then replaced them just prior to serialization -- and back into what's basically the system that was used prior to the 1.69.0 release; that is, into a part of stylesheet code that gets executed at the beginning of processing -- before any other roff markup up is. This change obviates the need for the marker system. It also requires a lot less RAM during processing (for large files, the marker mechanism ending up requiring gigabytes of memory). Closes bug #1661177. Thanks to Scott Smedley for providing a test case (the fvwm man page) that exposed the problem with the marker mechanism. Also moved the mechanism for converting non-breaking spaces back into the same area of the stylesheet code. Michael(tm) Smith: lists.xslFixed problem with incorrect formatting of nested variablelist. Closes bug #1650931. Thanks to Daniel "Eagle Eye" Leidert. Michael(tm) Smith: MakefilePort from docs-in-db5 branch of all DocBook5-formatted params and all associated build changes needed for building the param.xsl files and docs from them. Michael(tm) Smith: lists.xslMake sure that all listitems in itemizedlist and orderedlist are preceded by a blank line. This fixes a regression that occurred when instances of the TP macro that were use in a previous versions of the list-handling code were switched to RS/RE (because TP doesn't support nesting). TP automatically generates a blank line, but RS doesn't. So I added a .sp before each .RS Michael(tm) Smith: endnotes.xsl; links.xsl; docbook.xslRenamed links.xsl to endnotes.xsl. Michael(tm) Smith: block.xsl; inline.xsl; param.xweb; docbook.xsl; links.xsl; param.entMade a number of changes related to elements with out-of-line content: - Added handling for mediaobject & inlinemedidaobject. Each imagedata, audiodata, or videodata element within a mediaobject or inline mediaobject is now treated as a "notesource" and so handled in much the same way as links and annotation/alt/footnotes. That means a numbered marker is generated inline to mark the place in the main flow where the imagedata, audiodata, or videodata element occurs, and a corresponding numbered endnote for it is generated in the endnotes list at the end of the man page; the endnote contains the URL from the fileref attribute of the imagedata, audiodata, or videodata element. For mediobject and inlinemediaobject instances that have a textobject child, the textobject is displayed within the main text flow. - Renamed several man.link.* params to man.endnotes.*, to reflect that fact that the endnotes list now contains more than just links. Also did similar renaming for a number of stylesheet-internal vars. - Added support for xlink:href (along with existing support for the legacy ulink element). - Cleaned up and streamlined the endnotes-handling code. It's still messy and klunky and the basic mechanism it uses is very inefficent for documents that contain a lot of notesources, but at least it's a bit better than it was. Michael(tm) Smith: param.xwebUpdated copyright notices. The following changes have been made to the htmlhelp code since the 1.72.0 release. Mauritz Jeanson: htmlhelp-common.xslMoved the raw.help.title and help.title variables to the hhp-main template to make sure a value is assigned after the namespace-stripping has been done. This prevents "Request for title of element with no title" errors. Added "//db:indexterm[1]|//ng:indexterm[1]" to the select expression of the global htmlhelp.generate.index parameter, so that an index can be built for both DB 4 and DB 5/NG documents (it's a little ugly, but a value needs to be assigned somehow). Michael(tm) Smith: htmlhelp-common.xslAdded single-pass namespace-stripping support to the htmlhelp, eclipse, and javahelp stylesheets. Michael(tm) Smith: MakefileTweaked some makefiles to bring them into consistency with other makefiles in the build. Michael(tm) Smith: MakefileRenamed cvstools dir to buildtools, and replaced all references to "cvstools" in makefiles and elsewhere with "buildtools". The following changes have been made to the eclipse code since the 1.72.0 release. Mauritz Jeanson: eclipse.xslAdded "db" and "ng" to exclude-result-prefixes. Michael(tm) Smith: eclipse.xslAdded single-pass namespace-stripping support to the htmlhelp, eclipse, and javahelp stylesheets. Michael(tm) Smith: eclipse.xslIn files that still referred to nwalsh.com URL in the copyright header, changed to docbook.sf.net URL. Michael(tm) Smith: MakefileTweaked some makefiles to bring them into consistency with other makefiles in the build. Michael(tm) Smith: .cvsignoreIgnore the eclipse generated profile stylesheet. Mauritz Jeanson: MakefileFixed bug #1715093: Makefile for creating profiled version of eclipse.xsl added. David Cramer: eclipse.xslAdded normalize-space around to avoid leading whitespace from appearing in the output if there's extra leading whitespace (e.g. <title> Foo</title>) in the source The following changes have been made to the javahelp code since the 1.72.0 release. Michael(tm) Smith: javahelp.xslAdded single-pass namespace-stripping support to the htmlhelp, eclipse, and javahelp stylesheets. Mauritz Jeanson: javahelp.xslMoved declaration and documentation of javahelp.encoding from javahelp.xsl to the regular "parameter machinery". Michael(tm) Smith: javahelp.xslIn files that still referred to nwalsh.com URL in the copyright header, changed to docbook.sf.net URL. Michael(tm) Smith: MakefileTweaked some makefiles to bring them into consistency with other makefiles in the build. Mauritz Jeanson: javahelp.xslImplemented FR #1230233 (sorted index in javahelp). Mauritz Jeanson: javahelp.xslAdded normalize-space() around titles and index entries to work around whitespace problems. Added support for glossary and bibliography in toc and map files. Michael(tm) Smith: MakefileRenamed cvstools dir to buildtools, and replaced all references to "cvstools" in makefiles and elsewhere with "buildtools". The following changes have been made to the roundtrip code since the 1.72.0 release. Michael(tm) Smith: blocks2dbk.xsl; wordml2normalise.xsl; normalise2sections.xsl; sections2⋯Set keywords on a number of files. Michael(tm) Smith: pages2normalise.xslRemoved executable property from roundtrip/pages2normalise.xsl file. Thanks to Daniel Leidert for reporting. Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; pages2normalise.xslModularised blocks2dbk to allow customisation, Added support for tables to pages2normalise Michael(tm) Smith: .cvsignoreIgnore another build-generated kludge. Yeah, I know it's ridiculous. If you can come up with a prettier way of doing it, all of my riches will be yours. Michael(tm) Smith: param.xwebMake *.xweb instances valid against the https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/params/refentry.rnc grammar. Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl; normalise2sections.xsl; sections2blocks.⋯new stylesheets for better word processor support and easier maintenance Michael(tm) Smith: .cvsignoreIgnore intermediate params file. Michael(tm) Smith: .cvsignore; MakefileSet updated ignore properties and adjusted for fact that shared makefile now expects a "PARAMBASE" value to be specified (to indicate base filename for the type of content being built: either PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce redundancy in the lib build, and just have it use the same makefile "infrastructure" as the param builds for all the param.xsl files. The reason for that is, lib use the same *.xweb system for embedding documentation that the builds for the various output formats use (as opposed to the jrefentry-based system that used for building the template and PI docs in common etc. Michael(tm) Smith: param.xweb; dbk2wordml.xsl; pages-normalise.xsl; dbk2pages.xsl; docbook⋯In files that still referred to nwalsh.com URL in the copyright header, changed to docbook.sf.net URL. Michael(tm) Smith: param.xweb; wordml-blocks.xsl; wordml-sections.xslRemoved all "Do not edit this file" admonitions that get output in generated stylesheets; such admonitions have in the past been judged by the free-software police to be at-risk of interpretation as license restrictions. Also, made various updates to work around some funkiness is xsltproc output. Steve Ball: template-pages.xml; dbk2wp.xsl; sections-spec.xmlfixed bugs Michael(tm) Smith: MakefileRenamed cvstools dir to buildtools, and replaced all references to "cvstools" in makefiles and elsewhere with "buildtools". Michael(tm) Smith: MakefilePort from docs-in-db5 branch of all DocBook5-formatted params and all associated build changes needed for building the param.xsl files and docs from them. Michael(tm) Smith: param.xwebUpdated copyright notices. The following changes have been made to the slides code since the 1.72.0 release. Jirka Kosek: html/slides-common.xslFixed wrong template name Michael(tm) Smith: fo/param.xweb; html/param.xwebMade some changes to ID values in slides doc source, in order to give us more rational filenames in HTML output of the docs. Michael(tm) Smith: fo; html; fo/.cvsignore; html/.cvsignoreIgnore another build-generated kludge. Yeah, I know it's ridiculous. If you can come up with a prettier way of doing it, all of my riches will be yours. Michael(tm) Smith: fo/param.xweb; html/param.xwebMake *.xweb instances valid against the https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/params/refentry.rnc grammar. Michael(tm) Smith: fo/MakefileMake sure that *template.xml files under version control don't get removed when we clean. Michael(tm) Smith: fo; html; fo/.cvsignore; html/.cvsignoreIgnore intermediate params file. Michael(tm) Smith: fo; html; fo/.cvsignore; fo/Makefile; html/.cvsignore; html/MakefileSet updated ignore properties and adjusted for fact that shared makefile now expects a "PARAMBASE" value to be specified (to indicate base filename for the type of content being built: either PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce redundancy in the lib build, and just have it use the same makefile "infrastructure" as the param builds for all the param.xsl files. The reason for that is, lib use the same *.xweb system for embedding documentation that the builds for the various output formats use (as opposed to the jrefentry-based system that used for building the template and PI docs in common etc. Michael(tm) Smith: fo/param.xweb; html/param.xwebIn files that still referred to nwalsh.com URL in the copyright header, changed to docbook.sf.net URL. Michael(tm) Smith: html/param.xweb; fo/param.xwebRemoved all "Do not edit this file" admonitions that get output in generated stylesheets; such admonitions have in the past been judged by the free-software police to be at-risk of interpretation as license restrictions. Also, made various updates to work around some funkiness is xsltproc output. Michael(tm) Smith: fo/plain.xsl; Makefile; html/slides-common.xslMade some further adjustments to cause slides/fo and slides/html param builds to work correctly. Michael(tm) Smith: fo; html; Makefile; fo/.cvsignore; fo/Makefile; html/.cvsignore; html/M⋯Made changes to cause build of separate slides/fo/param.xsl and slides/html/param.xsl files, and updated doc build to handle that split. Also updated build of ChangeLog.xml, NEWS file and RELEASE-NOTES.{html,txt,pdf} builds to include slides and website changes. Closes bug #1671745. Thanks to Justus Piater. Michael(tm) Smith: Makefile; doc/Makefile; Makefile; fo/Makefile; demo/frames2/Makefile; d⋯Renamed cvstools dir to buildtools, and replaced all references to "cvstools" in makefiles and elsewhere with "buildtools". Michael(tm) Smith: param.xweb; Makefile; param.ent; fo/Makefile; .cvsignore; fo/plain.xslPort from docs-in-db5 branch of all DocBook5-formatted params and all associated build changes needed for building the param.xsl files and docs from them. Michael(tm) Smith: graphics; browser; xsl; graphics; browserMoved slides and website stylesheets into xsl tree. They have shipped as part of xsl for the last three releases now, just been getting pulled in as part of the build. Now that we're using svn, it's trivial to actually move them in (and to move them back out if we need to). The following changes have been made to the website code since the 1.72.0 release. Michael(tm) Smith: param.xwebPut website docs into categories. Michael(tm) Smith: .cvsignoreIgnore another build-generated kludge. Yeah, I know it's ridiculous. If you can come up with a prettier way of doing it, all of my riches will be yours. Michael(tm) Smith: param.xwebMake *.xweb instances valid against the https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/params/refentry.rnc grammar. Michael(tm) Smith: .cvsignoreIgnore intermediate params file. Michael(tm) Smith: Makefile; .cvsignoreSet updated ignore properties and adjusted for fact that shared makefile now expects a "PARAMBASE" value to be specified (to indicate base filename for the type of content being built: either PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce redundancy in the lib build, and just have it use the same makefile "infrastructure" as the param builds for all the param.xsl files. The reason for that is, lib use the same *.xweb system for embedding documentation that the builds for the various output formats use (as opposed to the jrefentry-based system that used for building the template and PI docs in common etc. Michael(tm) Smith: xbel.xsl; website.xsl; website-common.xslIn files that still referred to nwalsh.com URL in the copyright header, changed to docbook.sf.net URL. Michael(tm) Smith: param.xwebRemoved all "Do not edit this file" admonitions that get output in generated stylesheets; such admonitions have in the past been judged by the free-software police to be at-risk of interpretation as license restrictions. Also, made various updates to work around some funkiness is xsltproc output. Michael(tm) Smith: Makefile; schema/dtd/Makefile; schema/relaxng/Makefile; MakefileRenamed cvstools dir to buildtools, and replaced all references to "cvstools" in makefiles and elsewhere with "buildtools". Michael(tm) Smith: Makefile; .cvsignore; param.xweb; param.entPort from docs-in-db5 branch of all DocBook5-formatted params and all associated build changes needed for building the param.xsl files and docs from them. Michael(tm) Smith: xslMoved slides and website stylesheets into xsl tree. They have shipped as part of xsl for the last three releases now, just been getting pulled in as part of the build. Now that we're using svn, it's trivial to actually move them in (and to move them back out if we need to). The following changes have been made to the params code since the 1.72.0 release. Mauritz Jeanson: callout.unicode.number.limit.xml; compact.list.item.spacing.xml; ulink.sh⋯A few small parameter fixes. Mauritz Jeanson: saxon.character.representation.xmlEmphasized that the parameter only works with Saxon 6. Fixed reference to chunker.output.encoding. Mauritz Jeanson: highlight.source.xmlChanged uri to link. Mauritz Jeanson: htmlhelp.show.advanced.search.xmlReworded refpurpose. Mauritz Jeanson: tex.math.delims.xmlReworded refpurpose. Mauritz Jeanson: img.src.path.xmlFixed typos. Mauritz Jeanson: autotoc.label.in.hyperlink.xml; annotation.graphic.open.xml; highlight.so⋯Some small fixes. Mauritz Jeanson: passivetex.extensions.xmlUpdated URL, added note. Mauritz Jeanson: make.year.ranges.xmlAdded inline markup. Mauritz Jeanson: highlight.source.xmlSome recasting of the documentation. Mauritz Jeanson: funcsynopsis.decoration.xml; funcsynopsis.style.xmlChanged element names to lowercase. Mauritz Jeanson: index.prefer.titleabbrev.xmlAdded a description. Mauritz Jeanson: function.parens.xmlFixed typos. Robert Stayton: procedure.properties.xmlprocedure was inheriting keep-together from formal.object.properties, but a procedure does not need to be kept together by default. Mauritz Jeanson: htmlhelp.show.favorities.xmlCorrected refpurpose and description. (The name of this parameter is misspelt, but I'm ignoring that for now. The HTML Help section in TCG has the correct spelling, btw.) Mauritz Jeanson: htmlhelp.use.hhk.xmlUpdated refpurpose and description; added TCG link. Mauritz Jeanson: htmlhelp.enumerate.images.xml; htmlhelp.hhc.width.xml; htmlhelp.hhc.show.⋯More clarifications and wording tweaks. Mauritz Jeanson: htmlhelp.show.menu.xmlTweaked wording (note that the parameter controls the display of a menu bar, not a menu). Dave Pawson: javahelp.encoding.xmlTidy up of javahelp.encoding.xml Michael(tm) Smith: reference.autolabel.xmlFixed wording in embedded doc for reference.autolabel param. Michael(tm) Smith: olink.fragid.xmlRestored equal sign in default value of olink.fragid param. Michael(tm) Smith: html.longdesc.xmlRestored tag markup around textobject in html.longdesc param doc. Michael(tm) Smith: default.table.width.xmlRemoved some invalid markup in the default.table.width param doc. Michael(tm) Smith: olink.resolver.xmlRestored leading "/" in default value of the olink.resolver param. Michael(tm) Smith: textinsert.extension.xmlThe textinsert.extension parameter really does just enable the textinsert extension (that is, it's not the parameter that inserts the contents of external files - textinsert extension element does). Michael(tm) Smith: htmlhelp.force.map.and.alias.xmlFixed typo (contex.h -> context.h) in htmlhelp.force.map.and.alias param docs. Michael(tm) Smith: emphasis.propagates.style.xmlRestored tag markup on emphasis element in the emphasis.propagates.style doc. Michael(tm) Smith: nominal.image.width.xmlReverted the r7131 change to the value of the nominal.image.width param (the value is an literal expression that's meant to be evaluated, not a string expression. Michael(tm) Smith: htmlhelp.button.jump1.xmlFixed "Jump2" typo (should be "Jump1") Michael(tm) Smith: htmlhelp.map.file.xmlDefault value appears to actually be context.h Michael(tm) Smith: id.warnings.xmlDefault for id.warnings is not actually for them not to be emitted. Michael(tm) Smith: chunker.output.cdata-section-elements.xml; chunker.output.standalone.xm⋯Restored necessary ".frag" in IDs of src:fragment instances in chunker.output.* param files. Michael(tm) Smith: dry-run.xmlRestored necessary ".frag" part to ID on scr:fragment Dave Pawson: title.font.family.xml; component.label.includes.part.label.xml; table.frame.b⋯Regular formatting re-org. Michael(tm) Smith: abstract.notitle.enabled.xmlMinor clean-up of abstract.notitle.enabled.xml to make it follow proper convention for default values for booleans. Also, added abstract.notitle.enabled=1 to stylesheet we use for building the reference docs for the distro (I though it was there and in fact claimed that it was there, but, well, I guess I was wrong/drunk/lying...) Mauritz Jeanson: htmlhelp.only.xmlFixed refpurpose wording. Michael(tm) Smith: man.authors.section.enabled.xml; man.copyright.section.enabled.xmlAdded the man.authors.section.enabled and man.copyright.section.enabled parameters. Set those to zero when you want to suppress display of the auto-generated AUTHORS and COPYRIGHT sections. Closes request #1467806. Thanks to Daniel Leidert. Michael(tm) Smith: tex.math.file.xmlFixed typo. Michael(tm) Smith: variablelist.as.table.xml; variablelist.as.blocks.xml; glossary.as.bloc⋯Mark up PIs with tag@class=xmlpi so that they can get picked up an formatted correctly by the doc build. Mauritz Jeanson: htmlhelp.button.back.xml; htmlhelp.button.forward.xml; htmlhelp.button.zo⋯Modified refpurpose text. Mauritz Jeanson: htmlhelp.map.file.xml; htmlhelp.force.map.and.alias.xml; htmlhelp.alias.f⋯Fixed typos, made some small changes. Mauritz Jeanson: javahelp.encoding.xmlMoved declaration and documentation of javahelp.encoding from javahelp.xsl to the regular "parameter machinery". Mauritz Jeanson: generate.id.attributes.xmlAdded refpurpose text. Mauritz Jeanson: annotation.js.xml; annotation.graphic.open.xml; annotation.graphic.close.⋯Added better refpurpose texts. Mauritz Jeanson: index.on.type.xmlAdded two more class="attribute". Michael(tm) Smith: chunker.output.cdata-section-elements.xml; chunker.output.doctype-syste⋯Corrected duplicate ID problem introduced in previous commit. Michael(tm) Smith: chunker.output.cdata-section-elements.xml; chunker.output.standalone.xm⋯Fixed some broken formatting in source files for chunker.* params, as pointed out by Dave Pawson. Michael(tm) Smith: use.embed.for.svg.xml; generate.meta.abstract.xmlReverted addition of tag@role=html markup. It's no longer necessary, because the doc build now has a smarter way of distinguishing between DocBook elements marked up with the tag element, and non-DocBook elements marked up with such. Michael(tm) Smith: label.from.part.xmlChanged handling of reference auto-labeling such that reference (when it appears at the component level) is now affected by the label.from.part param, just as preface, chapter, and appendix. Mauritz Jeanson: callout.graphics.extension.xmlClarified that 'extension' refers to file names. Mauritz Jeanson: section.title.level2.properties.xml; section.title.level3.properties.xml;⋯Fixed level number in refpurpose. Mauritz Jeanson: index.on.role.xmlAdded class="attribute" markup. Mauritz Jeanson: show.comments.xmlThe comment element was renamed to remark in DB 4.0. Mauritz Jeanson: keep.relative.image.uris.xmlFixed typo. Mauritz Jeanson: use.embed.for.svg.xml; generate.meta.abstract.xml; index.on.type.xmlAdded role/class attributes on some <tag>s to prevent generation of TDG links for DocBook attributes and HTML elements. Michael(tm) Smith: tex.math.file.xml; tex.math.in.alt.xml; tex.math.delims.xmlAdded embedded documentation on the following PIs: - dbhtml_start - dbfo_start - dbtex_delims - dbtimestamp Michael(tm) Smith: textinsert.extension.xmlCompleting adding all doc for HTML PIs. Added "see also" sections with links to related global params, plus links to DocBook XSL: TCG Also tried out adding some additional doc to param doc for the textinsert.extension param that back-references the PI documentation, plus added some TCG links there too. Michael(tm) Smith: abstract.notitle.enabled.xmlAdded new param abstract.notitle.enabled. If non-zero, in output of the abstract element on titlepages, display of the abstract title is suppressed. Because sometimes you really don't want or need that title there... Michael(tm) Smith: man.string.subst.map.xmlOutput copyright and legalnotice in man-page output in whatever place they are in in document order. Closes #1690539. Thanks to Daniel Leidert for reporting. Michael(tm) Smith: man.string.subst.map.xmlUpdated manpages string-substitute map to reflect fact that because of another recent change to suppress bold markup in .SH output, we no longer need to add a workaround for the accidental uppercasing of roff escapes that occurred previously. Jirka Kosek: margin.note.float.type.xml; title.font.family.xml; table.frame.border.color.x⋯Improved parameter metadata Robert Stayton: index.div.title.properties.xmlFixed repeated space-before.optimum Robert Stayton: profile.wordsize.xml; profile.audience.xmlAdd support for profiling on new attributes audience and wordsize. Robert Stayton: callout.graphics.number.limit.xml; callout.graphics.extension.xmlAdded SVG graphics for fo output. Robert Stayton: callout.icon.size.xmlSet size of callout graphics. Robert Stayton: callout.bug.size.xmlReplaced with new name. Robert Stayton: callout.bug.size.xmlControl size of graphical callout bugs in FO output. Jirka Kosek: default.units.xml; chunker.output.method.xml; toc.list.type.xml; output.inden⋯Updated parameter metadata to the new format. Jirka Kosek: man.output.quietly.xml; title.font.family.xml; footnote.sep.leader.properties⋯Added type annotations into parameter definition files. Robert Stayton: section.container.element.xmlSupport spans in sections for certain processors. Robert Stayton: component.titlepage.properties.xmlEmpty attribute set for top level component titlepage block. Allows setting a span on title info. Jirka Kosek: bibliography.style.xmlAdded link to WiKi page with description of special markup needed for ISO690 biblioentries Michael(tm) Smith: man.string.subst.map.xmlMade some minor updates to param docs and comments in manpages stylesheet. Also, removed some params for manpages doc that are already doc'ed as HTML params. Robert Stayton: make.year.ranges.xmlClarify that multiple year elements are required. Michael(tm) Smith: man.string.subst.map.xmlReverted necessary escaping of backslash, dot, and dash out of the well-intentioned (but it now appears, misguided) "marker" mechanism (introduced in the 1.72.0 release) -- which made use of alternative "marker" characters as internal representations of those characters, and then replaced them just prior to serialization -- and back into what's basically the system that was used prior to the 1.69.0 release; that is, into a part of stylesheet code that gets executed at the beginning of processing -- before any other roff markup up is. This change obviates the need for the marker system. It also requires a lot less RAM during processing (for large files, the marker mechanism ending up requiring gigabytes of memory). Closes bug #1661177. Thanks to Scott Smedley for providing a test case (the fvwm man page) that exposed the problem with the marker mechanism. Also moved the mechanism for converting non-breaking spaces back into the same area of the stylesheet code. Robert Stayton: id.warnings.xmlTurn off id.warnings by default. Michael(tm) Smith: title.font.family.xml; toc.line.properties.xml; component.label.include⋯Port from docs-in-db5 branch of all DocBook5-formatted params and all associated build changes needed for building the param.xsl files and docs from them. Michael(tm) Smith: man.string.subst.map.xmlFixed typo in param file. Jirka Kosek: bibliography.style.xmlAdded support for formatting biblioentries according to ISO690 citation style. New bibliography style can be turned on by setting parameter bibliography.style to "iso690" The code was provided by Jana Dvorakova Robert Stayton: header.table.properties.xml; footer.table.properties.xmlSupport adding table properties to header and footer tables. Michael(tm) Smith: man.string.subst.map.xmlPut custom "substitution" element in params/man.string.subst.map.xml into a namespace. Michael(tm) Smith: editedby.enabled.xmlRemoved stray text that was causing WF error. Michael(tm) Smith: man.links.are.underlined.xml; man.endnotes.list.enabled.xml; man.links.⋯Made a number of changes related to elements with out-of-line content: - Added handling for mediaobject & inlinemedidaobject. Each imagedata, audiodata, or videodata element within a mediaobject or inline mediaobject is now treated as a "notesource" and so handled in much the same way as links and annotation/alt/footnotes. That means a numbered marker is generated inline to mark the place in the main flow where the imagedata, audiodata, or videodata element occurs, and a corresponding numbered endnote for it is generated in the endnotes list at the end of the man page; the endnote contains the URL from the fileref attribute of the imagedata, audiodata, or videodata element. For mediobject and inlinemediaobject instances that have a textobject child, the textobject is displayed within the main text flow. - Renamed several man.link.* params to man.endnotes.*, to reflect that fact that the endnotes list now contains more than just links. Also did similar renaming for a number of stylesheet-internal vars. - Added support for xlink:href (along with existing support for the legacy ulink element). - Cleaned up and streamlined the endnotes-handling code. It's still messy and klunky and the basic mechanism it uses is very inefficent for documents that contain a lot of notesources, but at least it's a bit better than it was. Robert Stayton: toc.line.properties.xmlMoved the end-indent properties from toc.line to the toc.line.properties attribute-set. Robert Stayton: xep.index.item.properties.xmlFixed case of class attribute in sgmltag element. The following changes have been made to the highlighting code since the 1.72.0 release. Michael(tm) Smith: common.xslSet keywords on a number of files. Michael(tm) Smith: common.xslIn files that still referred to nwalsh.com URL in the copyright header, changed to docbook.sf.net URL. Jirka Kosek: c-hl.xml; xslthl-config.xmlAdded support for C language. Provided by Bruno Guegan. The following changes have been made to the profiling code since the 1.72.0 release. Mauritz Jeanson: xsl2profile.xslFixed bug that affected Eclipse profiling. "etoc" was added as a named template to be processed in "correct" mode. Michael(tm) Smith: xsl2profile.xslUpdated stylesheets to use common logging template to log messages emitted during namespace-stripping. Also, moved pad-string template from lib to common because it's needed in order to use logging template in the profiling stylesheets, and the lib build relies on the profiling apparatus (so the profiling apparatus can't rely on lib being built first...) Michael(tm) Smith: xsl2profile.xslRemoved all "Do not edit this file" admonitions that get output in generated stylesheets; such admonitions have in the past been judged by the free-software police to be at-risk of interpretation as license restrictions. Also, made various updates to work around some funkiness is xsltproc output. Robert Stayton: profile-mode.xslAdd support for new profiling attributes audience and wordsize. Robert Stayton: profile.xslAdd new profiling attributes audience and wordsize. The following changes have been made to the lib code since the 1.72.0 release. Michael(tm) Smith: lib.xwebMoved charmap templates out of lib.xweb and into common/charmap.xsl, and added charmap doc to doc build. Michael(tm) Smith: lib.xwebMake structure of lib.xweb embedded doc consistent with structure of similar embedded doc in other source files. Michael(tm) Smith: lib.xwebMake lib.xweb valid against our litprog grammar. Michael(tm) Smith: .cvsignoreIgnore another build-generated kludge. Yeah, I know it's ridiculous. If you can come up with a prettier way of doing it, all of my riches will be yours. Michael(tm) Smith: lib.xwebMake *.xweb instances valid against the https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/params/refentry.rnc grammar. Michael(tm) Smith: lib.xwebUpdated embedded doc in XSL source files: - added dbhtml@dir PIs to control where output goes when generation HTML version of docs - put xml:id instances on root elements of embedded doc - changed all *info instances to just info (DocBook 5) and some @id instance to @xml-id Michael(tm) Smith: .cvsignoreUpdated ignore properties on lib dir Michael(tm) Smith: .cvsignoreSet updated ignore properties and adjusted for fact that shared makefile now expects a "PARAMBASE" value to be specified (to indicate base filename for the type of content being built: either PARAMBASE=param or PARAMBASE=lib; this makes it possible to reduce redundancy in the lib build, and just have it use the same makefile "infrastructure" as the param builds for all the param.xsl files. The reason for that is, lib use the same *.xweb system for embedding documentation that the builds for the various output formats use (as opposed to the jrefentry-based system that used for building the template and PI docs in common etc. Michael(tm) Smith: MakefileMade the lib build make reuse of the same makefile infrastructure now used for param builds. Michael(tm) Smith: MakefileAdded a mechanism for "building" copies of the w2docbook.xsl, ldocbook.xsl, cldocbook.xs