doc/xslt/manpages/ChangeLog.20020917

   1 Note: This changelog is a record of descriptions of all changes
   2 made to the DocBook XSL manpages stylesheets during the time when
   3 they were maintained in their original home in the
   4 [cvs]/docbook/contrib/xsl/db2man area of the DocBook Project
   5 source-code repository at Sourceforge; that is, from October 2001
   6 (when they were contributed to the project by Martijn van Beers)
   7 until September 2002 (when they were moved to the
   8 [cvs]/docbook/xsl/manpages area and became a standard part of all
   9 subsequent DocBook XSL Stylesheets releases).
  10
  11 2002-09-17  Norman Walsh <nwalsh@users.sourceforge.net>
  12
  13         * README, db2man.xsl, lists.xsl, sect23.xsl, synop.xsl, xref.xsl:
  14         Moved to docbook/xsl/manpages
  15
  16         * db2man.xsl, synop.xsl: Patch from Joe Orton
  17
  18 2002-06-16  <lotr@users.sourceforge.net>
  19
  20         * db2man.xsl: commit patch sent by Joe Orton:
  21
  22           This patch adds support for using the productname, date and title out of
  23           a <referenceinfo> if one is present, rather than having to add each of
  24           these individually for every refentry.
  25
  26         * db2man.xsl: Tim Waugh sent:
  27
  28           This patch normalizes space in each refname before displaying it in
  29           the name section.
  30
  31 2002-05-21  <lotr@users.sourceforge.net>
  32
  33         * xref.xsl: from Joe Orton:
  34         this patch allows cross-referencing to a specific refname.  I
  35         need this since I'm documenting several different (but related)
  36         functions per refentry, and want to cross-reference them individually,
  37         rather than just by the title used for the refentry as a whole.
  38
  39 2002-05-17  <lotr@users.sourceforge.net>
  40
  41         * lists.xsl: apply glosslist support patch from twaugh
  42
  43 2002-05-15  <lotr@users.sourceforge.net>
  44
  45         * db2man.xsl: slightly sanitize the filenames we generate. again from twaugh
  46
  47         * db2man.xsl: Apply twaugh's fix for making the entity transform stuff work
  48
  49 2002-05-14  <lotr@users.sourceforge.net>
  50
  51         * db2man.xsl: generalize the tip template for all admonitions
  52         (caution,important,note,tip,warning)
  53
  54         * db2man.xsl: Apply Joe Orton's <tip> patch, modified to be indented. Also show "Tip"
  55         in the title.
  56
  57         so if <tip><title>foo</title></tip>, you get
  58               Tip: foo
  59
  60         * synop.xsl: rewrote funcprototype. It used to convert all its children to a single
  61         string and the split it up again through recursion. Now has a nice
  62         foreach loop for the paramdefs, which seems much cleaner than throwing
  63         everything in a big string before processing it.
  64
  65 2002-05-10  <lotr@users.sourceforge.net>
  66
  67         * db2man.xsl: add support for simpara
  68
  69         * db2man.xsl, lists.xsl: fix refsect2 titles
  70
  71         * synop.xsl: also from twaugh:
  72
  73         I found some input that goes wrong with the synop.xsl we have in CVS:
  74
  75         <group choice="opt">
  76           <arg>-o <replaceable>FILE</replaceable></arg>
  77           <arg>--output=<replaceable>FILE</replaceable></arg>
  78         </group>
  79
  80         It gets rendered as (with *bold* and _italic_):
  81
  82         [*-o FILE* | *--output=FILE*]
  83
  84         The desired markup should look like:
  85         The following macro does the trick:
  86
  87         [\fB-o \fIFILE\fR\fR | \fB--output=\fIFILE\fR\fR]
  88
  89         The trouble is that the named template 'bold' uses value-of, and so
  90         strips <replaceable> of its significance.
  91
  92         Another thing I found is that the arg/replaceable template is
  93         superfluous altogether: db2man.xsl has a 'replaceable' template which
  94         does the same thing.
  95
  96         Here is a patch to make those two modifications.
  97
  98         NOTE TO SELF: must try to fix bold template so we can use it everywhere
  99
 100 2002-05-09  <lotr@users.sourceforge.net>
 101
 102         * db2man.xsl: oops, removed too much
 103
 104         * db2man.xsl: remove stuff that's apparently left-over from sect23.xsl
 105
 106         * db2man.xsl, lists.xsl, synop.xsl: batch of patches from twaugh:
 107         * This patch (based on one from Jirka Kosek) adds support for
 108           block-level elements inside <para>s---<screen>s for example, or lists.
 109         * This patch replaces entities (like '&#x8212;') with sensible
 110           characters or groups of characters.
 111         * This patch adds support for sbr.
 112         * This patch normalizes spaces in varlistentry terms.
 113         * This patch normalizes spaces in terminal varlistentry terms.
 114         * This patch allows variable lists to be nested (once).
 115         * This patch prevents variable list item paragraphs from merging into
 116           one another.
 117         * This patch improves the rendering of itemized lists, and adds support
 118           for ordered lists and procedures.
 119         * This patch makes some small adjustments to group/arg: don't put extra
 120           spaces in where they aren't needed, and normalize the space of $arg.
 121         * This patch makes adjustments to cmdsynopsis elements.  In particular,
 122           they can now be wrapped if no <sbr/> is provided.
 123         * This patch adds funcsynopsis//* support.  Again, wrapping is done
 124           automatically.
 125
 126         * synop.xsl: make synopsises work for --arg=foo <arg>s too
 127
 128         * synop.xsl: remove unneccesary adding of whitespace for arg/replaceable
 129
 130 2002-05-01  <lotr@users.sourceforge.net>
 131
 132         * db2man.xsl: This patch adds support for multiple refnames.
 133
 134         (another twaugh patch)
 135
 136         * db2man.xsl: modified ulink patch from twaugh. Be nice to content-less ulinks. But we
 137         don't accomodate silly people who don't understand ulink and put the
 138         url as the content too.
 139
 140         * db2man.xsl, synop.xsl: db2man.xsl:
 141           * temporarily add some params that chunker.xsl needs
 142           * fix bold/italic templates
 143           * update calls to bold/italic templates for new syntax
 144         synop.xsl:
 145           * add support for synopfragment
 146           * update calls to bold/italic templates for new syntax
 147
 148 2002-04-30  <lotr@users.sourceforge.net>
 149
 150         * db2man.xsl: Add twaug's patch for xref support
 151
 152         * db2man.xsl: This patch adds support for:
 153
 154         - Multiple authors.
 155         - A (single) man page editor.
 156
 157         (another patch from twaugh)
 158
 159         * db2man.xsl: more twaugh patches:
 160         - Use refentrytitle, not refname[1], for title.
 161         - Upper-case it.
 162         - Use date, productname, and title.
 163         - Pick up author from main document if not contained in refentry.
 164         - Use refname[1] for man page filename, not refentrytitle.
 165
 166         * db2man.xsl: add varname support
 167
 168         * db2man.xsl: This patch makes userinput (an inline element) have inline formatting.
 169
 170         * db2man.xsl: This patch adds support for the top-level document being something
 171         other than an article.
 172
 173         It also emits a helpful warning if no refentry elements are found.
 174
 175         * db2man.xsl: next twaugh patch:
 176           Instead of writing to stdout, create a file for each
 177           refentry.  Plus, for bonus points, a file for each additional refname
 178           within that entry (pointing to the main page).
 179
 180         * db2man.xsl: Add named templates for bold-ifying and italicizing stuff. Inspired
 181         by yet another twaugh patch
 182
 183         * db2man.xsl, lists.xsl, sect23.xsl: consistently use &#10; instead of a newline
 184
 185         * db2man.xsl, synop.xsl: * add support for informalexample, screen, errorcode, constant, type,
 186           quote, programlisting and citerefentry
 187         * use the 'bold' and 'italic' named templates
 188
 189         * xref.xsl: New file.
 190
 191 2001-12-01  Norman Walsh <nwalsh@users.sourceforge.net>
 192
 193         * README, db2man.xsl, lists.xsl, sect23.xsl, synop.xsl:
 194         New file.
 195