summaryrefslogtreecommitdiff
path: root/manpages/ChangeLog.20020917
blob: c170cc056014b07090301cb99e6e94b7ef919cdd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
Note: This changelog is a record of descriptions of all changes
made to the DocBook XSL manpages stylesheets during the time when
they were maintained in their original home in the
[cvs]/docbook/contrib/xsl/db2man area of the DocBook Project
source-code repository at Sourceforge; that is, from October 2001
(when they were contributed to the project by Martijn van Beers)
until September 2002 (when they were moved to the
[cvs]/docbook/xsl/manpages area and became a standard part of all
subsequent DocBook XSL Stylesheets releases).

2002-09-17  Norman Walsh <nwalsh@users.sourceforge.net>

	* README, db2man.xsl, lists.xsl, sect23.xsl, synop.xsl, xref.xsl: 
	Moved to docbook/xsl/manpages

	* db2man.xsl, synop.xsl: Patch from Joe Orton

2002-06-16  <lotr@users.sourceforge.net>

	* db2man.xsl: commit patch sent by Joe Orton:
	
	  This patch adds support for using the productname, date and title out of
	  a <referenceinfo> if one is present, rather than having to add each of
	  these individually for every refentry.

	* db2man.xsl: Tim Waugh sent:
	
	  This patch normalizes space in each refname before displaying it in
	  the name section.

2002-05-21  <lotr@users.sourceforge.net>

	* xref.xsl: from Joe Orton:
	this patch allows cross-referencing to a specific refname.  I
	need this since I'm documenting several different (but related)
	functions per refentry, and want to cross-reference them individually,
	rather than just by the title used for the refentry as a whole.

2002-05-17  <lotr@users.sourceforge.net>

	* lists.xsl: apply glosslist support patch from twaugh

2002-05-15  <lotr@users.sourceforge.net>

	* db2man.xsl: slightly sanitize the filenames we generate. again from twaugh

	* db2man.xsl: Apply twaugh's fix for making the entity transform stuff work

2002-05-14  <lotr@users.sourceforge.net>

	* db2man.xsl: generalize the tip template for all admonitions
	(caution,important,note,tip,warning)

	* db2man.xsl: Apply Joe Orton's <tip> patch, modified to be indented. Also show "Tip"
	in the title.
	
	so if <tip><title>foo</title></tip>, you get
	      Tip: foo

	* synop.xsl: rewrote funcprototype. It used to convert all its children to a single
	string and the split it up again through recursion. Now has a nice
	foreach loop for the paramdefs, which seems much cleaner than throwing
	everything in a big string before processing it.

2002-05-10  <lotr@users.sourceforge.net>

	* db2man.xsl: add support for simpara

	* db2man.xsl, lists.xsl: fix refsect2 titles

	* synop.xsl: also from twaugh:
	
	I found some input that goes wrong with the synop.xsl we have in CVS:
	
	<group choice="opt">
	  <arg>-o <replaceable>FILE</replaceable></arg>
	  <arg>--output=<replaceable>FILE</replaceable></arg>
	</group>
	
	It gets rendered as (with *bold* and _italic_):
	
	[*-o FILE* | *--output=FILE*]
	
	The desired markup should look like:
	The following macro does the trick:
	
	[\fB-o \fIFILE\fR\fR | \fB--output=\fIFILE\fR\fR]
	
	The trouble is that the named template 'bold' uses value-of, and so
	strips <replaceable> of its significance.
	
	Another thing I found is that the arg/replaceable template is
	superfluous altogether: db2man.xsl has a 'replaceable' template which
	does the same thing.
	
	Here is a patch to make those two modifications.
	
	NOTE TO SELF: must try to fix bold template so we can use it everywhere

2002-05-09  <lotr@users.sourceforge.net>

	* db2man.xsl: oops, removed too much

	* db2man.xsl: remove stuff that's apparently left-over from sect23.xsl

	* db2man.xsl, lists.xsl, synop.xsl: batch of patches from twaugh:
	* This patch (based on one from Jirka Kosek) adds support for
	  block-level elements inside <para>s---<screen>s for example, or lists.
	* This patch replaces entities (like '&#x8212;') with sensible
	  characters or groups of characters.
	* This patch adds support for sbr.
	* This patch normalizes spaces in varlistentry terms.
	* This patch normalizes spaces in terminal varlistentry terms.
	* This patch allows variable lists to be nested (once).
	* This patch prevents variable list item paragraphs from merging into
	  one another.
	* This patch improves the rendering of itemized lists, and adds support
	  for ordered lists and procedures.
	* This patch makes some small adjustments to group/arg: don't put extra
	  spaces in where they aren't needed, and normalize the space of $arg.
	* This patch makes adjustments to cmdsynopsis elements.  In particular,
	  they can now be wrapped if no <sbr/> is provided.
	* This patch adds funcsynopsis//* support.  Again, wrapping is done
	  automatically.

	* synop.xsl: make synopsises work for --arg=foo <arg>s too

	* synop.xsl: remove unneccesary adding of whitespace for arg/replaceable

2002-05-01  <lotr@users.sourceforge.net>

	* db2man.xsl: This patch adds support for multiple refnames.
	
	(another twaugh patch)

	* db2man.xsl: modified ulink patch from twaugh. Be nice to content-less ulinks. But we
	don't accomodate silly people who don't understand ulink and put the
	url as the content too.

	* db2man.xsl, synop.xsl: db2man.xsl:
	  * temporarily add some params that chunker.xsl needs
	  * fix bold/italic templates
	  * update calls to bold/italic templates for new syntax
	synop.xsl:
	  * add support for synopfragment
	  * update calls to bold/italic templates for new syntax

2002-04-30  <lotr@users.sourceforge.net>

	* db2man.xsl: Add twaug's patch for xref support

	* db2man.xsl: This patch adds support for:
	
	- Multiple authors.
	- A (single) man page editor.
	
	(another patch from twaugh)

	* db2man.xsl: more twaugh patches:
	- Use refentrytitle, not refname[1], for title.
	- Upper-case it.
	- Use date, productname, and title.
	- Pick up author from main document if not contained in refentry.
	- Use refname[1] for man page filename, not refentrytitle.

	* db2man.xsl: add varname support

	* db2man.xsl: This patch makes userinput (an inline element) have inline formatting.

	* db2man.xsl: This patch adds support for the top-level document being something
	other than an article.
	
	It also emits a helpful warning if no refentry elements are found.

	* db2man.xsl: next twaugh patch:
	  Instead of writing to stdout, create a file for each
	  refentry.  Plus, for bonus points, a file for each additional refname
	  within that entry (pointing to the main page).

	* db2man.xsl: Add named templates for bold-ifying and italicizing stuff. Inspired
	by yet another twaugh patch

	* db2man.xsl, lists.xsl, sect23.xsl: consistently use &#10; instead of a newline

	* db2man.xsl, synop.xsl: * add support for informalexample, screen, errorcode, constant, type,
	  quote, programlisting and citerefentry
	* use the 'bold' and 'italic' named templates

	* xref.xsl: New file.

2001-12-01  Norman Walsh <nwalsh@users.sourceforge.net>

	* README, db2man.xsl, lists.xsl, sect23.xsl, synop.xsl: 
	New file.