Mauritz Jeanson [Fri, 20 Jul 2007 14:59:23 +0000 (14:59 +0000)]
Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the
regular "parameter machinery".
Mauritz Jeanson [Thu, 19 Jul 2007 18:31:51 +0000 (18:31 +0000)]
Added refpurpose text.
Mauritz Jeanson [Thu, 19 Jul 2007 18:27:47 +0000 (18:27 +0000)]
Added better refpurpose texts.
Mauritz Jeanson [Thu, 19 Jul 2007 17:52:29 +0000 (17:52 +0000)]
Added two more class="attribute".
Mauritz Jeanson [Thu, 19 Jul 2007 17:07:39 +0000 (17:07 +0000)]
Added modifications so that the new callout.icon.size parameter is taken into account. This
parameter is used for FO output (where SVG now is the default graphics format for callouts).
Michael Smith [Thu, 19 Jul 2007 16:32:00 +0000 (16:32 +0000)]
Fixed syntax error in test expression.
Michael Smith [Thu, 19 Jul 2007 07:22:24 +0000 (07:22 +0000)]
In reference doc for docbook-xsl, auto-label all part output, and
also include part labels in component labels.
Michael Smith [Thu, 19 Jul 2007 07:20:38 +0000 (07:20 +0000)]
Fixed minor typo.
Michael Smith [Thu, 19 Jul 2007 07:20:06 +0000 (07:20 +0000)]
Make the structure of lib output doc consistent with that of other
output doc.
Michael Smith [Thu, 19 Jul 2007 07:19:01 +0000 (07:19 +0000)]
Make structure of lib.xweb embedded doc consistent with structure
of similar embedded doc in other source files.
Michael Smith [Thu, 19 Jul 2007 07:17:45 +0000 (07:17 +0000)]
Fixed a bug that caused broken links in some TOCs.
This change affects the code for generating links in HTML output.
It adds a new optional "toc.context" parameter to the href.target
template, and based on the value of that parameter, handles
link-generation in TOCs differently under a certain condition.
The gory details:
The code now checks to see if the output dir of any file being
linked to in a particular TOC is different from the output dir
the TOC is written to. If it is different, we do not call the
trim.common.uri.paths[1] template.
The reason is that, given the following case:
1. we are chunking into separate dirs
2. output for the TOC is written to current dir, but the file
being linked to is written to some subdir "foo".
For that case, links to that file in that TOC did not show
the correct path - they omitted the "foo".
The cause of that problem was that the trim.common.uri.paths
template was being called under all conditions. But it's
apparent that we don't want to call trim.common.uri.paths in
the case where a linked file is being written to a different
directory than the TOC that contains the link, because doing
so will cause a necessary (not redundant) directory-name
part of the link to get inadvertently trimmed, resulting in
a broken link to that file.
Thus, the conditional check was added to catch this case and to
handle it differently
[1] The purpose of the trim.common.uri.paths template is to
prevent cases where, if we didn't call it, we end up with
unnecessary, redundant directory names getting output; for
example, "foo/foo/refname.html".
Mauritz Jeanson [Wed, 18 Jul 2007 19:07:04 +0000 (19:07 +0000)]
Removed public and system IDs (validation is not needed).
Michael Smith [Wed, 18 Jul 2007 17:08:12 +0000 (17:08 +0000)]
Changed reference doc driver file to match updates to website
docs.
Michael Smith [Wed, 18 Jul 2007 17:06:18 +0000 (17:06 +0000)]
Shortened some refpurpose text for embedded doc for PIs.
Michael Smith [Wed, 18 Jul 2007 16:20:33 +0000 (16:20 +0000)]
Put website docs into categories.
Michael Smith [Wed, 18 Jul 2007 16:19:10 +0000 (16:19 +0000)]
Made some changes to ID values in slides doc source, in order to
give us more rational filenames in HTML output of the docs.
Michael Smith [Tue, 17 Jul 2007 17:01:09 +0000 (17:01 +0000)]
Minor restructuring of reference-doc source.
Michael Smith [Tue, 17 Jul 2007 16:57:26 +0000 (16:57 +0000)]
Don't include list of figures in book TOC for reference docs.
Michael Smith [Tue, 17 Jul 2007 16:14:37 +0000 (16:14 +0000)]
Changed handling of titles for note, warning, caution, important,
tip admonitions: We now output and HTML h3 head only if
admon.textlabel is non-zero or if the admonition actually contains
a title; otherwise, we don't output an h3 head at all.
(Previously, we were outputting an empty h3 if the admon.textlabel
was zero and if the admonition had no title.)
Michael Smith [Tue, 17 Jul 2007 15:30:21 +0000 (15:30 +0000)]
in reference.xml, docsrcx -> docsrc
Michael Smith [Tue, 17 Jul 2007 15:23:21 +0000 (15:23 +0000)]
Changed references to "docsrcx" to "docsrc"
Michael Smith [Tue, 17 Jul 2007 15:10:25 +0000 (15:10 +0000)]
Removed obsoleted lrefentry, clrefentry, and jrefhtml stylesheets.
All HTML output is now generated using the reference.xsl
stylesheet (and the build now converts jref content to standard
DocBook content before generating HTML).
Michael Smith [Tue, 17 Jul 2007 15:06:54 +0000 (15:06 +0000)]
Removed cldocbook.xsl and ldocbook.xsl litprog convenience copies
from the releasetools build; they are not used by the docbook-xsl
build, so no point in keeping them.
Michael Smith [Tue, 17 Jul 2007 14:54:22 +0000 (14:54 +0000)]
Renamed experimental docx and docsrcx dirs to become standard doc
and docsrc dirs.
Michael Smith [Tue, 17 Jul 2007 14:44:36 +0000 (14:44 +0000)]
Remove old doc and docsrc dirs; we will rename the docx and
docsrcx dirs to become the new doc and docsrc dirs.
Michael Smith [Tue, 17 Jul 2007 14:30:28 +0000 (14:30 +0000)]
Make all static doc source files into valid DocBook 5 instances.
Michael Smith [Tue, 17 Jul 2007 14:28:13 +0000 (14:28 +0000)]
Aligned main reference-doc "driver" file with recent changes other
doc source files.
Michael Smith [Tue, 17 Jul 2007 14:25:28 +0000 (14:25 +0000)]
Made a minor adjustment to spacing around admon output.
Michael Smith [Tue, 17 Jul 2007 14:16:02 +0000 (14:16 +0000)]
Make the reference.xsl stylesheet (which is used for building the
HTML output of the docs) import the DocBook-element and
docbook-xsl-param auto-hyperlinking stylesheets (which are already
used for adding hyperlinks in the release notes). This makes the
auto-hyperlinking consistent between the systems used for the
release-notes build and for the reference docs.
Michael Smith [Tue, 17 Jul 2007 14:11:59 +0000 (14:11 +0000)]
Don't output prolog in xsl2jref output (no doctype, not public ID,
no system ID). Because otherwise we end up with the output tree
getting populated with implied attributes some of which are no
longer valid in DocBook 5.
Michael Smith [Tue, 17 Jul 2007 14:08:46 +0000 (14:08 +0000)]
Cleaned up template that handles adding markup for sgmltag|tag
instances that are DocBook element names.
Michael Smith [Tue, 17 Jul 2007 14:01:21 +0000 (14:01 +0000)]
Made jref2refsect1 stylesheet convert all @id instances to @xml:id
Michael Smith [Tue, 17 Jul 2007 13:59:29 +0000 (13:59 +0000)]
Make template/titlepage.xsl file valid against our litprog schema.
Michael Smith [Tue, 17 Jul 2007 13:58:02 +0000 (13:58 +0000)]
Make fo/table.xsl file valid against our litprog schema.
Michael Smith [Tue, 17 Jul 2007 13:56:09 +0000 (13:56 +0000)]
Make all common stylesheets with embedded doc valid against our
litprog grammar.
Michael Smith [Tue, 17 Jul 2007 13:52:28 +0000 (13:52 +0000)]
Make pi.xsl files valid against our litprog grammar.
Michael Smith [Tue, 17 Jul 2007 13:49:03 +0000 (13:49 +0000)]
Make lib.xweb valid against our litprog grammar.
Michael Smith [Tue, 17 Jul 2007 05:46:29 +0000 (05:46 +0000)]
Add another build kludge, this one to work around the fact that
xsltproc does schoolmarmish pedantic checking of xml:id values and
doesn't provide any option for preventing it from doing so.
Michael Smith [Tue, 17 Jul 2007 05:44:04 +0000 (05:44 +0000)]
Ignore another build-generated kludge. Yeah, I know it's
ridiculous. If you can come up with a prettier way of doing it,
all of my riches will be yours.
Michael Smith [Tue, 17 Jul 2007 05:40:55 +0000 (05:40 +0000)]
Make PI source files valid against our litprog schema.
Michael Smith [Tue, 17 Jul 2007 05:12:49 +0000 (05:12 +0000)]
Reverting previous commit; xsltproc rejects stylesheets containing
@xml:id values that aren't valid NCNames.
Michael Smith [Tue, 17 Jul 2007 05:11:16 +0000 (05:11 +0000)]
Reverting previous checkin. xsltproc rejects stylesheets
containing @xml:id values that aren't NCNames.
Michael Smith [Tue, 17 Jul 2007 05:07:10 +0000 (05:07 +0000)]
Adding yet another hack to workaround the fact that the DocBook 5
grammar requires @xml:id instead of @id, and xsltproc actually
takes xml:id seriously and checks that it's really a NCName.
Michael Smith [Tue, 17 Jul 2007 04:49:18 +0000 (04:49 +0000)]
Corrected duplicate ID problem introduced in previous commit.
Michael Smith [Tue, 17 Jul 2007 04:39:49 +0000 (04:39 +0000)]
Output programlistingp@xml:id instead of ...@id
Michael Smith [Tue, 17 Jul 2007 04:36:20 +0000 (04:36 +0000)]
Feed doc-baseuri param to stylesheet used for building
release-notes files.
Michael Smith [Tue, 17 Jul 2007 04:34:52 +0000 (04:34 +0000)]
Make programlisting@xml:id instead of @id.
Michael Smith [Tue, 17 Jul 2007 04:28:48 +0000 (04:28 +0000)]
Make *.xweb instances valid against the
https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/params/refentry.rnc
grammar.
Michael Smith [Tue, 17 Jul 2007 03:59:40 +0000 (03:59 +0000)]
Fixed some broken formatting in source files for chunker.* params,
as pointed out by Dave Pawson.
Michael Smith [Mon, 16 Jul 2007 16:45:33 +0000 (16:45 +0000)]
Reverted addition of tag@role=html markup. It's no longer
necessary, because the doc build now has a smarter way of
distinguishing between DocBook elements marked up with the tag
element, and non-DocBook elements marked up with such.
Michael Smith [Mon, 16 Jul 2007 16:21:00 +0000 (16:21 +0000)]
Added the doc-baseuri param to the stylesheet used for
automatically adding hyperlinks in generated doc for stylesheet
params and in release-notes output.
For output of the param doc, doc-baseuri is set to "../" (relative
path so links point to local files).
For release-note output, doc-baseuri is set to the http: url for
the current version of the docbook-xsl docs (instead of to local
files); reason being that when installed from a downstream
package, the release notes can't point to local files because the
release notes are often installed in a separate place for the docs.
Michael Smith [Mon, 16 Jul 2007 16:14:36 +0000 (16:14 +0000)]
Don't prepend "template." to IDs for embedded doc for PIs. (cause
of this was a copy/paste error -- the template for processing
embedded PI documentation began life as a copy of the template for
processing embeded doc for templates)
Michael Smith [Mon, 16 Jul 2007 15:40:18 +0000 (15:40 +0000)]
Eliminated doc/slides/html and doc/slides/fo subdirs. All doc for
for both Slides FO and Slides HTML is now output in the doc/slides
dir.
Bob Stayton [Sun, 15 Jul 2007 19:52:52 +0000 (19:52 +0000)]
Add parameters to the page.sequence utility template.
Steve Ball [Sun, 15 Jul 2007 01:19:04 +0000 (01:19 +0000)]
new stylesheets for better word processor support and easier maintenance
Michael Smith [Sat, 14 Jul 2007 19:58:59 +0000 (19:58 +0000)]
Changed handling of reference auto-labeling such that reference
(when it appears at the component level) is now affected by the
label.from.part param, just as preface, chapter, and appendix.
Michael Smith [Sat, 14 Jul 2007 17:32:27 +0000 (17:32 +0000)]
Make sure that *template.xml files under version control don't get
removed when we clean.
Mauritz Jeanson [Thu, 12 Jul 2007 14:53:21 +0000 (14:53 +0000)]
Clarified that 'extension' refers to file names.
Mauritz Jeanson [Thu, 12 Jul 2007 14:47:40 +0000 (14:47 +0000)]
Fixed level number in refpurpose.
Mauritz Jeanson [Thu, 12 Jul 2007 14:37:53 +0000 (14:37 +0000)]
Added class="attribute" markup.
Mauritz Jeanson [Thu, 12 Jul 2007 13:55:11 +0000 (13:55 +0000)]
The comment element was renamed to remark in DB 4.0.
Mauritz Jeanson [Thu, 12 Jul 2007 09:03:55 +0000 (09:03 +0000)]
Fixed typo.
Mauritz Jeanson [Thu, 12 Jul 2007 08:59:51 +0000 (08:59 +0000)]
Added role/class attributes on some <tag>s to prevent generation of TDG links for DocBook
attributes and HTML elements.
Michael Smith [Thu, 12 Jul 2007 04:20:28 +0000 (04:20 +0000)]
Updated embedded doc in XSL source files:
- added dbhtml@dir PIs to control where output goes when
generation HTML version of docs
- put xml:id instances on root elements of embedded doc
- changed all *info instances to just info (DocBook 5) and some
@id instance to @xml-id
Michael Smith [Thu, 12 Jul 2007 04:11:27 +0000 (04:11 +0000)]
Updated doc CSS file to Use shading for synopsis output, and
changed indenting style.
Michael Smith [Thu, 12 Jul 2007 04:10:17 +0000 (04:10 +0000)]
Changed url for page.png
Michael Smith [Thu, 12 Jul 2007 04:04:57 +0000 (04:04 +0000)]
Don't strip namespace nodes from xsl:stylesheet instances when
generating doc files.
Michael Smith [Thu, 12 Jul 2007 03:14:49 +0000 (03:14 +0000)]
Adjusted xsl2jref to copy over any attributes on source
doc:reference instances (primarily embedded doc for params) and to
also copy any PIs that are children of doc:reference.
That ensures that any id/xml:id attributes get copied over -- so
that they can be used when use.id.as.filename is on -- and that
any dbhtml@dir and dbhtml@filename PIs can be used for moving
files into the correct subdirs and are output with right names.
Michael Smith [Thu, 12 Jul 2007 03:09:21 +0000 (03:09 +0000)]
Updated stylesheet customization layers used for doc build,
including disabling extensions during doc build to prevent "Failed
to load image page.png" error messages.
Michael Smith [Wed, 11 Jul 2007 09:55:29 +0000 (09:55 +0000)]
Kludge to replace xml:id with id so that we can build the docs
without xsltproc squawking about duplicate IDs.
Michael Smith [Wed, 11 Jul 2007 09:52:49 +0000 (09:52 +0000)]
Ignore page.png
Mauritz Jeanson [Wed, 11 Jul 2007 09:42:54 +0000 (09:42 +0000)]
Fixed bug #
1737581 (table.borders.with.css should suppress border attribute).
Mauritz Jeanson [Wed, 11 Jul 2007 07:12:16 +0000 (07:12 +0000)]
Added template for xref to area/areaset.
Part of fix for bug #
1675513 (xref to area broken).
Mauritz Jeanson [Wed, 11 Jul 2007 07:09:12 +0000 (07:09 +0000)]
Added code for generating id attributes on callouts in HTML and FO output.
These patches enable cross-references to callouts placed by area coordinates.
It works for graphic, unicode and text callouts.
Part of fix for bug #
1675513 (xref to area broken).
Michael Smith [Wed, 11 Jul 2007 01:59:25 +0000 (01:59 +0000)]
Updated the part of the notes that relates to build-check and log
file.
Michael Smith [Wed, 11 Jul 2007 01:55:39 +0000 (01:55 +0000)]
Pass the logfile name as a command-line arg to the build-check
script.
Michael Smith [Wed, 11 Jul 2007 01:54:53 +0000 (01:54 +0000)]
Pass noent option to xmllint so that it doesn't do whatever stupid
stuff with named entities that it seems to be trying to do for
god knows what reason.
Michael Smith [Wed, 11 Jul 2007 00:15:09 +0000 (00:15 +0000)]
Had wrong name for hyphenate param; fixed.
Michael Smith [Wed, 11 Jul 2007 00:10:52 +0000 (00:10 +0000)]
Ignore the reference.xml.included file.
Michael Smith [Tue, 10 Jul 2007 23:09:16 +0000 (23:09 +0000)]
Added HTML.manifest to exclude list
Mauritz Jeanson [Tue, 10 Jul 2007 20:41:35 +0000 (20:41 +0000)]
Added fixes to avoid duplicate ids when generate.id.attributes = 1.
This (hopefully) closes bug #
1671052.
Michael Smith [Tue, 10 Jul 2007 14:39:19 +0000 (14:39 +0000)]
Added no-breaking spaces in titles to prevent titles from being
broken in bad places in print output.
Michael Smith [Tue, 10 Jul 2007 09:53:46 +0000 (09:53 +0000)]
Checkpointing.
Michael Smith [Tue, 10 Jul 2007 07:25:57 +0000 (07:25 +0000)]
Ignore some generated files.
Michael Smith [Tue, 10 Jul 2007 07:24:23 +0000 (07:24 +0000)]
Move CSS and PNG source files out of doc dir and into.. doc source
dir. Also, make slides chunks go into slides/fo and slides/html
doc subdirs.
Michael Smith [Tue, 10 Jul 2007 07:22:17 +0000 (07:22 +0000)]
Checkpointing of streamline of doc build to the new Way.
Michael Smith [Tue, 10 Jul 2007 06:37:08 +0000 (06:37 +0000)]
Clean out generate XML doc files for embedded doc.
Michael Smith [Tue, 10 Jul 2007 06:13:23 +0000 (06:13 +0000)]
Don't really need to have css in a separate dir; it's only one
file...
Michael Smith [Tue, 10 Jul 2007 04:48:23 +0000 (04:48 +0000)]
Let's have one slides doc dir with html and fo subdirs.
Michael Smith [Tue, 10 Jul 2007 04:44:40 +0000 (04:44 +0000)]
Removed all doc makefiles; directories are now just empty dirs
waiting to have chunks written to them.
Michael Smith [Mon, 9 Jul 2007 23:21:54 +0000 (23:21 +0000)]
Updated to remove manual error-checking step (since we now have
build-check to do the error-checking)
Michael Smith [Mon, 9 Jul 2007 23:07:28 +0000 (23:07 +0000)]
Made a copy of the doc dir to use temporarily for testing out the
doc build.
Michael Smith [Mon, 9 Jul 2007 23:05:27 +0000 (23:05 +0000)]
Replaced old reference.xml file with reference.dbk (which uses
Xinclude).
Michael Smith [Sun, 8 Jul 2007 23:23:20 +0000 (23:23 +0000)]
set executable prop on build-check
Michael Smith [Sun, 8 Jul 2007 23:15:34 +0000 (23:15 +0000)]
Updated ignore properties on lib dir
Michael Smith [Sun, 8 Jul 2007 23:02:01 +0000 (23:02 +0000)]
Added more useful explanation to output of build-check.
Michael Smith [Sun, 8 Jul 2007 22:57:15 +0000 (22:57 +0000)]
Made build-check return more appropriate exits codes.
Michael Smith [Sun, 8 Jul 2007 22:37:32 +0000 (22:37 +0000)]
Removed now-unneeded Makefile.incl file from docsrcx build.
Michael Smith [Sun, 8 Jul 2007 21:41:10 +0000 (21:41 +0000)]
Added comment to build-check about regexp probably not being as
complete as it could be...
Michael Smith [Sun, 8 Jul 2007 21:39:14 +0000 (21:39 +0000)]
Updated release build notes to cite newly added convenience
scripts.