Michael Smith [Wed, 5 Mar 2008 10:13:59 +0000 (10:13 +0000)]
Added support for rendering co callouts and calloutlist instances.
So you can now use simple callouts -- marking up programlisting
and such with co instances -- and have the callouts displayed in
man-page output. ("simple callouts" means using co@id and
callout@arearefs pointing to co@id instances; in man/roff output,
we can't/don't support markup that uses areaset and area)
Michael Smith [Wed, 5 Mar 2008 00:34:50 +0000 (00:34 +0000)]
initial add; pam man sources
Michael Smith [Wed, 5 Mar 2008 00:16:24 +0000 (00:16 +0000)]
added fglrx
Michael Smith [Wed, 5 Mar 2008 00:01:12 +0000 (00:01 +0000)]
added example refentry source from Debian docbook-xsl package
Norman Walsh [Tue, 4 Mar 2008 19:09:35 +0000 (19:09 +0000)]
Rename link
Michael Smith [Tue, 4 Mar 2008 11:38:39 +0000 (11:38 +0000)]
added git documentation
Michael Smith [Tue, 4 Mar 2008 10:40:21 +0000 (10:40 +0000)]
When generating manpages output, we no longer report anything if
the refentry source is missing date or pubdate content. In
practice, many users intentionally omit the date from the source
because they explicitly want it to be generated.
Michael Smith [Tue, 4 Mar 2008 10:11:38 +0000 (10:11 +0000)]
only put a line of space after a verbatim if it's followed by a
text node or a paragraph
Michael Smith [Tue, 4 Mar 2008 08:51:02 +0000 (08:51 +0000)]
added mysql doc sources
Michael Smith [Tue, 4 Mar 2008 07:32:37 +0000 (07:32 +0000)]
put verbatim environments in slightly smaller font in non-TTY
output
Michael Smith [Tue, 4 Mar 2008 07:14:18 +0000 (07:14 +0000)]
minor whitespace-only reformatting of lists.xsl source
Michael Smith [Tue, 4 Mar 2008 07:07:43 +0000 (07:07 +0000)]
Made refinements/fixes to output of orderedlist and itemizedlist
-- in part, to get mysql man pages to display correctly. This
change causes a "\c" continuation marker to be added between
listitem markers and contents (to ensure that the content remains
on the same line as the marker when displayed)
Michael Smith [Tue, 4 Mar 2008 04:28:11 +0000 (04:28 +0000)]
put a line of vertical space after all verbatim output that has
sibling content following it (not just if that sibling content is
a text node)
Michael Smith [Tue, 4 Mar 2008 04:24:43 +0000 (04:24 +0000)]
refined spacing around titles for admonitions
Michael Smith [Tue, 4 Mar 2008 04:20:37 +0000 (04:20 +0000)]
Deal with case of verbatim environments that have a linebreak
after the opening tag. Assumption is that users generally don't
want that linebreak to appear in output, so we do some groff
hackery to mess with vertical spacing and close the space.
Michael Smith [Tue, 4 Mar 2008 03:38:53 +0000 (03:38 +0000)]
indexterm instances now produce groff comments like this:
.\" primary: secondary: tertiary
remark instances, if non-empty, now produce groff comments
Michael Smith [Tue, 4 Mar 2008 03:27:47 +0000 (03:27 +0000)]
convert no-break space character to groff "\ \&" (instead of just
"\ "). the reason is that if a space occurs at the end of a line,
our processing causes it to be eaten. a real-world case of this is
the mysql(1) man page. appending the "\&" prevents that
Mauritz Jeanson [Mon, 3 Mar 2008 21:19:02 +0000 (21:19 +0000)]
Copy over the libxslt README too (currently there is no other documentation).
Do not delete the extensions directory when cleaning; only delete (non-dot) files in it.
Mauritz Jeanson [Mon, 3 Mar 2008 15:59:40 +0000 (15:59 +0000)]
Changed the name of the script file back to "xslt.py". Using "libxslt.py"
leads to a name clash since the script contains a "import libxslt" statement.
Michael Smith [Mon, 3 Mar 2008 09:20:29 +0000 (09:20 +0000)]
various changes and additions to support making with asciidoc as
an input format
Michael Smith [Mon, 3 Mar 2008 09:18:50 +0000 (09:18 +0000)]
initial add
Michael Smith [Mon, 3 Mar 2008 08:25:13 +0000 (08:25 +0000)]
re-adding empty extensions subdir
Michael Smith [Mon, 3 Mar 2008 05:47:36 +0000 (05:47 +0000)]
added hg and apt docs and set ignore props
Michael Smith [Mon, 3 Mar 2008 05:34:29 +0000 (05:34 +0000)]
make dblatex the default PDF maker for the example makefile
Michael Smith [Mon, 3 Mar 2008 05:07:39 +0000 (05:07 +0000)]
output "sp" before simpara output, not after it (outputting it
after results in undesirable whitespace in particular cases; for
example, in the hg/mercurial docs
Michael Smith [Mon, 3 Mar 2008 04:12:38 +0000 (04:12 +0000)]
renamed from title-preamble to pinch.together and replaced "sp -1"
between synopsis fragments with call to pinch.together instead
Michael Smith [Mon, 3 Mar 2008 03:48:41 +0000 (03:48 +0000)]
use title-preamble template for table titles (instead of "sp -1"
hack), and "sp 1" after all tables (instead of just "sp"
Michael Smith [Mon, 3 Mar 2008 03:26:48 +0000 (03:26 +0000)]
created title-preamble template for suppressing line spacing after
headings
Michael Smith [Mon, 3 Mar 2008 03:24:43 +0000 (03:24 +0000)]
fixed typo
Michael Smith [Mon, 3 Mar 2008 03:03:12 +0000 (03:03 +0000)]
further refinement of indenting in AUTHORS section
Michael Smith [Mon, 3 Mar 2008 03:00:48 +0000 (03:00 +0000)]
refined handling of admonitions
Michael Smith [Mon, 3 Mar 2008 02:44:14 +0000 (02:44 +0000)]
Use RS/RE in another place where we had IP ""
Michael Smith [Mon, 3 Mar 2008 01:46:23 +0000 (01:46 +0000)]
remove stray word that inadvertently got added to makefile
Michael Smith [Mon, 3 Mar 2008 01:35:26 +0000 (01:35 +0000)]
refined build of extensions subdir
Michael Smith [Mon, 3 Mar 2008 01:12:12 +0000 (01:12 +0000)]
make extensions packaging depend on xsl-libxslt/python/docbook.py
and xsl-libxslt/python/xslt.py
Michael Smith [Mon, 3 Mar 2008 00:25:34 +0000 (00:25 +0000)]
Replace (ab)use of IP with "sp -1" in AUTHORS section with RS/RE
instead.
Michael Smith [Sun, 2 Mar 2008 23:23:15 +0000 (23:23 +0000)]
changed all instances of ".sp -1n" to ".sp -1"
Mauritz Jeanson [Sat, 1 Mar 2008 20:42:27 +0000 (20:42 +0000)]
Added rules to include libxslt extensions in snapshot builds.
Mauritz Jeanson [Sat, 1 Mar 2008 20:40:11 +0000 (20:40 +0000)]
Tweaked the text a little.
Mauritz Jeanson [Sat, 1 Mar 2008 20:31:47 +0000 (20:31 +0000)]
Renamed xsl-xsltproc to the more apt xsl-libxslt.
Michael Smith [Sat, 1 Mar 2008 14:42:29 +0000 (14:42 +0000)]
update repository location
Michael Smith [Sat, 1 Mar 2008 14:34:05 +0000 (14:34 +0000)]
fail properly if VERSION not set
Michael Smith [Sat, 1 Mar 2008 14:24:39 +0000 (14:24 +0000)]
handle missing VERSION error correctly
Michael Smith [Sat, 1 Mar 2008 14:14:02 +0000 (14:14 +0000)]
updated to use debian svn as source
Michael Smith [Sat, 1 Mar 2008 13:56:57 +0000 (13:56 +0000)]
Adding sample refentry doc for saxonb
Michael Smith [Sat, 1 Mar 2008 10:19:51 +0000 (10:19 +0000)]
add extra line before SH heads only in non-TTY output
Michael Smith [Sat, 1 Mar 2008 08:11:54 +0000 (08:11 +0000)]
Reworked output for admonitions (caution, important, note, tip,
warning). In TTY output, admonitions now get indented. In non-TTY
output, a colored marker (yellow) is displayed next to them.
Michael Smith [Sat, 1 Mar 2008 08:09:22 +0000 (08:09 +0000)]
Added BM/EM macros for putting a colored marker in margin next to
a block of text.
Michael Smith [Sat, 1 Mar 2008 08:06:05 +0000 (08:06 +0000)]
created make.bold.title template by moving title-bolding part out
from nested-section-title template. This allows the bolding to
also be used by the template for formatting admonitions
Michael Smith [Sat, 1 Mar 2008 08:04:05 +0000 (08:04 +0000)]
put .br before copyright contents to prevent them from getting run in
Michael Smith [Fri, 29 Feb 2008 14:44:46 +0000 (14:44 +0000)]
made point size of output for Refsect2 and Refsect3 heads bigger
Michael Smith [Fri, 29 Feb 2008 14:08:49 +0000 (14:08 +0000)]
put slightly more space between SH head and underline in non-TTY
output
Michael Smith [Fri, 29 Feb 2008 13:47:28 +0000 (13:47 +0000)]
made some further doc tweaks related to the
man.charmap.subset.profile.english param
Michael Smith [Fri, 29 Feb 2008 12:43:20 +0000 (12:43 +0000)]
Fixed some typos.
Michael Smith [Fri, 29 Feb 2008 12:41:18 +0000 (12:41 +0000)]
Added the man.charmap.subset.profile.english parameter and refined
the handling of charmap subsets to differentiate between English
and non-English source.
This way charmap subsets are now handled is this:
If the value of the man.charmap.use.subset parameter is non-zero,
and your DocBook source is not written in English (that is, if its
lang or xml:lang attribute has a value other than en), then the
character-map subset specified by the man.charmap.subset.profile
parameter is used instead of the full roff character map.
Otherwise, if the lang or xml:lang attribute on the root element
in your DocBook source or on the first refentry element in your
source has the value en or if it has no lang or xml:lang
attribute, then the character-map subset specified by the
man.charmap.subset.profile.english parameter is used instead of
man.charmap.subset.profile.
The difference between the two subsets is that
man.charmap.subset.profile provides mappings for characters in
Western European languages that are not part of the Roman
(English) alphabet (ASCII character set).
Michael Smith [Fri, 29 Feb 2008 09:08:53 +0000 (09:08 +0000)]
Various updates, mainly related to uppercasing SH titles:
- added a "Language: " metadata line to the top comment area of
output man pages, to indicate the language the page is in
- added a "toupper" macro of doing locale-aware uppercasing of
SH titles and cross-references to SH titles; the mechanism
relies on the uppercase.alpha and lowercase.alpha DocBook
gentext keys to do locale-aware uppercasing based on the
language the page is written in
- added a "string.shuffle" template, which provides a library
function for "shuffling" two strings together into a single
string; it takes the first character for the first string, the
first character from second string, etc. The only current use
for it is to generate the argument for the groff tr request
that does string uppercasing.
- added make.tr.uppercase.arg and make.tr.normalcase.arg named
templates for use in generating groff code for uppercasing and
"normal"-casing SH titles
- made the BB/BE "background drawing" macros have effect only in
non-TTY output
- output a few comments in the top part of source
Michael Smith [Fri, 29 Feb 2008 08:54:32 +0000 (08:54 +0000)]
removed some leftover kruft
Michael Smith [Fri, 29 Feb 2008 08:51:42 +0000 (08:51 +0000)]
To create the name(s) for each man page, we now replace any spaces
in the refname(s) with underscores. This ensures that tools like
lexgrog(1) will be able to parse the name (lexgrog won't parse
names that contain spaces).
Michael Smith [Fri, 29 Feb 2008 08:49:53 +0000 (08:49 +0000)]
Put a comment into source of man page to indicate where the main
content starts. (We now have a few of macro definitions at the
start of the source, so putting this comment in helps those that
might be viewing the source.)
Steve Ball [Fri, 29 Feb 2008 06:45:01 +0000 (06:45 +0000)]
added pubdate, fixed metadata handling in biblioentry
Michael Smith [Wed, 27 Feb 2008 07:42:28 +0000 (07:42 +0000)]
refined mechanism for generating SH titles
Michael Smith [Wed, 27 Feb 2008 07:24:20 +0000 (07:24 +0000)]
Added zcaron, Zcaron, scaron, and Scaron to the groff character map.
This means that generated Finnish man pages will no longer contain
any raw accented characters -- they'll instead by marked up with
groff escapes.
Michael Smith [Wed, 27 Feb 2008 07:12:05 +0000 (07:12 +0000)]
Added to default charmap used by manpages:
- the "letters" part of the 'C1 Controls And Latin-1 Supplement
(Latin-1 Supplement)' Unicode block
- Latin Extended-A block (but not all of the characters from
that block have mappings in groff, so some of them are still
passed through as-is)
The effects of this change are that in man pages generated for
most Western European languages and for Finnish, all characters
not part of the Roman alphabet are (e.g., "accented" characters)
are converted to groff escapes.
Previously, by default we passed through those characters as is
(and users needed to use the full charmap if they wanted to have
those characters converted).
As a result of this change, man pages generated for Western
European languages will be viewable in some environments in which
they are not viewable if the "raw" non-Roman characters are in them.
Michael Smith [Wed, 27 Feb 2008 06:35:11 +0000 (06:35 +0000)]
Added in support for building the Galician locale.
Michael Smith [Wed, 27 Feb 2008 03:55:39 +0000 (03:55 +0000)]
fixed error in lowercase.alpha definition in Hungarian locale
Michael Smith [Tue, 26 Feb 2008 11:51:32 +0000 (11:51 +0000)]
corrected a regression I introduced about a year ago that caused
dots to be output just as "\." -- instead needs to be "\&." (which
is what it will be now, after this change)
Michael Smith [Tue, 26 Feb 2008 10:09:01 +0000 (10:09 +0000)]
Changed backend handling for generating titles for SH sections and
for cross-references to those sections. This should have no effect
on TTY output (behavior should remain the same hopefully) but
results in titles in normal case (instead of uppercase) in PS
output.
Michael Smith [Tue, 26 Feb 2008 10:06:02 +0000 (10:06 +0000)]
use make.subheading template to make subheadings for AUTHORS and
COPYRIGHT sections (instead of harcoding roff markup)
Michael Smith [Tue, 26 Feb 2008 10:04:49 +0000 (10:04 +0000)]
put code font around programlisting etc.
Michael Smith [Tue, 26 Feb 2008 10:03:27 +0000 (10:03 +0000)]
embed custom macro definitions in man pages, plus wrap synopsis in
code font
Michael Smith [Tue, 26 Feb 2008 10:00:51 +0000 (10:00 +0000)]
use the make.subheading template to generated SH subheading for
endnotes section.
Michael Smith [Tue, 26 Feb 2008 09:58:56 +0000 (09:58 +0000)]
Added some templates for generating if-then-else conditional
markup in groff, so let's use those instead of hard-coding it in
multiple places...
Michael Smith [Tue, 26 Feb 2008 09:55:32 +0000 (09:55 +0000)]
Initial checkin of some changes related to making PS/PDF output
from "man -l -Tps" look better. The current changes:
- render synopsis and verbatim sections in a monospace/code font
- put a light-grey background behind all programlisting, screen,
and literallayout instances
- prevent SH heads in PS output from being rendered in uppercase
(as they are in console output)
- also display xrefs to SH heads in PS output in normal case
(instead of uppercase)
- draw a line under SH heads in PS output
The changes made to the code to support the above features were:
- added some embedded/custom macros: one for conditionally
upper-casing SH x-refs, one for redefining the SH macro
itself, with some conditional handling for PS output, and
finally a macro for putting a background/screen (filled box)
around a block of text (e.g., a program listing) in PS output
- added utility templates for wrapping blocks of text in code
font; also templates for inline code font
Mauritz Jeanson [Fri, 22 Feb 2008 15:45:36 +0000 (15:45 +0000)]
Added information on how the filename is computed.
Steve Ball [Fri, 22 Feb 2008 06:11:49 +0000 (06:11 +0000)]
Added support for edition.
Steve Ball [Fri, 22 Feb 2008 06:09:58 +0000 (06:09 +0000)]
Removed stylesheets for old, deprecated conversion method.
Steve Ball [Fri, 22 Feb 2008 06:07:31 +0000 (06:07 +0000)]
Added support for Open Office, added edition element, improved list and table support in Word and Pages
Bob Stayton [Thu, 21 Feb 2008 21:37:56 +0000 (21:37 +0000)]
refpurpose nodes now get apply-templates instead of just normalize-space().
Mauritz Jeanson [Thu, 21 Feb 2008 17:25:57 +0000 (17:25 +0000)]
Added preliminary README information for libxslt extensions.
The adjustColumnWidths() function works well for me (tested on
Windows XP with Python 2.5).
Mauritz Jeanson [Thu, 21 Feb 2008 17:10:10 +0000 (17:10 +0000)]
Added a fix to make rowsep apply to the last row of thead in entrytbl.
Mauritz Jeanson [Thu, 21 Feb 2008 16:48:31 +0000 (16:48 +0000)]
Clarified PI usage.
Michael Smith [Thu, 21 Feb 2008 08:40:47 +0000 (08:40 +0000)]
Fixed alignment of first lined of text for each listitem in
orderedlist output for TTY. Existing code seemed to have been
causing an extra undesirable space to appear.
Michael Smith [Thu, 21 Feb 2008 08:37:13 +0000 (08:37 +0000)]
Wrapped some roff conditionals around roff markup for orderedlist
and itemizedlist output, so that the lists look acceptable in PS
output as well as TTY.
Michael Smith [Thu, 21 Feb 2008 04:10:17 +0000 (04:10 +0000)]
Simplified and streamlined handling of output for ANSI-style
funcprototype output, to correct a problem that was causing type
data to be lost in the output parameter definitions. For example,
for an instance like this:
<paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
... the brackets (indicating an array type) were being dropped.
Michael Smith [Wed, 20 Feb 2008 16:49:45 +0000 (16:49 +0000)]
Changed HTML handling of K&R-style paramdef output. The parameter
definitions are no longer output in a table (though the prototype
still is). The reason for the change is that the
kr-tabular-funcsynopsis-mode template was causing type data to be
lost in the output parameter definitions. For example, for an
instance like this:
<paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
... the brackets (indicating an array type) were being dropped.
The easiest way to deal with the problem is to not try to chop up
the parameter definitions and display them in table format, but to
instead just output them as-is. May not look quite as pretty, but
at least we can be sure no information is being lost...
Michael Smith [Wed, 20 Feb 2008 11:42:45 +0000 (11:42 +0000)]
Added the man.funcsynopsis.style parameter. Has the same effect in
manpages output as the funcsynopsis.style parameter has in HTML
output -- except that its default value is 'ansi' instead of 'kr'.
Michael Smith [Wed, 20 Feb 2008 07:00:18 +0000 (07:00 +0000)]
Reworked handling of K&R funcprototype output. It no longer relies
on the HTML kr-tabular templates, but instead just does direct
transformation to roff. For K&R output, it displays the paramdef
output in an indented list following the prototype.
Mauritz Jeanson [Tue, 19 Feb 2008 18:52:35 +0000 (18:52 +0000)]
Made attribute-sets members of the param list. This enables links to attribute-sets in the
reference documentation.
Mauritz Jeanson [Tue, 19 Feb 2008 17:47:30 +0000 (17:47 +0000)]
Fixed typo.
Michael Smith [Mon, 18 Feb 2008 03:38:38 +0000 (03:38 +0000)]
Properly integrated handling for K&R output into manpages
stylesheet. The choice between K&R output and ANSI output is
currently controlled through use of the (HTML) funcsynopsis.style
parameter. Note that because the mechanism does currently rely on
funcsynopsis.style, the default in manpages output is now K&R
(because that's the default of that param). But I suppose I ought
to create a man.funcsynopsis.style and make the default for that
ANSI (to preserve the existing default behavior).
Michael Smith [Mon, 18 Feb 2008 03:32:17 +0000 (03:32 +0000)]
added manpages/pi.xsl file
Michael Smith [Mon, 18 Feb 2008 03:31:15 +0000 (03:31 +0000)]
use .BI handling in K&R funsynopsis output for manpages, just as
we do already of ANSI output
Michael Smith [Mon, 18 Feb 2008 01:51:37 +0000 (01:51 +0000)]
Added "dbman funcsynopsis-style" PI and incorporated it into the
doc build.
Michael Smith [Mon, 18 Feb 2008 01:50:02 +0000 (01:50 +0000)]
updated wording of doc for funcsynopsis-style PI
Michael Smith [Mon, 18 Feb 2008 01:48:15 +0000 (01:48 +0000)]
further change needed for switch from no locale to nb.
Michael Smith [Mon, 18 Feb 2008 00:15:12 +0000 (00:15 +0000)]
ignore nb.xml
Mauritz Jeanson [Sun, 17 Feb 2008 19:08:14 +0000 (19:08 +0000)]
Fixed bug #
1891965 (colsep in entytbl not working).
Michael Smith [Sun, 17 Feb 2008 14:04:36 +0000 (14:04 +0000)]
Corrected language code for nb locale, and restored missing
"startquote" key.
Michael Smith [Sun, 17 Feb 2008 13:26:47 +0000 (13:26 +0000)]
Removed the funcsynopsis.tabular.threshold param. It's no longer
being used in the code and hasn't been since mid 2006.
Michael Smith [Sat, 16 Feb 2008 21:57:31 +0000 (21:57 +0000)]
Implemented initial support for handling tabular K&R output of
funcprototype in manpages output. Accomplished by adding more
templates to the intermediate HTML-to-roff stylesheet that the
build uses to create the manpages/html-synop.xsl stylesheet.