OSX(1)				     osx			       OSX(1)



NAME
       osx  - An SGML System Conforming to International Standard ISO 8879 --
       Standard Generalized Markup Language. An SGML Extended Facilities sys-
       tem  conforming	to Annex A of International 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 equivalent 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 system 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 onsgmls(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_out-
	      put_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  entities.  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 declarations 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 appli-
	      cations handle the escapes.

	      empty Use the  syntax	 for  element  types  e	 declared  as
	      EMPTY.

	      attlist  Output an ATTLIST declaration for every element speci-
	      fying the type of all attributes. The default  will  always  be
	      #IMPLIED.

	      report-input-sources  Output a processing instruction 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 declara-
	      tion driver file named "extEntities.dtf", and include that file
	      in the instance's internal subset.

	      no-expand-internal Preserve internal entities, write a declara-
	      tion driver file named "intEntities.dtf", and include that file
	      in the instance's internal subset.

	      no-external-decl Do not include the external entities  declara-
	      tion driver file in the instance's internal subset.

	      no-internal-decl	Do not include the internal entities declara-
	      tion 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 inter-
	      nal subset), express them as processing instructions instead of
	      as general internal entities.

	      Multiple -x options are allowed.


SEE ALSO
       onsgmls(1), ospam(1), onsgmlnorm(1), ospent(1)


AUTHORS
       James Clark, Ian Castle .



OpenJade			November 2002			       OSX(1)

UNIX/Linux commands referenced on this page:

1. which
2. file
3. as
4. id
5. write