Debian Codegraph @

upstream/debian-unstable/man1/sgmlpre.1

raw
1 .\" Process this file with
2 .\" groff -man -Tascii sgmlpre.1
3 .\"
4 .TH SGMLPRE "1" "1997-11-03"
5 .\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
6 .\" other parms are allowed: see man(7), man(1)
7 .SH NAME
8 sgmlpre \- handle SGML conditionalization for SGML-tools
9 .SH SYNOPSIS
10 .B sgmlpre
11 .I "[options] ..."
12 .SH "DESCRIPTION"
13 This manual page documents briefly the
14 .BR sgmlpre
15 commands.
16 This manual page was written for the Debian GNU/Linux distribution
17 because the original program does not have a manual page for sgmlpre.
18 .PP
19 .B sgmlpre
20 is a program that handle SGML conditionalization for SGML-tools
21 .PP
22 It is used by other programs in sgml-tools (v1), and usually
23 normal user does not need to use this program directly by himself.
24 .PP
25 Following is quoted from the header in the source code.
26 .TP
27 (Begin Quotes)
28
29 .B sgmlpre
30 -- handle SGML conditionalization for SGML-tools
31 by Eric S. Raymond <[email protected]>, 3 Nov 1997
32
33 Filter SGML according to conditionalizing markup.
34 Argument/value pairs
35 from the command line are matched against the attributes of <#if> and
36 <#unless> tags.
37 Spans between <#if>/</#if> are passed through unaltered
38 if there is no attribute mismatch; spans between <#unless></#unless> are
39 passed if there is at least one attribute mismatch.
40 An attribute mismatch
41 happens if an attribute occurs in both the command-line arguments and the
42 tag, but the values do not match.
43 Value matching is by string equality,
44 except that "|" is interpreted as an alternation character.
45 Even if a span
46 is not passed through, its newlines are (this to avoid messing up the
47 line numbers in error messages).
48
49 This lexer requires flex.
50 Limitations; attribute names may only be
51 256 chars long, values may be only 16384 (YY_BUF_SIZE) characters long.
52 Doesn't do checking that only </if> matches <if> and </unless> matches
53 <unless> (that would need a stack and introduce another limit).
54 .TP
55 (End Quotes)
56
57 .SH OPTIONS
58 The program does not support normal command line options.
59 .SH "SEE ALSO"
60 For a complete description, see the header in the source archive.
61 .SH AUTHOR
62 .B sgmlpre
63 was written by Eric S. Raymond <[email protected]>, 3 Nov 1997.
64
65 This manual page was written by Taketoshi Sano <[email protected]>,
66 for the Debian GNU/Linux system (but may be used by others).
67 Currently maintained by Agustin Martin <agustin6martin AT gmail com>.