76 lines
1.6 KiB
Groff
76 lines
1.6 KiB
Groff
|
.\" -*- nroff -*-
|
||
|
|
.tr \(ts"
|
||
|
|
.TH RAST 1
|
||
|
|
.SH NAME
|
||
|
|
rast \- translate output of sgmls to RAST format
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.B rast
|
||
|
|
[
|
||
|
|
.BI \-o output_file
|
||
|
|
]
|
||
|
|
[
|
||
|
|
.I input_file
|
||
|
|
]
|
||
|
|
.SH DESCRIPTION
|
||
|
|
.I Rast
|
||
|
|
translates the output of sgmls to the format of a RAST result.
|
||
|
|
RAST is the Reference Application for SGML Testing defined in the Proposed
|
||
|
|
American National Standard on Conformance Testing for Standard Generalized
|
||
|
|
Markup Language (SGML) Systems (X3.190-199X).
|
||
|
|
.I Rast
|
||
|
|
reads from
|
||
|
|
.I input_file
|
||
|
|
or from standard input if
|
||
|
|
.I input_file
|
||
|
|
is not specified.
|
||
|
|
It writes to
|
||
|
|
.I output_file
|
||
|
|
or to standard output if
|
||
|
|
.I output_file
|
||
|
|
is not specified;
|
||
|
|
use of the
|
||
|
|
.B \-o
|
||
|
|
option avoids the need for
|
||
|
|
.I rast
|
||
|
|
to use a temporary file.
|
||
|
|
.LP
|
||
|
|
Note that the
|
||
|
|
.B -c
|
||
|
|
option of
|
||
|
|
.I sgmls
|
||
|
|
can generate a capacity report in RACT format.
|
||
|
|
.SH BUGS
|
||
|
|
Production [9] in clause 14.5.5 of the draft standard is clearly wrong;
|
||
|
|
.I rast
|
||
|
|
corrects it by appending
|
||
|
|
.RI `,\ LE '.
|
||
|
|
An alternative way to correct it would be to delete the
|
||
|
|
.RB `, \(tsEND-ENTITY\(ts '.
|
||
|
|
.LP
|
||
|
|
In production [18] in clause 14.5.9,
|
||
|
|
.RI ` markup\ data +'
|
||
|
|
should be
|
||
|
|
.RI ` markup\ data *'
|
||
|
|
since internal sdata entities need not contain any characters (14.5.11),
|
||
|
|
and
|
||
|
|
.I markup\ data
|
||
|
|
cannot be empty (14.5.9, 14.5.12).
|
||
|
|
.LP
|
||
|
|
The RAST result for the example in Annex B.4 is incorrect.
|
||
|
|
The line
|
||
|
|
.B G03-A1=
|
||
|
|
should be immediately followed by a line
|
||
|
|
.BR !g03-e1! .
|
||
|
|
(The problem with production [9] also applies to this example.)
|
||
|
|
.LP
|
||
|
|
.I Rast
|
||
|
|
outputs a newline after
|
||
|
|
.B #ERROR
|
||
|
|
in order to avoid producing files with partial lines.
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
.IR sgmls (1)
|
||
|
|
.br
|
||
|
|
.I
|
||
|
|
Conformance Testing for Standard Generalized Markup Language (SGML) Systems,
|
||
|
|
(X3.190-199X), Draft July 1991
|