Foo

wrapper around output of contents of all formal objects. Also, added an optional
linebreak after all formal objects. WARNING: Because this change places an additional DIV between the DIV wrapper for the equation and the equation contents, it may break some existing CSS stylesheets that have been created with the assumption that there would never be an intervening DIV there. The following is an example of what Equation output looks like as a result of the changes described above.

(1.3)

1+1=3

Rationale: These changes allow CSS control of the placement of the formal-object title relative to the formal-object contents. For example, using the CSS "float" property enables the title and contents to be rendered on the same line. Example stylesheet: .equation { margin-top: 20px; margin-bottom: 20px; } .equation-contents { float: left; } .equation .title { margin-top: 0; float: right; margin-right: 200px; } .equation .title b { font-weight: normal; } .equation-break { clear: both; } Note that the purpose of the ".equation-break" class is to provide a way to clear off the floats. If you want to instead have the equation title rendered to the left of the equation contents, you can do something like this: .equation { margin-top: 20px; width: 300px; margin-bottom: 20px; } .equation-contents { float: right; } .equation .title { margin-top: 0; float: left; margin-right: 200px; } .equation .title b { font-weight: normal; } .equation-break { clear: both; } Modified: html/formal.xsl,1.20 - Michael(tm) Smith * Added a chunker.output.quiet top-level parameter so that the chunker can be made quiet by default Modified: html/chunker.xsl,1.26 - Norman Walsh * Added support for link, olink, and xref within OO Classsynopsis and children. (Because DocBook NG/5 allows it). Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) Smith * New parameter: id.warnings. If non-zero, warnings are generated for titled objects that don't have titles. True by default; I wonder if this will be too aggressive? Modified: html/biblio.xsl,1.25; html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19; html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16; html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22; html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman Walsh * If the keep.relative.image.uris parameter is true, don't use the absolute URI (as calculated from xml:base) in the img src attribute, us the value the author specified. Note that we still have to calculate the absolute filename for use in the image intrinsics extension. Modified: html/graphics.xsl,1.56 - Norman Walsh * Support date as an inline Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman Walsh * Added new parameter keep.relative.image.uris Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh * Added two new parameters for handling of multi-term varlistentry elements: variablelist.term.break.after: When the variablelist.term.break.after is non-zero, it will generate a line break after each term multi-term varlistentry. variablelist.term.separator: When a varlistentry contains multiple term elements, the string specified in the value of the variablelist.term.separator parameter is placed after each term except the last. The default is ", " (a comma followed by a space). To suppress rendering of the separator, set the value of variablelist.term.separator to the empty string (""). These parameters are primarily intended to be useful if you have multi-term varlistentries that have long terms. Closes #1306676. Thanks to Sam Steingold for providing an example "lots of long terms" doc that demonstrated the value of having these options. Also, added normalize-space() call to processing of each term. This change affects all output formats (HTML, PDF, manpages). The default behavior should pretty much remain the same as before, but it is possible (as always) that the change may introduce some new bugginess. Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/variablelist.term.break.after.xml,1.1; params/variablelist.term.separator.xml,1.1 - Michael(tm) Smith * Added "wrapper-name" param to inline.charseq named template, enabling it to output inlines other than just "span". Acronym and Abbrev templates now use inline.charseq to output HTML "acronym" and "abbr" elements (instead of "span"). Closes #1305468. Thanks to Sam Steingold for suggesting the change. Modified: html/inline.xsl,1.45 - Michael(tm) Smith Manpages The following changes have been made to the manpages code since the 1.69.1 release. * Added the following params: - man.indent.width (string-valued) - man.indent.refsect (boolean) - man.indent.blurbs (boolean) - man.indent.lists (boolean) - man.indent.verbatims (boolean) Note that in earlier snapshots, man.indent.width was named man.indentation.default.value and the boolean params had names like man.indentation.*.adjust. Also the man.indent.blurbs param was called man.indentation.authors.adjust (or something). The behavior now is: If the value of a particular man.indent.* boolean param is non-zero, the corresponding contents (refsect*, list items, authorblurb/personblurb, vervatims) are displayed with a left margin indented by a width equal to the value of man.indent.width. Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74; manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20; manpages/param.ent,1.22; manpages/param.xweb,1.24; manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1; params/man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 - Michael(tm) Smith * Added man.table.footnotes.divider param. In each table that contains footenotes, the string specified by the man. table.footnotes.divider parameter is output before the list of footnotes for the table. Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; manpages/param.ent,1.21; manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith * Added the man.output.in.separate.dir, man.output.base.dir, and man.output.subdirs.enabled parameters. The man.output.base.dir parameter specifies the base directory into which man-page files are output. The man.output.subdirs.enabled parameter controls whether the files are output in subdirectories within the base directory. The values of the man.output.base.dir and man.output.subdirs.enabled parameters are used only if the value of man.output.in.separate.dir parameter is non-zero. If the value of man.output.in.separate.dir is zero, man-page files are not output in a separate directory. Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1; params/man.output.in.separate.dir.xml,1.1; params/man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith * Added man.font.table.headings and man.font.table.title params, for controlling font in table headings and titles. Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1; params/man.font.table.title.xml,1.1 - Michael(tm) Smith * Added man.font.funcsynopsisinfo and man.font.funcprototype params, for specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and funcprototype output. Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; manpages/param.ent,1.18; manpages/param.xweb,1.20; manpages/synop.xsl,1.29; manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1; params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith * Added man.segtitle.suppress param. If the value of man.segtitle.suppress is non-zero, then display of segtitle contents is suppressed in output. Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - Michael(tm) Smith * Added man.output.manifest.enabled and man.output.manifest.filename params. If man.output.manifest.enabled is non-zero, a list of filenames for man pages generated by the stylesheet transformation is written to the file named by man.output.manifest.filename Modified: manpages/docbook.xsl,1.67; manpages/other.xsl,1.19; manpages/param.ent,1.16; manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1; params/man.output.manifest.filename.xml,1.1; tools/make/Makefile.DocBook,1.4 - Michael(tm) Smith * Added refentry.meta.get.quietly param. If zero (the default), notes and warnings about "missing" markup are generated during gathering of refentry metadata. If non-zero, the metadata is gathered "quietly" -- that is, the notes and warnings are suppressed. NOTE: If you are processing a large amount of refentry content, you may be able to speed up processing significantly by setting a non-zero value for refentry.meta.get.quietly. Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm) Smith * Changed names of all boolean indentation params to man.indent.* Also discarded individual man.indent.*.value params and switched to just using a common man.indent.width param (3n by default). Modified: manpages/docbook.xsl,1.66; manpages/info.xsl,1.19; manpages/lists.xsl,1.29; manpages/other.xsl,1.18; manpages/refentry.xsl,1.13 - Michael(tm) Smith * Added boolean man.output.in.separate.dir param, to control whether or not man files are output in separate directory. Modified: manpages/docbook.xsl,1.65; manpages/utility.xsl,1.14 - Michael(tm) Smith * Added options for controlling indentation of verbatim output. Controlled through the man.indentation.verbatims.adjust and man.indentation.verbatims.value params. Closes #1242997 Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 - Michael(tm) Smith * Added options for controlling indentation in lists and in *blurb output in the AUTHORS section. Controlled through the man.indentation.lists.adjust, man.indentation.lists.value, man.indentation.authors.adjust, and man.indentation.authors.value parameters. Default is 3 characters (instead of the roff default of 8 characters). Closes #1449369. Also, removed the indent that was being set on informalexample outuput. I will instead add an option for indenting verbatims, which I think is what the informalexample indent was intended for originally. Modified: manpages/block.xsl,1.14; manpages/docbook.xsl,1.63; manpages/info.xsl,1.18; manpages/lists.xsl,1.28 - Michael(tm) Smith * Changed line-spacing call before synopfragment to use ".sp -1n" ("n" units specified) instead of plain ".sp -1" Modified: manpages/synop.xsl,1.28 - Michael(tm) Smith * Added support for writing man files into a specific output directory and into appropriate subdirectories within that output directory. Controlled through the man.base.dir parameter (similar to the base.dir support in the HTML stylesheet) and the man.subdirs.enabled parameter, which automatically determines the name of an appropriate subdir (for example, man/man7, man/man1, etc.) based on the section number/manvolnum of the source Refentry. Closes #1255036 and #1170317. Thanks to Denis Bradford for the original feature request, and to Costin Stroie for submitting a patch that was very helpful in implementing the support. Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 - Michael(tm) Smith * Refined XPath statements and notification messages for refentry metadata handling. Modified: common/common.xsl,1.59; common/refentry.xsl,1.14; manpages/docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm) Smith * Added support for copyright and legalnotice. The manpages stylesheets now output a COPYRIGHT section, after the AUTHORS section, if a copyright or legalnotice is found in the source. The section contains the copyright contents followed by the legalnotice contents. Closes #1450209. Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 - Michael(tm) Smith * Drastically reworked all of the XPath expressions used in refentry metadata gathering -- completely removed $parentinfo and turned $info into a set of nodes that includes the *info contents of the Refentry plus the *info contents all all of its ancestor elements. The basic XPath expression now used throughout is (using the example of checking for a date): (($info[//date])[last()]/date)[1]. That selects the "last" *info/date date in document order -- that is, the one eitther on the Refentry itself or on the closest ancestor to the Refentry. It's likely this change may break some things; may need to pick up some pieces later. Also, changed the default value for the man.th.extra2.max.length from 40 to 30. Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; params/man.th.extra2.max.length.xml,1.2; params/refentry.date.profile.xml,1.2; params/refentry.manual.profile.xml,1.2; params/refentry.source.name.profile.xml,1.2; params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; manpages/other.xsl,1.15 - Michael(tm) Smith * Added support for DocBook 5 namespace-stripping in manpages stylesheet. Closes request #1210692. Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - Michael(tm) Smith * Fixed handling of table footnotes. With this checkin, the table support in the manpages stylesheet is now basically feature complete. So this change closes request #619532, "No support for tables" -- the oldest currently open manpages feature request, submitted by Ben Secrest (blsecres) on 2002-10-07. Congratulations to me [patting myself on the back]. Modified: manpages/block.xsl,1.11; manpages/docbook.xsl,1.55; manpages/table.xsl,1.15 - Michael(tm) Smith * Added handling for table titles. Also fixed handling of nested tables; nest tables are now "extracted" and displayed just after their parent tables. Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14 - Michael(tm) Smith * Added option for turning off bold formatting in Funcsynopsis. Boldface formatting in function synopsis is mandated in the man(7) man page and is used almost universally in existing man pages. Despite that, it really does look like crap to have an entire Funcsynopsis output in bold, so I added params for turning off the bold formatting and/or replacing it with a different roff special font (e.g., "RI" for alternating roman/italic instead of the default "BI" for alternating bold/italic). The new params are "man.funcprototype.font" and "man.funcsynopsisinfo.font". To be documented later. Closes #1452247. Thanks to Joe Orton for the feature request. Modified: params/man.string.subst.map.xml,1.16; manpages/block.xsl,1.10; manpages/docbook.xsl,1.51; manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm) Smith * Use AUTHORS instead of AUTHOR if we have multiple people to attribute. Also, fixed checking such that we generate author section even if we don't have an author (as long as there is at least one other person/entity we can put in the section). Also adjusted assembly of content for Author metainfo field such that we now not only use author, but try to find a "best match" if we can't find an author name to put there. Closes #1233592. Thanks to Sam Steingold for the request. Modified: manpages/info.xsl,1.12 - Michael(tm) Smith * Changes for request #1243027, "Impove handling of AUTHOR section." This adds support for Collab, Corpauthor, Corpcredt, Orgname, Publishername, and Publisher. Also adds support for output of Affiliation and its children, and support for using gentext strings for auto-attributing roles (Author, Editor, Publisher, Translator, etc.). Also did a lot of code cleanup and modularization of all the AUTHOR handling code. And fixed a bug that was causing Author info to not be picked up correctly for metainfo comment we embed in man-page source. Modified: manpages/info.xsl,1.11 - Michael(tm) Smith * Support bold output for "emphasis remap='B'". (because Eric Raymond's doclifter(1) tool converts groff source marked up with ".B" request or "\fB" escapes to DocBook "emphasis remap='B'".) Modified: manpages/inline.xsl,1.14 - Michael(tm) Smith * Added support for Segmentedlist. Details: Output is tabular, with no option for "list" type output. Output for Segtitle elements can be supressed by setting man.segtitle.suppress. If Segtitle content is output, it is rendered in italic type (not bold because not all terminals support bold and so italic ensures the stand out on those terminals). Extra space (.sp line) at end of table code ensures that it gets handled correctly in the case where its source is the child of a Para. Closes feature-request #1400097. Thanks to Daniel Leidert for the patch and push, and to Alastair Rankine for filing the original feature request. Modified: manpages/lists.xsl,1.23; manpages/utility.xsl,1.10 - Michael(tm) Smith * Improved handling or Author/Editor/Othercredit. Reworked content of (non-visible) comment added at top of each page (metadata stuff). Added support for generating a manifest file (useful for cleaning up after builds, etc.) Modified: manpages/docbook.xsl,1.46; manpages/info.xsl,1.9; manpages/other.xsl,1.12; manpages/utility.xsl,1.6 - Michael(tm) Smith * Added two new parameters for handling of multi-term varlistentry elements: variablelist.term.break.after: When the variablelist.term.break.after is non-zero, it will generate a line break after each term multi-term varlistentry. variablelist.term.separator: When a varlistentry contains multiple term elements, the string specified in the value of the variablelist.term.separator parameter is placed after each term except the last. The default is ", " (a comma followed by a space). To suppress rendering of the separator, set the value of variablelist.term.separator to the empty string (""). These parameters are primarily intended to be useful if you have multi-term varlistentries that have long terms. Closes #1306676. Thanks to Sam Steingold for providing an example "lots of long terms" doc that demonstrated the value of having these options. Also, added normalize-space() call to processing of each term. This change affects all output formats (HTML, PDF, manpages). The default behavior should pretty much remain the same as before, but it is possible (as always) that the change may introduce some new bugginess. Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/variablelist.term.break.after.xml,1.1; params/variablelist.term.separator.xml,1.1 - Michael(tm) Smith Params The following changes have been made to the params code since the 1.69.1 release. * New parameters to set header/footer table minimum height. Modified: params/footer.table.height.xml,1.1; params/header.table.height.xml,1.1 - Robert Stayton * Support multiple indexing methods for different languages. Modified: params/index.method.xml,1.1 - Robert Stayton * Remove qandaset and qandadiv from generate.toc for fo output because formerly it wasn't working, but now it is and the default behavior should stay the same. Modified: params/generate.toc.xml,1.8 - Robert Stayton * add support for page number references to link element too. Modified: params/insert.link.page.number.xml,1.1 - Robert Stayton * Add support for more characters to hyphen on when ulink.hyphenate is turned on. Modified: params/ulink.hyphenate.chars.xml,1.1; params/ulink.hyphenate.xml,1.3 - Robert Stayton * New attribute-set to format biblioentry and bibliomixed. Modified: params/biblioentry.properties.xml,1.1 - Robert Stayton * Added new parameter chunk.tocs.and.lots.has.title which controls presence of title in a separate chunk with ToC/LoT. Disabling title can be very useful if you are generating frameset output (well, yes those frames, but some customers really want them ;-). Modified: html/chunk-code.xsl,1.15; html/param.ent,1.93; html/param.xweb,1.102; params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka Kosek * Added new attribute set toc.line.properties for controlling appearance of lines in ToC/LoT Modified: params/toc.line.properties.xml,1.1 - Jirka Kosek * Allow table footnotes to have different properties from regular footnotes. Modified: params/table.footnote.properties.xml,1.1 - Robert Stayton * Set properties for pgwide="1" objects. Modified: params/pgwide.properties.xml,1.1 - Robert Stayton * Added the autotoc.label.in.hyperlink param. If the value of autotoc.label.in.hyperlink is non-zero, labels are included in hyperlinked titles in the TOC. If it is instead zero, labels are still displayed prior to the hyperlinked titles, but are not hyperlinked along with the titles. Closes patch #1065868. Thanks to anatoly techtonik for the patch. Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - Michael(tm) Smith * Added two new params: html.head.legalnotice.link.types and html.head. legalnotice.link.multiple. If the value of the generate.legalnotice.link is non-zero, then the stylesheet generates (in the head section of the HTML source) either a single HTML link element or, if the value of the html.head.legalnotice. link.multiple is non-zero, one link element for each link type specified. Each link has the following attributes: - a rel attribute whose value is derived from the value of html.head. legalnotice.link.types - an href attribute whose value is set to the URL of the file containing the legalnotice - a title attribute whose value is set to the title of the corresponding legalnotice (or a title programatically determined by the stylesheet) For example: Closes #1476450. Thanks to Sam Steingold. Modified: html/chunk-common.xsl,1.45; html/param.ent,1.91; html/param.xweb,1.100; params/generate.legalnotice.link.xml,1.4; params/html.head.legalnotice.link.multiple.xml,1.1; params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm) Smith * Added the following params: - man.indent.width (string-valued) - man.indent.refsect (boolean) - man.indent.blurbs (boolean) - man.indent.lists (boolean) - man.indent.verbatims (boolean) Note that in earlier snapshots, man.indent.width was named man.indentation.default.value and the boolean params had names like man.indentation.*.adjust. Also the man.indent.blurbs param was called man.indentation.authors.adjust (or something). The behavior now is: If the value of a particular man.indent.* boolean param is non-zero, the corresponding contents (refsect*, list items, authorblurb/personblurb, vervatims) are displayed with a left margin indented by a width equal to the value of man.indent.width. Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74; manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20; manpages/param.ent,1.22; manpages/param.xweb,1.24; manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1; params/man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 - Michael(tm) Smith * Added man.table.footnotes.divider param. In each table that contains footenotes, the string specified by the man. table.footnotes.divider parameter is output before the list of footnotes for the table. Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; manpages/param.ent,1.21; manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith * Added the man.output.in.separate.dir, man.output.base.dir, and man.output.subdirs.enabled parameters. The man.output.base.dir parameter specifies the base directory into which man-page files are output. The man.output.subdirs.enabled parameter controls whether the files are output in subdirectories within the base directory. The values of the man.output.base.dir and man.output.subdirs.enabled parameters are used only if the value of man.output.in.separate.dir parameter is non-zero. If the value of man.output.in.separate.dir is zero, man-page files are not output in a separate directory. Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1; params/man.output.in.separate.dir.xml,1.1; params/man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith * Added man.font.table.headings and man.font.table.title params, for controlling font in table headings and titles. Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1; params/man.font.table.title.xml,1.1 - Michael(tm) Smith * Added man.font.funcsynopsisinfo and man.font.funcprototype params, for specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and funcprototype output. Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; manpages/param.ent,1.18; manpages/param.xweb,1.20; manpages/synop.xsl,1.29; manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1; params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith * Changed to select="0" in refclass.suppress (instead of ..>0 as a child of the list. For example: