← Back to branch summary

~ubuntu-branches/ubuntu/jaunty/docbook-xml/jaunty

« back to all changes in this revision

Viewing changes to debian/README.Debian

  • Committer: Bazaar Package Importer
  • Author(s): Steve Langasek
  • Date: 2004-12-15 22:46:22 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20041215224622-62ooije4ba5s0a18
Tags: 4.3-1.1
http://bugs.debian.org/284453
* Non-maintainer upload.
* High-urgency upload for sarge-targetted RC bugfix
* Edit debian/rules to remove build-dependency on symlinks, which is
  slated for removal; and drop no-longer-needed dependency of 
  symlinks (closes: #284453).

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/README.Debian
1
1
docbook-xml -- DocBook XML
2
2
----------------------------------------------------------
3
3
 
4
 
The 'docbook' package contains the SGML DTDs.  This package contains
5
 
the XML versions of the DTDs.  This situation may change soon, since
6
 
it seems that DocBook v5 is officially XML -- I'm not sure whether
7
 
SGML will be dropped (I don't think so).
8
 
 
9
 
A number of customization packages are also available, generally used
10
 
to mark up specialized subsets or special applications of DocBook XML.
11
 
Rather than list them here, please do 'apt-cache search docbook-xml'.
12
 
 
13
 
If you wish to format docbook-xml, use either the
14
 
'docbook-stylesheets' or 'docbook-xsl-stylesheets' packages, for DSSSL
15
 
or XSL stylesheets, respectively.  Instructions on operating those
 
4
DocBook is pretty much the standard for software documentation.  It is
 
5
managed by a committee formed at OASIS, the Organization for the
 
6
Advancement of Structured Information Standards
 
7
<URL:http://www.oasis-open.org/docbook/>.  More information on
 
8
DocBook, including the user support community for it, can be found at
 
9
<URL:http://www.docbook.org/>.
 
10
 
 
11
This package contains the XML versions of the DTDs.  The 'docbook'
 
12
package contains the SGML DTDs.  A number of customization packages
 
13
are also available, generally used to mark up specialized subsets or
 
14
special applications of DocBook XML.  Rather than list them here,
 
15
please do 'apt-cache search docbook-xml'.
 
16
 
 
17
If you wish to format DocBook documents, you'll want to apply a
 
18
stylesheet to the document, in conjunction with a processor which
 
19
applies the style.  The available stylesheets for DocBook are the
 
20
'docbook-dsssl' and 'docbook-xsl' packages, for DSSSL and XSL
 
21
stylesheets, respectively.  Instructions on operating those
16
22
stylesheets and DSSSL or XSL processors is beyond the scope of this
17
 
file, but there is a Debian SGML/XML HOWTO floating around.
 
23
README, but there is a Debian SGML/XML HOWTO at
 
24
<URL:http://www.debian.org/doc/misc-manuals#sgml-howto> which should
 
25
give some guidance.
18
26
 
19
27
--
20
 
.....Adam Di Carlo....adam@onshore.com.....<URL:http://www.onshored.com/>
 
28
Adam Di Carlo <aph@debian.org>
21
29