| 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 '舒') 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 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 |
|
|---|
