Age | Commit message (Collapse) | Author |
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
|
|
Includes CI checks comparing installed files based on those from xorgproto
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Current template fails to rebuild the CI container with the current
Debian stable release (a new release since the last update)
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Oracle no longer includes this term in our copyright & license notices.
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Stop running all sorts of compiler tests we don't need since there
is no code in this module to compile. Requires xorg-macros 1.20.
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Found by using:
codespell --builtin clear,rare,usage,informal,code,names
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Signed-off-by: Mihail Konev <k.mvc@ya.ru>
|
|
Place quotes around the $srcdir, $ORIGDIR and $0 variables to prevent
fall-outs, when they contain space.
Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net>
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
|
|
Syncs the invocation of configure with the one from the server.
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
Reviewed-by: Emil Velikov <emil.velikov@collabora.com>
|
|
Causes auto-generation of id attributes to use values based on position in
document, such as id="id-1.5.9.5.2", instead of based on memory address of
parse tree, such as id="idm140664351287904", so that generated documents
end up with the same contents across rebuilds & platforms (especially on
platforms using address space layout randomization).
Does not guarantee long-term stability of links across releases, just
repeatability when building the same release multiple times - values
will change when documents are edited to add/remove/reorder sections.
Only effective when used with version 1.77 or later of the
DocBook XSL stylesheets (released in 2012).
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Used when generating the release notes, to complete the sentence:
The next full release will be X11R&nextrelvers; and is expected in
&nextfullreldate;.
as in "The next full release will be X11R7.8 and is expected in 2013."
in http://www.x.org/releases/X11R7.7/doc/xorg-docs/ReleaseNotes.html
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
See http://people.gnome.org/~walters/docs/build-api.txt
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
In the PDFs and postscript files docs, the Table of Contents should be on its own page if the
doctype='article'. This matches the behavior with doctype='book' documents.
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
|
|
This enables olink documents cross-referencing.
Signed-off-by: Gaetan Nadon <nadon@memsize.(none)>
|
|
For documentation having multiple licenses, the copyright and legalnotice
elements sequence cannot instantiated multiple times.
The copyright notice and license text are therefore coded inside a legalnotice
element. The role attribute on the paragraph is used to allow styling of the
copyright notice text which should not be italicized.
Also restore the font size to the default "medium" size.
Markup example:
<para role="multiLicensing">Copyright © 1994 X Consortium</para>
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
The masterdbs for olink have changed.
Currently only bigreqproto has olinks to libX11.
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
Rather than referring to the external xorg.css stylesheet, embed the content
of the file in the html output produced. This is accomplished by adding
an xsl:template to the customization layer. The content of xorg.css must not
be encoded due to the '<' character.
This makes the whole html docs tree much more relocatable.
In addition, it eliminates xorg.css as a runtime file which makes
xorg-sgml-doctools a build time only package.
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
The objective is to have more spacing between each author so their affiliation
is visually grouped with its author. The previous method was not reliable as
it was making an assumption about the preceeding element.
The new method of reducing the bottom margin for the author should be more
reliable.
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
For olinks to chunked html, the masterdb cannot contain the baseuri
attribute. The xsl parameter olink.base.uri needs to be used in makefiles
for non chunked html while the chunked html does not use it.
The txt and ps documents cannot be an end point of olinks, so no target
dbs will be generated for those formats, hence no masterdb needed either.
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
Mainly for the new xorg-chunk.xsl
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
There is no drastic changes in style, it will go unnoticed
for the most part. Many inconsistencies in titles and headings
were fixed in both books and articles.
The large libX11 specs was used a reference. The border above
each and every section was removed, keeping only level 2 headings.
It alleviates the sense of "being lost". An additional step might be
the section numbering.
The body background and foreground colors are no longer set, which
will not interfere with the user own styling. This should fix #37535.
The figure-float was removed as it was specific for one figure and
did not yield nice results. There is virtually no room for
improvements with what docbook has to offer.
All xorg docs were reviewed to ensure nothing got badly broken.
A few changes in the doc source was made in libX11 and similar
changes need to be done in the remaining xorg docs. They only affect
minor spacing issues.
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
Some large documents will benefit from this feature.
A different docbook xsl file must be imported.
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
This document can be referred to using olink.
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
For olinks to be resolved, updated protos, libs and xserver are required.
These will require XORG_CHECK_SGML_DOCTOOLS(1.8)
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
This is a coordinated change with the packages building DocBook/XML.
The target dbs are now installed alongside the generated documents.
Currently they are installed in $prefix/sgml/X11/dbs alongside masterdb which
has the potential of installing outside the package prefix and cause
distcheck to fail when user does not have write permission in this package.
The master db xi:include statement is changed. It uses a fully qualified
path but could also have used a relative path although it is difficult to
ensure it would work reliably. The generated html/pdf link are still relative.
The README elaborates on requirements which previously existed but were not
introduced by this patch.
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
There is no such document.
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
i18n/framework
i18n/localedb
i18n/trans
libX11
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
Documents external references
-----------------------------
A new feature with version 1.7 is references to documents in other
packages. For example a protocol specifications may refer to another
one or to a library implementing it.
This feature works with PDF, HTML, PS (and epub?) generated documents
and will generate links to the other versions of the same type, i.e. html
docs will link to other html docs, and pdf docs will link to other pdf
docs.
New: generating target databases
--------------------------------
All documents will generate a target db, analogous to a symbol table
which will be consulted by other documents to find linking information.
This is accomplished with xsltproc.
New: consulting target databases
--------------------------------
While documents are being converted from xml to html/pdf/ps,
they will consult the target dbs of each document they which to refer to.
This is accomplished with xmlto.
New: master database
--------------------
A hand written database has been created which provides an association
between the target dbs and the document themselves. It also reflects
the hierarchical structure of the documents relative to the installation dir.
New: xorg-xhtml.xsl and xorg-fo.xsl
-----------------------------------
A number of motivations are behind the new (and split) versions of xorg.xsl.
This module must remain backward compatible to build previous versions
of documentation. It was originally designed a while ago for sgml.
Given that all documents makefile had to change, it seemed a good opportunity
to break from the past. Among the differences:
The location of xorg.css is no longer set in the stylesheet.
The chunked html is no longer supported.
The html and fo parameters are kept separate.
Additional parameters for external references.
Now allows different values for html/fo xsl for the same parameter
should that be required.
The xorg-xhtml.xsl imports html/docbook.xsl
The xorg-fo.xsl imports fo/docbook.xsl
Co-authored-by: Matt Dew <marcoz@osource.org>
Acked-by: Dan Nicholson <dbn.lists@gmail.com>
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
Group statements per section as per Autoconf standard layout
Quote statements where appropriate.
Autoconf recommends not using dnl instead of # for comments
Use AC_CONFIG_FILES to replace the deprecated AC_OUTPUT with parameters.
Add AC_CONFIG_SRCDIR([Makefile.am]) where missing
Update minimum version of util-macros to at least 1.8.
No functional configuration changes
This helps automated maintenance and release activities.
Details can be found in http://wiki.x.org/wiki/NewModuleGuidelines
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
|
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
I must relucantly admit that it is not actually the 47th day of November now.
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
Reviewed-by: Gaetan Nadon <memsize@videotron.ca>
|
|
PDF files can optionally include an active table of contents
that is displayed alongside the pages in the PDF viewer.
These references are called bookmarks.
PDF bookmarks are generated using special functions in each
XSL-FO processor because XSL cannot produce them directly.
Bookmarks will be automatically produced when used with DocBook XSL
stylesheets version 1.70.0 or later
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
Reviewed-by: Alan Coopersmith <alan.coopersmith@oracle.com>
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
|
|
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
Reviewed-by: Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
Acked-by: Peter Hutterer <peter.hutterer@who-t.net>
|
|
Force draft mode to "no" instead of default of "maybe" as discussed in
various posts in http://sources.redhat.com/ml/docbook-apps archives.
For those of us building behind firewalls, shaves approx. 3 minutes off
document creation for each set of documents by not waiting for download
of the draft.png watermark image from the docbook website to time out.
Also gets rid of these errors from xmlto:
Nov 28, 2010 8:10:04 PM org.apache.fop.apps.FOURIResolver resolve
SEVERE: Error with opening URL 'http://docbook.sourceforge.net/release/images/draft.png': Connection timed out
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
Reviewed-by: Adam Jackson <ajax@redhat.com>
Reviewed-by: Gaetan Nadon <memsize@videotron.ca>
|