* spec/*: fixed handling s within 's - s (fixing bug #31538)
* spec/*: started reimplementing handling empty lines around paragraphs,
lists, and examples
* dtd/debiandoc.dtd: made in optional (fixing bug #31493)
* Updated all applicable copyright summaries to reflect new year
* New setup of ToDo list
-- Ardo van Rangelrooij Sat, 6 Feb 1999 21:24:06 +0100
debiandoc-sgml (1.1.12) frozen; urgency=low
* Upload to frozen without any code changes to fix a missing "Suggests"
on libwww-perl needed for creating the HTML output (fixing bug #32467
as well as partly bug #32311)
-- Ardo van Rangelrooij Fri, 29 Jan 1999 21:31:57 +0100
debiandoc-sgml (1.1.11) frozen; urgency=high
* Upload to frozen without code changes per request of Adam Di Carlo as
this version is needed to build the boot-floppies package for slink
(fixing bug #31962). Adam has tested version 1.1.10 extensively and
this upload should not harm the pending release of slink in any way.
-- Ardo van Rangelrooij Sat, 16 Jan 1999 13:41:17 +0100
debiandoc-sgml (1.1.10) unstable; urgency=low
* spec/*: reimplementation of handling and related tags using the
URI::URL module, including handling fragments correctly (fixing bug
#29339) (now really fixing the stupid bug in handling which
version 1.1.9 was supposed to do)
* spec/*: moved one more common functionality to the common module
-- Ardo van Rangelrooij Mon, 14 Dec 1998 17:40:01 +0100
debiandoc-sgml (1.1.9) unstable; urgency=low
* spec/Debiandoc_SGML.pm: Fixed rather stupid bug in handling
causing only the first and the last part of the url to be written
to the generated output (thanks Ivan !)
-- Ardo van Rangelrooij Sun, 13 Dec 1998 21:41:44 +0100
debiandoc-sgml (1.1.8) unstable; urgency=low
* spec/lout: fixed new line in copyright summary (fixing bug #14746)
* spec/html: added DOCTYPE specification to generated HTML files (fixing
bug #29335) (set DOCTYPE to final 3.2 version of the HTML DTD; this
now also makes the generated HTML completely weblint free :-)
* Changed "-*- Mode: -*-" into -*- -*-" (fixing bug #29840)
(thanks Ian !)
* spec/*: moved still more common functionality to the common module
(now only the tough parts are left to do)
-- Ardo van Rangelrooij Sat, 12 Dec 1998 19:26:05 +0100
debiandoc-sgml (1.1.7) unstable; urgency=low
* Added tag
* spec/*: moved even more common code to the common module
* spec/*,i18n/*: cleaned-up i18n data
* spec/texinfo: fixed incomplete handling
* spec/html: code clean-up
* spec/html: improved look&feel of generated HTML code and layout
* spec/html: removed font change in handling
(fixing bug #29336 and becoming weblint free)
* spec/text*: improved layout of document end
* spec/*: made title of "Copyright Notice" and such consistent
* dtd/debiandoc.dtd: allow multiple s
* spec/*: handle multiple s
* spec/html: improved handling
to be weblint free
(except for the COMPACT attribute)
-- Ardo van Rangelrooij Tue, 17 Nov 1998 19:22:19 +0100
debiandoc-sgml (1.1.6) frozen unstable; urgency=high
* spec/DebianDoc_SGML.pm: fixed stupid typo in handling
(fixes bug #29198) (thanks Adam !)
-- Ardo van Rangelrooij Mon, 9 Nov 1998 21:24:58 +0100
debiandoc-sgml (1.1.5) unstable; urgency=low
* spec/*: moved some common tag processing logic to a common module
* spec/*: fixed bug in handling [s in s
* spec/*: consistent removal of leading and trailing whitespaces
-- Ardo van Rangelrooij Thu, 15 Oct 1998 20:55:53 +0200
debiandoc-sgml (1.1.4) unstable; urgency=high
* spec/*: fixed handling (fixes bug #27141)
* spec/text: replaced `*' by `_' to indicate emphasis
* Added tag (wishlist #26787 and #26965)
* spec/{text|textov}: various layout improvements
-- Ardo van Rangelrooij Mon, 28 Sep 1998 16:51:04 +0200
debiandoc-sgml (1.1.3) unstable; urgency=low
* i18n/*.latex2e: unnecessary, hence removed
* Makefile: only install i18n files if they exist
* Added Texinfo output generation
* Added Info via Texinfo output generation
* spec/latex2e: improved handling
-- Ardo van Rangelrooij Sat, 29 Aug 1998 14:38:34 +0200
debiandoc-sgml (1.1.2) unstable; urgency=low
* Added tag
* Added LaTeX2e output generation
* Added DVI via LaTeX2e output generation
* Added PostScript via DVI output generation
* debiandoc2ps.1: various minor updates and fixes
* debian/{postint,prerm}: Fixed broken action handling (fixes bugs
#24918 and #25147) (thanks Adam !)
* debiandoc2{dvi,dvips,ps}: Added check for existance of external
programs before calling them (fixes bug #25116) (thanks Adam !)
-- Ardo van Rangelrooij Mon, 10 Aug 1998 21:21:05 +0200
debiandoc-sgml (1.1.1) unstable; urgency=low
* debiandoc2ps.1: changed paper(1) into papersize(5) (#24591)
* Added PUBLIC SGML identifier (#24106)
* Added doc-base support
* debian/{postinst,prerm}: enhanced
* debian/postrm: renamed to debian/prerm
-- Ardo van Rangelrooij Mon, 13 Jul 1998 19:19:03 +0200
debiandoc-sgml (1.1.0) unstable; urgency=low
* Added tag
* Added and tags
* debiandoc-sgml.sgml: documented that SUBDOC is not supported (#24026)
* dtd/debiandoc.dtd: added "id" attribute to tag
* debiandoc-sgml.sgml: normalized
* saspconvert: completely overhauled
* debiandoc2ps: fixed typo in error message
* debiandoc2ps.1: fixed various typos
* debiandoc2ps.1: moved copyright statement to separate section
* debiandoc2ps.1: added mention of language support via LANG
* Makefile: various minor changes
* spec/textov: splitted off from spec/text
* spec-{html,lout,text}: moved to spec directory as {html,lout,text}
* markup.sgml: renamed to debiandoc-sgml.sgml
* Added TODO list
* Maintainer's email address changed
-- Ardo van Rangelrooij Mon, 22 Jun 1998 17:27:23 +0200
debiandoc-sgml (1.0.18) frozen unstable; urgency=high
* spec-html,spec-lout: fixed a stupid perl typo (fixes bug #22316)
-- Ardo van Rangelrooij Mon, 11 May 1998 22:47:24 +0200
debiandoc-sgml (1.0.17) frozen unstable; urgency=low
* spec-text: fixed copyright section at wrong place bug (fixes bug #14749)
* spec-lout: fixed consecutive footnotes bug (fixes bug #4478)
* spec-{html,lout,text}: complete overhaul and clean-up
-- Ardo van Rangelrooij Wed, 22 Apr 1998 23:31:03 +0200
debiandoc-sgml (1.0.16) frozen unstable; urgency=low
* README: updated to reflect current usage and copyright
* debian/control: updated to reflect current usage
* debian/copyright: updated to reflect current usage and copyright
* debian/rules: changed to use debhelper
* debian/rules: removed handling of sgml.catalog
* Makefile: added handling of sgml.catalog
* debian/control: updated to debian standard 2.4.0.0
* debiandoc2* scripts: fixed insecure temp file creation (fixes bug #19717)
-- Ardo van Rangelrooij Sat, 4 Apr 1998 22:08:39 +0200
debiandoc-sgml (1.0.15) frozen unstable; urgency=medium
* Changed suggested libpaper into libpaperg (fixes bug #20014).
* Removed explicit use of /usr/lib/sgml and /etc/sgml.catalog from the
debiandoc2* scripts, since nsgmls already "knows" about them (fixes
second part of bug #19718).
* Added uninstall target to Makefile to help keeping /usr/local/ clean.
* Fixed dependency bug in Makefile causing debian/tmp paths in scripts
(fixes bug #19863 and first part of bug #19718).
-- Ardo van Rangelrooij Tue, 17 Mar 1998 13:28:12 +0100
debiandoc-sgml (1.0.14) unstable; urgency=low
* Added support for i18n (bug #16173).
* Added tag (bug #14925).
-- Ardo van Rangelrooij Thu, 26 Feb 1998 21:43:25 +0100
debiandoc-sgml (1.0.13) unstable; urgency=low
* Fixed debiandoc2ps bug: excluding tilde character in output (bug #17623).
-- Ardo van Rangelrooij Tue, 17 Feb 1998 21:19:35 +0100
debiandoc-sgml (1.0.12) unstable; urgency=low
* New maintainer.
-- Ardo van Rangelrooij Wed, 14 Jan 1998 20:11:13 +0100
debiandoc-sgml (1.0.11) unstable; urgency=low
* Fixed bugs in HTML output (bug #12258)
Thanks to Ian for the patch!
* Upgraded to standards version 2.3.0.0
-- Christian Schwarz Fri, 17 Oct 1997 16:23:32 +0200
debiandoc-sgml (1.0.10) unstable; urgency=low
* Fixed debiandoc2ps' usage message (bug #11424).
* Fixed debiandoc2lout problem: lout produced an error message if
$title or $version contained newlines (bug #11427).
* Thanks to Ian for the patches!
-- Christian Schwarz Sat, 2 Aug 1997 19:18:53 +0200
debiandoc-sgml (1.0.9) unstable; urgency=low
* Fixed bug that occured with perl5.004: debiandoc2text added
mysterious digits at end of lines.
* Upgraded to standards version 2.2.0.0.
-- Christian Schwarz Sat, 19 Jul 1997 18:30:03 +0200
debiandoc-sgml (1.0.8) unstable; urgency=low
* Moved dtd into /usr/lib/sgml/dtd (fixed bug #8485).
* Moved "general" entities into /usr/lib/sgml/entities.
* Added dependency on sgml-base.
* Uses install-sgmlcatalog to install SGML catalog file.
-- Christian Schwarz Tue, 6 May 1997 17:11:36 +0200
debiandoc-sgml (1.0.7) frozen unstable; urgency=medium
* New maintainer.
-- Christian Schwarz Thu, 17 Apr 1997 15:58:01 +0200
debiandoc-sgml (1.0.6-1.2) frozen unstable; urgency=medium
* Upgraded to package standard 2.1.3.0.
* Package is now independend from sgml-tools.
* Fixed debiandoc2ps to work with new bash 2.0.
* Now suggests lout.
* Uploaded to frozen and unstable.
-- Christian Schwarz Thu, 3 Apr 1997 20:36:45 +0200
debiandoc-sgml (1.0.6-1.1) frozen unstable; urgency=medium
* Non-maintainer release.
* Fix to make package work with sgml-tools.
* Depend on sgml-tools.
* Uploaded to frozen and unstable.
-- Christian Schwarz Mon, 31 Mar 1997 18:34:14 +0200
debiandoc-sgml (1.0.6) unstable; urgency=medium
* bash 2.0 compatible syntax in usage error message. (Bug#7064.)
* `paper' program and env. var in libpaper now called `paperconf';
* Dependency on libpaper added.
* Maintainer email address corrected/updated.
-- Ian Jackson Tue, 4 Feb 1997 22:54:38 +0000
debiandoc-sgml (1.0.5) unstable; urgency=low (HIGH for building dpkg)
* debiandoc2ps -O (output to stdout) works.
* Lout converter uses `paperconf' (thanks to Yves Arrouye).
* Manpages installed compressed.
* dpkg-gencontrol invocation moved to near end of debian/rules.
* Some typos in markup manual corrected.
* Spurious `t' file removed from source package.
* Updated to Standards-Version 2.1.0.0.
-- Ian Jackson Sun, 1 Sep 1996 23:59:20 +0100
debiandoc-sgml (1.0.4) unstable; urgency=low
* converter scripts remove temporary files and can write to stdout.
* PostScript converter can produce 1-up as well as 2-up output.
* PostScript converter has some support for paper size determination.
* Split binary target into binary-indep and binary-arch.
* Updated Standards-Version.
* Released into `unstable'.
-- Ian Jackson Fri, 23 Aug 1996 12:04:28 +0100
debiandoc-sgml (1.0.3) experimental; urgency=low
* Converters work again. Oops.
* Lout (and hence PostScript) more space at end of compact list.
* Minor markup manual improvements.
-- Ian Jackson Mon, 12 Aug 1996 02:30:24 +0100
debiandoc-sgml (1.0.2) experimental; urgency=medium
* PostScript converter really works now, honest.
* Markup authors' manual provided (in /usr/doc, HTML format).
* Manpages for converters included.
* Source package archival corrected.
* PostScript converter displays error messages from Lout.
* saspconvert prints correct name in error messages.
-- Ian Jackson Sun, 11 Aug 1996 17:42:46 +0100
debiandoc-sgml (1.0.1) experimental; urgency=low
* Fixed misplaced bracket in Lout formatter.
-- Ian Jackson Sun, 11 Aug 1996 13:26:27 +0100
debiandoc-sgml (1.0) experimental; urgency=LOW
* Initial release.
-- Ian Jackson Sat, 10 Aug 1996 22:01:38 +0100
debian/debiandoc-sgml.examples 0000644 0000000 0000000 00000000013 11655740662 013604 0 ustar examples/*
debian/control 0000644 0000000 0000000 00000002362 12145725301 010574 0 ustar Source: debiandoc-sgml
Section: text
Priority: optional
Maintainer: Osamu Aoki
Standards-Version: 3.9.3
Build-Depends: debhelper (>= 8.1.3~), sgml-base (>= 1.26+nmu2)
Vcs-Git: git://git.debian.org/git/collab-maint/debiandoc-sgml.git
Vcs-browser: http://git.debian.org/?p=collab-maint/debiandoc-sgml.git
Package: debiandoc-sgml
Architecture: all
Depends: ${perl:Depends}, ${misc:Depends}, libhtml-parser-perl, libroman-perl, libtext-format-perl, sgml-data, sgmlspl, sp
Recommends: ghostscript, texlive, texlive-latex-extra, texinfo
Suggests: debiandoc-sgml-doc, latex-cjk-all, texlive-lang-all
Multi-Arch: foreign
Description: DebianDoc SGML DTD and formatting tools
This is an SGML-based documentation formatting package used for the
Debian manuals. It reads markup files and produces HTML, LaTeX, DVI
(via LaTeX), PostScript (via LaTeX/DVI), PDF (via LaTeX), Texinfo,
Info (via Texinfo), DebianDoc SGML, DocBook XML, plain text (with
overstrikes a la troff as well as without) files.
.
The LaTeX based output needs the texlive, texlive-latex-extra and
texlive-lang-all packages. In addition to this, Chinese and Japanese need
latex-cjk-all and corresponding font packages.
.
The Texinfo based output needs the texinfo package.
debian/copyright 0000644 0000000 0000000 00000003624 11734602744 011136 0 ustar Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Source: http://git.debian.org/?p=collab-maint/debiandoc-sgml.git
Comment: This the Debian package of DebianDoc-SGML, an SGML based
documentation formatting package used for the Debian manuals.
.
It was assembled by Ian Jackson . It was
maintained by Ardo van Rangelrooij . It is
currently maintained by Osamu Aoki .
.
The DTD was inspired by linuxdoc.dtd which was based on QWERTZ.
Contributors to linuxdoc.dtd include Matt Welsh, Greg Hankins, Eric
Raymond, Marc Baudoin, Tristan Debeaupuis and Tom Gordon.
Files: *
Copyright: Copyright (c) 1996 Ian Jackson
Copyright (C) 1997 Christian Leutloff
Copyright (c) 1998-2004 Ardo van Rangelrooij
Copyright (c) 2005-2012 Osamu Aoki
License: GPL-2+
This is free software; you may redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2, or (at your option) any later
version.
.
This is distributed in the hope that it will be useful, but without
any warranty; without even the implied warranty of merchantability or
fitness for a particular purpose. See the GNU General Public License
for more details.
.
You should have received a copy of the GNU General Public License with
your Debian GNU/Linux system, in /usr/share/common-licenses/GPL, or
with the debiandoc-sgml source package as the file COPYING. If not,
write to the Free Software Foundation, Inc.,
51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
Files: sgml/entities/debiandoc-lat*
Copyright: (C) International Organization for Standardization 1986
License: Other
Permission to copy in any form is granted for use with
conforming SGML systems and applications as defined in
ISO 8879, provided this notice is included in all copies.
debian/debiandoc-sgml.sgmlcatalogs 0000644 0000000 0000000 00000000201 11655740662 014445 0 ustar sgml/dtd/catalog /usr/share/sgml/debiandoc/dtd/sgml/1.0/catalog
sgml/entities/catalog /usr/share/sgml/debiandoc/entities/catalog
debian/README.Debian 0000644 0000000 0000000 00000022134 11655740662 011245 0 ustar debiandoc-sgml for debian
-------------------------
For the full manual, please install debiandoc-sgml-doc and read it.
Also see files in /usr/share/doc/debiandoc-sgml/examples/* for DocBook XML
conversion examples and helper scripts.
=== NOTICE ===
The DebianDoc-SGML is becoming less used and its is not accepting any
new feature enhancements except localization data.
If you are creating a new documentation project or start making major
updates on the existing documents, please consider to use Docbook XML
system instead of DebianDoc-SGML because you will need things like
tables and figures which are not supported by this debiandoc-sgml
platform.
New direct conversion tool debiandoc2dbk in this package should provide
easy transition of existing debiandoc-sgml document contents into
DocBook XML format with minor manual interaction.
Since this is perl5/shell based script, it should run on squeeze without
any modification if texlive tools are installed.
------------------
DebianDoc-SGML is an SGML DTD and a set of formatting tools. These
tools convert an SGML document conforming to the DebianDoc-SGML DTD into
various output formats. This DTD is mainly used for, but not limited to
Debian specific documents.
Please install debiandoc-sgml-doc and read the full manual.
Currently, the following output formats are supported:
- HTML
- XHTML
- plain text
- overstrike text
- LaTeX
- DVI (via LaTeX)
- PS (via LaTeX/DVI)
- PDF (via pdfLaTeX)
- Texinfo
- Info (via Texinfo)
- Docbook XML (direct conversion)
- Wiki (direct conversion) (somewhat usable)
Please note that new Docbook XML and and Wiki conversion tools produce
mostly usable data but you still need to perform some manual operation
to get the output of these commands to function properly.
The tutorial of this tool and the use of the markup tags can be found in
the 'debiandoc-sgml-doc' package. The documentation for the tools is in
the manual page 'debiandoc-sgml(1)'.
The exact definition of the markup tags can be found as the DTD toward
the end of the /usr/share/sgml/debiandoc/dtd/sgml/1.0/debiandoc.dtd .
The Debian mailing list 'debian-sgml@lists.debian.org' is used to
discuss issues related to SGML on Debian systems (with an stress on
proper integration of tools, packaging standards and the writing of
documentation for SGML users).
The Debian mailing list 'debian-doc@lists.debian.org' is used to discuss
issues related to Debian specific documentation, including the use of
the DebianDoc-SGML.
If you find a bug in this package, please report it using command
`reportbug debiandoc-sgml' and sending your mail to the Debian Bug
Tracking System (BTS) after reading this document.
If you find lack of support or problem to your language, please do the
following to customize the localization support by using -X option.
$ cp -a /usr/share/perl5/DebianDoc_SGML/Locale /your/path
$ cd /your/path
$ vim Alias.pm
... add new locale xx_YY.zzzz entry.
$ cp -a en_US.ISO8859-1 xx_YY.zzzz
$ cd xx_YY.zzzz
$ vim HTML LaTeX Texinfo Text TextOV
... translate contents and fix LaTeX header data
$ cd /your/source
$ debiandoc2html -X /your/path your_source.sgml
... (try other commands)
If you reach successful resilt, please send a bug report with these
files to BTS using reportbug. (It is better to make them a gzipped file
attachment to avoid encoding errors.) The localization request must
supply these translated text information. (If the localization support
bug reports do not supply these translated texts, they will be closed.)
Please note some convention for specifying LaTeX code generation.
/usr/share/perl5/DebianDoc_SGML/Locale/??_??.?????/LaTeX has contents
%locale = (
'babel' => '',
'inputenc' => '',
'abstract' => '',
'copyright notice' => '',
'before begin document' => '',
'after begin document' => '',
'before end document' => '',
'pdfhyperref' => ''
);
* The first 2 are used to define language scheme based on the babel macro.
For CJK, this can be undefined.
* The next 2 are for the word used for abstract and copyright notice in that
pertinent language.
* The next 3 are recent addition which provide very flexible ways to create
proper LaTeX source. CJK uses these (Can be omitted for European languages)
* The last one is defined as "hypertex" abd determins how hyperref for
PDF are generated. (This seems be defined as "unicode" for UTF-8 but I
do not know exacr rule?)
The /usr/share/perl5/DebianDoc_SGML/Format/LaTeX.pm file uses the value
defined above to generate LaTeX source header etc.
Similar thing can be done for HTML with %locale values in
/usr/share/perl5/DebianDoc_SGML/Locale/??_??.?????/HTML. The
/usr/share/perl5/DebianDoc_SGML/Format/HTML.pm file uses the value for
"charset" in this when generating HTML. Thus this part need to be
different depending on the encoding used.
Although the document format for the Debian documentation should be
moving from this DebianDoc SGML to more versatile DocBook XML, we are
still supporting this SGML tool package with bug fixes to the
localization and other key functions for lenny release.
This may not be true for the subsequent release. So we strongly
encourage you again to adopt newer DocBook XML as soon as possible.
Please note that you do not need to use all the tags of DocBook XML to
make documentation.
Since the source SGML file conversion to DocBook XML format can be done
very easily from 1.1.86, there is not much reason to enhance this SGML
tool with new features any more. So we will only perform non-aggressive
maintenance. Minor cosmetic formatting bugs and feature requests will
be considered 'wishlist' and 'wontfix' bugs if they do not accompany
good patches.
Recent debiandoc2* tools have "-s" option. It allows us to run a hook
script on the generated latex source. Current default script for latex
related conversions is found at /usr/share/debiandoc-sgml/fixlatex. It
addresses issues for the traditional Chinese encoding of zh_TW by
escaping problematic code sequences. For customizing LaTeX code
generation, please use -X function.
Now debiandoc2* commands should work for UTF-8 source if proper locale,
such as en.UTF-8, ja.UTF-8, en_US.UTF-8, or ja_JP.UTF-8 is given to the
-l option.
As for debiandoc2latex*, it may be somewhat buggy until we get help from
the expert support on LaTeX babel and CJK macro support. If you know
how to fix this situation, please send the correct:
/usr/share/perl5/DebianDoc_SGML/Locale/??_??.?????/LaTeX .
If you are not sure what encoding value string to give to -l option,
please read the /usr/share/perl5/DebianDoc_SGML/Locale/Alias.pm file.
The /usr/share/perl5/DebianDoc_SGML/Locale/ part of above 2 paragraphs
can be replaced with the absolute directory specified in -X option
argument. This is handy if you need to have local modification or
addition of Locale dependent data without changing the package.
If you face issues with generated XML, please send us bug report with
minimum example XML source "foo.dbk" with the result of following
command.
SP_CHARSET_FIXED=YES SP_ENCODING=XML nsgmls -wxml -mdeclaration/xml.soc -gues /usr/share/sgml/declaration/xml.dcl foo.dbk
Multifile XML needs xsltproc command to be invoked with --xinclude option.
If you want to preserve include file as separate file, you should follow
instruction in the appendix of debiandoc-sgml-doc. The trick to preserve
ENTITY as ENTITY is also documented there too.
For alternative XML conversion tool, you should check debiandoc2dbxml
tool too. It uses XSLT. That document also contain good information.
(I think debiandoc2dbk does better job thesed days...)
------------------
New Debian Policy "12.2 Info documents" support.
In order to properly install info documents, we need to include something like:
@dircategory Individual utilities
@direntry
* example: (example). An example info directory entry.
@end direntry
In order to help you to do tis via -s option, place marker is placed as in
texinfo file generated:
@c %**add dircategory and direntry here
Let's see how menu package use this. It creates a shell script file
menu.direntry (permission 755) as:
->8--menu.direntry----
#!/bin/sh
sedscript=`tempfile`
cat <<'EOF' > $sedscript
/@c %\*\*add dircategory and direntry here/a\
@dircategory Information\
@direntry\
* Debian menu: \(menu\). The Debian menu system\
@end direntry
EOF
sed -f $sedscript <$1 >$2
rm $sedscript
--------------------------
Test this as:
$ debiandoc2texinfo -s menu.direntry menu.sgml
OK it works for texinfo. It is used with debiandoc2info in menu package's
build script as:
$ debiandoc2info -s menu.direntry menu.sgml
--
Ardo van Rangelrooij (ardo@debian.org),
Osamu Aoki (osamu@debian.org) and the team
DebianDoc-SGML Pkgs
Updated for -X by Osamu Aoki (osamu@debian.org) Sun, 11 May 2008 17:23:43 +0900
Updated for info by Osamu Aoki (osamu@debian.org) Fri, 18 Sep 2009 21:07:14 +0900
Updated for debiandoc2dbk by Osamu Aoki (osamu@debian.org) Sun, 16 Jan 2011 23:21:05 +0900
debian/TODO 0000644 0000000 0000000 00000007410 11655740662 007674 0 ustar ------------------------------------------------------------------------------
To do list for debiandoc-sgml
------------------------------------------------------------------------------
Considering general trend towards DocBook XML and availability of DocBook XML
conversion tools such as debiandoc2dbk within this package, the maintenance of
DebianDoc-SGML package will be very conservative and the feature enhancement
are unlikely. See README.Debian. If you are starting new documentation,
please use Docbook XML.
Legend: S = scripts, D = DTD, B = backends, P = package
BUGS:
------------------------------------------------------------------------------
SDBP Number Description
------------------------------------------------------------------------------
------------------------------------------------------------------------------
WISHLIST:
------------------------------------------------------------------------------
SDBP Number Description
------------------------------------------------------------------------------
p 218529 debiandoc2ps silly output handling
x x 229849 lacks option for single-sided printing
x 238003 handling of -- in and
x? 285885 ` will be changed to ' in section (ps, pdf)
------------------------------------------------------------------------------
VARIOUS
------------------------------------------------------------------------------
SDBP Prior. Description
------------------------------------------------------------------------------
x +++++ complete SDATA map for all supported locales and formats
x ++++ fix compact lists in Texinfo (bug in Texinfo !!!)
x +++ make references consistent wtr their look and feel
xx ++ add format support for references
x +++ maybe also use `papersize -Ns` in LaTeX
x +++ option in LaTeX to mark overflown text
x +++ relation paperconf and dvips, check for papersize, etc.
x + support long option names
xxxx ? add locale indicator (PI)
------------------------------------------------------------------------------
Following feature enhancement requests once existed. Since
debiandoc-sgml is an old tool in conservative maintenance situation,
these features will not be implemented. Many of these feature are
available in Docbook XML.
------------------------------------------------------------------------------
Description
------------------------------------------------------------------------------
add an id attribute to ]-
add an id attribute to all elements
add
,
add ,
add ,
support wml
support HTML via LaTeX
support HTML, DVI, PS, and PDF via Texinfo
support HTML, DVI, PS, PDF, Text and TextOV via groff
groff backend
manual page support
------------------------------------------------------------------------------
Following locales are known not to work well with debiandoc2latex* tool chain.
LaTeX expert help requested.
Korean problem should be problem of this package.
Others may be problem of other packages. (Now I start
seeing problem on lt_LT too.)
If you have fix to above failures, let us know.
#########################################################
### Known problems for building source with this tool ###
#########################################################
FAIL: latexps ANY ***** for gl_ES.ISO8859-1 *****
FAIL: latexpdf ANY ***** for gl_ES.ISO8859-1 *****
FAIL: latexps ANY ***** for gl_ES.ISO8859-15 *****
FAIL: latexpdf ANY ***** for gl_ES.ISO8859-15 *****
FAIL: latexps ANY ***** for gl_ES.UTF-8 *****
FAIL: latexpdf ANY ***** for gl_ES.UTF-8 *****
FAIL: latexps ANY ***** for ko_KR.eucKR *****
FAIL: latexpdf ANY ***** for ko_KR.eucKR *****
FAIL: latexps ANY ***** for ko_KR.UTF-8 *****
FAIL: latexpdf ANY ***** for ko_KR.UTF-8 *****
Sat, 08 Jan 2011 15:15:41 +0900
debian/rules 0000755 0000000 0000000 00000001020 11734603127 010243 0 ustar #!/usr/bin/make -f
## ----------------------------------------------------------------------
## uncomment this to turn on verbose mode
#export DH_VERBOSE=1
%:
dh $@
# do not test
override_dh_auto_test:
override_dh_auto_build:
dh_auto_build -- prefix=/usr
override_dh_auto_install:
dh_auto_install -- prefix=/usr
## ----------------------------------------------------------------------
diff:
dh build
$(MAKE) diff
.PHONY: diff
## ----------------------------------------------------------------------
debian/source/ 0000755 0000000 0000000 00000000000 12145733757 010504 5 ustar debian/source/format 0000644 0000000 0000000 00000000015 12145733757 011713 0 ustar 3.0 (quilt)
debian/source/lintian-overrides 0000644 0000000 0000000 00000000111 11734603751 014047 0 ustar debiandoc-sgml source: package-needs-versioned-debhelper-build-depends 9