osx(1)
NAME
osx - An SGML System Conforming to International Standard
ISO 8879 -- Standard Generalized Markup Language. An SGML
Extended Facilities system conforming to Annex A of Inter
national Standard ISO/IEC 10744 -- Hypermedia/Time-based
Structuring Language.
SYNOPSIS
osx [-CeghnRvx] [-aname] [-Aarchitecture] [-bencoding]
[-ccatalog_file] [-ddirectory] [-Ddirectory]
[-iname] [-ffile] [-ldirectory] [-wwarning_type]
[-xxml_output_option...] [sysid...]
DESCRIPTION
osx converts SGML to XML. osx parses and validates the
SGML document contained in [sysid] and writes an equiva
lent XML document to the standard output. osx will warn
about SGML constructs which have no XML equivalent.
OPTIONS
The following options are available:
- -aname, --activate=name
- Make doctype or linkname name active.
- -Aname, --architecture=name
- Parse with respect to architecture name.
- -bencoding, --encoding=encoding
- Use the BCTF encoding for output. By default osx uses UTF-8.
- -csysid, --catalog=sysid
- Map public identifiers and entity names to system
identifiers using the catalog entry file whose sys
tem identifier is sysid. - -C, --catalogs
- This has the same effect as in onsgmls(1).
- -ddirectory, --entity_output_location=directory
- Place output files in directory.
- -Ddirectory, --directory=directory
- Search directory for files specified in system
identifiers. This has the same effect as in ons
gmls(1). - -e, --open-entities
- Describe open entities in error messages.
- -Emax_errors, --max-errors=max_errors
- Give up after max_errors errors.
- -ffile, --error-file=file
- Redirect errors to file. This is useful mainly with
shells that do not support redirection of stderr. - -g, --open-elements
- Describe open elements in error messages.
- -h, --help
- Display a help text and exit.
- -iname, --include=name
- This has the same effect as in onsgmls(1).
- -ldtd-file, --dtd_location=dtd-file
- Specify that the resulting XML file should conform
to the DTD in dtd-file. - -n, --error-numbers
- Show error numbers in error messages.
- --references
- Show references in error messages.
- -R, --restricted
- This has the same effect as in onsgmls(1).
- -v, --version
- Print the version number and exit.
- -wtype, --warning=type
- Control warnings and errors according to type. This
has the same effect as in onsgmls(1). - -xxml_output_option, --xml-output-option=xml_output_option
- Control the XML output according to the value of
xml_output_option as follows: - no-nl-in-tag Don't use newlines inside start-tags.
Usually osx uses newlines inside start-tags so as
to reduce the probability of excessively long
lines. - id Output attribute declarations for ID attributes.
- notation Output declarations for notations.
- ndata Output declarations for external data enti
ties. XML requires these to be NDATA. osx will warn
about CDATA and SDATA external data entities and
output them as NDATA entities. - cdata Use XML CDATA sections for CDATA marked
sections and for elements with a declared content
of CDATA. - comment Output comment declarations. Comment decla rations in the DTD will not be output.
- lower Prefer lower case. Names that were subjected
to upper-case substitution by SGML will be folded
to lower case. This does not include reserved
names; XML requires these to be in upper-case. - pi-escape Escape &<> in the contents of processing
instructions using the amp, lt and gt entities.
This allows processing instructions to contain the
string >?, but requires that applications handle
the escapes. - empty Use the <e/> syntax for element types e
declared as EMPTY. - attlist Output an ATTLIST declaration for every
element specifying the type of all attributes. The
default will always be #IMPLIED. - report-input-sources Output a processing instruc
tion to report when an input source other than the
main file is opened or closed in the instance. Do
not report any input source changes in the DTD. - report-entities Output a processing instruction to
report when an external entity reference has been
resolved in the instance. Do not report any entity
resolutions in the DTD. - no-expand-external Preserve external entities,
write a declaration driver file named "extEnti
ties.dtf", and include that file in the instance's
internal subset. - no-expand-internal Preserve internal entities,
write a declaration driver file named "intEnti
ties.dtf", and include that file in the instance's
internal subset. - no-external-decl Do not include the external enti
ties declaration driver file in the instance's
internal subset. - no-internal-decl Do not include the internal enti
ties declaration driver file in the instance's
internal subset. - sdata-as-pis When translating SDATA entities
(whether expanding them or providing a definition
for them in the output's internal subset), express
them as processing instructions instead of as gen
eral internal entities. - Multiple -x options are allowed.
SEE ALSO
onsgmls(1), ospam(1), onsgmlnorm(1), ospent(1)
AUTHORS
- James Clark, Ian Castle <ian.castle@openjade.org>.