1
0

ChangeLog.20020917 6.7 KB

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