| 1 |
.\" Process this file with |
| 2 |
.\" groff -man -Tascii sgml2txt.1 |
| 3 |
.\" |
| 4 |
.TH SGML2TXT 1 "2025-04-06" |
| 5 |
.SH NAME |
| 6 |
sgml2txt \- create plain text output from a LinuxDoc DTD SGML source file |
| 7 |
.SH SYNOPSIS |
| 8 |
.B sgml2txt [generic-option...] [--manpage] [--filter] [--blanks=\fIn\fB] |
| 9 |
.IR file [.sgml] |
| 10 |
.SH DESCRIPTION |
| 11 |
.B sgml2txt |
| 12 |
is an old and obsoleted form of the text converter command |
| 13 |
of LinuxDoc-Tools |
| 14 |
(its name may be misleading, as it is not a tool for any SGML DTD, only |
| 15 |
supports the SGML LinuxDoc DTD). |
| 16 |
It is recommended to switch the new form |
| 17 |
.B linuxdoc -B text |
| 18 |
now. |
| 19 |
It converts a LinuxDoc DTD SGML source file to ASCII, ISO-8859-1, or EUC-JP |
| 20 |
output. |
| 21 |
Output will appear in |
| 22 |
.I file.txt |
| 23 |
where |
| 24 |
.I file |
| 25 |
is the name of the SGML source file. |
| 26 |
.LP |
| 27 |
The attribute/value pair "output=txt" is set for conditionals. |
| 28 |
.SH OPTIONS |
| 29 |
.B sgml2txt accepts all the generic options described in |
| 30 |
.BR linuxdoc (1), |
| 31 |
and the following specific options: |
| 32 |
.IP "--manpage, -m" |
| 33 |
Outputs a groff source file, suitable for formatting with |
| 34 |
.B groff -man |
| 35 |
for man pages |
| 36 |
.IP "--filter, -f" |
| 37 |
Remove backspace-overstrikes from the intermediate form generated by |
| 38 |
\fBgroff\fR(1). |
| 39 |
.IP "--pass, -P" |
| 40 |
The argument of the pass option is added to the command-line options |
| 41 |
handed to |
| 42 |
.BR groff (1). |
| 43 |
.IP "--blanks=\fIn\fR, -b" |
| 44 |
Set the limit of continuous blank lines for generating the output |
| 45 |
document. |
| 46 |
The default limit is 3. |
| 47 |
If 0 (zero) is specified, |
| 48 |
the result have many continuous blank lines. |
| 49 |
.IP file |
| 50 |
The SGML source file, named either |
| 51 |
.I file |
| 52 |
or |
| 53 |
.I file.sgml |
| 54 |
.SH FILES |
| 55 |
Many files and executables in /usr/share/linuxdoc-tools are used. |
| 56 |
.SH BUGS |
| 57 |
None known. |
| 58 |
.SH AUTHOR |
| 59 |
Originally written by Greg Hankins <[email protected]>, |
| 60 |
based on scripts by Tom Gordon and Alexander Horz, and later |
| 61 |
rewritten by Cees de Groot <[email protected]> for SGML-Tools (v1). |
| 62 |
Previously maintained by Taketoshi Sano <[email protected]> for Linuxdoc-Tools. |
| 63 |
Currently maintained by Agustin Martin <agustin6martin AT gmail com>. |
| 64 |
.SH "SEE ALSO" |
| 65 |
.BR linuxdoc (1), |
| 66 |
.BR sgml2html (1), |
| 67 |
.BR sgml2info (1), |
| 68 |
.BR sgml2latex (1), |
| 69 |
.BR sgml2lyx (1), |
| 70 |
.BR sgml2rtf (1), |
| 71 |
.BR sgmlcheck (1). |