]> git.stg.codes - stg.git/blob - doc/xslt/manpages/ChangeLog.20020917
Add send message to log about excess length of params
[stg.git] / 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