Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

osgml2xml (1)

Name

osgml2xml - 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(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  .nf   .fi  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 <e/> syntax for element types e declared as EMPTY.

              attlist Output an ATTLIST declaration for every element specify-
              ing  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.

              no-output-outside-outdir  When  preserving external entities, do
              not write output files outside the  specified  output  directory
              ("." by default). In other words, if an external entity's system
              identifier includes enough instances of ".."  to  cause  osx  to
              write  a  file  outside  (above)  the output directory, exit (by
              default osx will issue a warning but will  write  the  file  and
              continue.

              no-overwrite When preserving internal or external entities, mul-
              tiple output files will be written. If this option is specified,
              do  not  overwrite  existing files; instead, attempt to append a
              number to the end of the original filename to  create  a  unique
              filename.  Exit  with  an  error  if  too  many (100) such files
              already exist.

              preserve-case Preserve casing as specified in the DTD  for  ele-
              ment  names;  attribute  names; attribute values which are token
              lists.

              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
              general internal entities.

              Multiple -x options are allowed.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-------------------------------------+
       |ATTRIBUTE TYPE |          ATTRIBUTE VALUE            |
       +---------------+-------------------------------------+
       |Availability   | developer/documentation-tool/opensp |
       +---------------+-------------------------------------+
       |Stability      | Volatile                            |
       +---------------+-------------------------------------+

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


AUTHORS
       James Clark, Ian Castle <ian.castle@openjade.org>.



NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source  was  downloaded  from  http://prdownloads.sourceforge.net/open-
       jade/OpenSP-1.5.1.tar.gz.

       Further information about this software can be found on the open source
       community website at http://openjade.sourceforge.net/.



OpenJade                         November 2002                          OSX(1)