[xml/sgml-commit] [linuxdoc-tools] 12/12: Some minor pending issues before 0.9.70 release.
Agustín Martín Domingo
agmartin at moszumanska.debian.org
Thu Oct 8 17:28:12 UTC 2015
This is an automated email from the git hooks/post-receive script.
agmartin pushed a commit to branch upstream
in repository linuxdoc-tools.
commit 349d7969873874b53d85e5a315a1a8c08d745088
Author: Agustin Martin Domingo <agmartin at debian.org>
Date: Thu Oct 8 19:01:22 2015 +0200
Some minor pending issues before 0.9.70 release.
Signed-off-by: Agustin Martin Domingo <agmartin at debian.org>
---
ChangeLog | 1 +
README | 48 +++++++++++++++++++++++++-----------------------
doc/README | 20 ++++++++++++++------
linuxdoc-tools.copyright | 3 +--
4 files changed, 41 insertions(+), 31 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 5eeefa3..20c43de 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -14,6 +14,7 @@ please see "doc/CHANGES.Debian-native".
(Debian #800537).
* More versatile handling of doc formats, allowing explicit selection or
full disabling. Add pdf format and built it instead of dvi+ps.
+ * sgmlpre/sgmlpre.l: Fix some "type defaults to 'int'" warnings.
0.9.69:
=======
diff --git a/README b/README
index 752bde9..3b7b825 100644
--- a/README
+++ b/README
@@ -1,18 +1,20 @@
-The Linuxdoc-Tools package: <http://people.debian.org/~sano/linuxdoc-tools/>
+The Linuxdoc-Tools package: <https://gitlab.com/agmartin/linuxdoc-tools>
LinuxDoc is a kind of SGML DTD. It was created for the Linux HOWTOs, and is
being used by the Linux Documentation Project (LDP).
Linuxdoc-Tools is in fact a small bug-fix version of SGML-Tools 1.0.9,
-and is a toolset for processing LinuxDoc DTD SGML files. This is currently
-maintained by Taketoshi Sano <sano at debian.org>.
+and is a toolset for processing LinuxDoc DTD SGML files. It was
+bundled and maintained by Taketoshi Sano <sano at debian.org>, who
+carried out the big changes and wrote text below, and now is in
+maintenance mode by Agustin Martin <agmartin at debian.org>.
-SGML-Tools 1.0.9 is the last official release of SGML-Tools with direct
-support for LinuxDoc DTD. More recent version of SGML-Tools 2.x and
+SGML-Tools 1.0.9 is the last official release of SGML-Tools with direct
+support for LinuxDoc DTD. More recent version of SGML-Tools 2.x and
its successor, SGMLtools-Lite <http://sgmltools-lite.sourceforge.net/>
only supports the conversion from LinuxDoc DTD sgml into DocBook DTD.
-But currently many HOWTO documents in LDP are still provided as
+But currently many HOWTO documents in LDP are still provided as
LinuxDoc DTD sgml files, and many Linux users wish to use the tool
which converts LinuxDoc DTD sgml files into various format directly.
@@ -21,8 +23,8 @@ as a new branch in order to avoid the confusion with the SGML-Tools
and the SGMLTools-Lite.
Since Linuxdoc-Tools is a derivative of SGML-Tools 1.0.9, it has
-almost the same functions of its predecessor. It is a text-formatting
-package based on SGML (Standard Generalized Markup Language), which
+almost the same functions of its predecessor. It is a text-formatting
+package based on SGML (Standard Generalized Markup Language), which
allows you to produce LaTeX, HTML, GNU info, LyX, RTF, and plain text
(via groff) from a single source;
@@ -41,7 +43,7 @@ Now old command form sgml2* is obsoleted and a single command
This system is tailored for LinuxDoc DTD sgml files, and other DTDs
are not supported. If you need the tool for DocBook DTD (which is
-now a more popular DTD than LinuxDoc in writing technical software
+now a more popular DTD than LinuxDoc in writing technical software
documentation), then you should check SGMLTools-Lite, OpenJade,
and docbook-tools. Check their Web sites below.
@@ -54,31 +56,31 @@ and docbook-tools. Check their Web sites below.
The file doc/guide.sgml is Linuxdoc DTD SGML source for the User's Guide,
originally written by Matt Welsh and updated by many people.
-As you probably don't know how to format it yet, there is formatted plain
+As you probably don't know how to format it yet, there is formatted plain
text in doc/guide.txt. There's also guide.dvi and guide.ps, if you wish
-to print them instead. The first thing you should read is doc/guide.txt,
+to print them instead. The first thing you should read is doc/guide.txt,
which explains how to install the software (namely, it tells you to
read the file INSTALL), and how to start writing documents with it.
-The file doc/example.sgml is a simple example document which you can use
+The file doc/example.sgml is a simple example document which you can use
as a tutorial.
-Linuxdoc-Tools depends on the usage of the sgml parser from Jade or
+Linuxdoc-Tools depends on the usage of the sgml parser from Jade or
OpenJade (nsgmls or onsgmls). You have to install either of them.
Matt Welsh originally created the package under the name Linuxdoc-SGML,
using James Clark's sgmls parser and the QWERTZ DTD by Tom Gordon.
Then Greg Hankins maintained it. It was renamed to SGML-Tools later,
and had been maintained by Cees de Groot <cg at cdegroot.com>.
-SGML-Tools 2.x was significantly changed from 1.0.x, and it dropped
-the direct support of Linuxdoc DTD and adopted the support of the DocBook
-DTD using Jade. SGMLtools-Lite is the latest branch from SGML-Tools 2.x,
+SGML-Tools 2.x was significantly changed from 1.0.x, and it dropped
+the direct support of Linuxdoc DTD and adopted the support of the DocBook
+DTD using Jade. SGMLtools-Lite is the latest branch from SGML-Tools 2.x,
and it is maintained by Cees at <http://sgmltools-lite.sourceforge.net/>.
This Linuxdoc-Tools is the branch from SGML-Tools 1.0.9, and its
focus is to provide the backward compatibility for users of the old
Linuxdoc DTD.
-This branch uses patch from JF ("The Japanese FAQ Project") to support
+This branch uses patch from JF ("The Japanese FAQ Project") to support
euc-jp encoded Japanese sgml file on sgml2txt, sgml2html, and sgml2latex.
(sgml2info, sgml2lyx, and sgml2rtf have no special on Japanese support.)
@@ -91,23 +93,23 @@ their patch can be used under the license of the original code.
The JF patch adds also a new DTD named "linuxdoctr", which is a variant
of "linuxdoc" with two more tags (<trans> and <tdate>, for the name of
the translator and for the date, time and version information of
-the translation). This is required by JF ("The Japanese FAQ Project",
+the translation). This is required by JF ("The Japanese FAQ Project",
<http://www.linux.or.jp/JF/>) because the activity in JF includes the
translation of LDP documents into Japanese, and the translation may be
often revised for the same original revision.
Improvements in fmt_txt.pl (<tt> tags in <sect> do not harm in <toc>)
are also included in the original JF patch.
-From version 0.3.7, I have merged pdf patch written by Juan Jose Amor
-<jjamor at hispalinux.es> for sgml-tools 1.0.9. This patch is to use
+From version 0.3.7, I have merged pdf patch written by Juan Jose Amor
+<jjamor at hispalinux.es> for sgml-tools 1.0.9. This patch is to use
pdfLaTeX in sgml2latex to produce nice PDF files. I include the note
-written by Juan at the end of this README, so please check it for this
+written by Juan at the end of this README, so please check it for this
patch.
-And I keep the old documents in old-docs/ subdirectory. If you are
+And I keep the old documents in old-docs/ subdirectory. If you are
interested in history, then please check there.
-Please send me any questions or bug reports, as well as suggestions for
+Please send me any questions or bug reports, as well as suggestions for
improvement.
=== (copied from README.pdf written by Juan Jose Amor for his pdf patch) ===
diff --git a/doc/README b/doc/README
index 27de0e4..3aea53f 100644
--- a/doc/README
+++ b/doc/README
@@ -1,8 +1,10 @@
-This directory contains documentation for the system:
+This directory contains documentation for the system:
o guide.sgml is the SGML source for the LinuxDoc-Tools User's Guide
-o guide.txt is formatted plain ASCII
-These are build (and guide.txt is rebuild) during ``make install'':
+These can be built during ``make build'':
+
+o guide.txt is plain text
+o guide.pdf is PDF
o guide.dvi is DVI
o guide.ps.gz is gzipped PostScript
o guide.info is in GNU info format
@@ -10,12 +12,18 @@ o guide.lyx is LyX format
o html/ contains the HTML version
o rtf/ contains the RTF version
+You can fine tune the doc formats to be built by means of the
+--enable-docs[=types] configuration option or completely disable doc
+building by means of the --disable-docs configuration option.
+Possible values are txt pdf info lyx html rtf dvi+ps. This is enabled
+by default with value "txt pdf info lyx html rtf".
+
You should read guide.txt first - it explains how to install the software
and how to write and format documents using the system.
Also, there's example.sgml, which is a simple SGML example. You should
-format this example (instructions for doing so in the User's Guide) and
+format this example (instructions for doing so in the User's Guide) and
print it out, along with the source, and use it as a model for writing
-your own SGML docs. You can also grab the SGML sources for the Linux HOWTOs
-from sunsite.unc.edu:/pub/Linux/docs/HOWTO/other-formats/sgml. These
+your own SGML docs. You can also grab the SGML sources for the Linux HOWTOs
+from sunsite.unc.edu:/pub/Linux/docs/HOWTO/other-formats/sgml. These
documents together will give you a good start on using the system.
diff --git a/linuxdoc-tools.copyright b/linuxdoc-tools.copyright
index e93ce8f..7222a62 100644
--- a/linuxdoc-tools.copyright
+++ b/linuxdoc-tools.copyright
@@ -34,7 +34,7 @@ Changes after the fork
Copyright (C) 1999-2002 Taketoshi Sano <sano at debian.org>
Copyright (C) 2000 Juan Jose Amor
- Copyright (C) 2007-2013 Agustin Martin Domingo <agmartin at debian.org>
+ Copyright (C) 2007-2015 Agustin Martin Domingo <agmartin at debian.org>
Unless conflicting with other licenses, changes by Agustin Martin
Domingo are free software: you can redistribute and/or modify them
@@ -54,4 +54,3 @@ See below for more specific Copyright notices for
sgmls-1.1/LICENSE for sgmlsasp translator license.
iso-entities/COPYING for iso-entities license.
entity-map/COPYING for entity-map license.
-
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-xml-sgml/linuxdoc-tools.git
More information about the debian-xml-sgml-commit
mailing list