Debian Codegraph @

upstream/debian-unstable/man1/sgml2txt.1

raw
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).