sgml2xml-isoent(1) [debian man page]

sgml2xml-isoent(1)						     docbook2X							sgml2xml-isoent(1)

NAME

       sgml2xml-isoent - Convert SGML to XML with support for ISO entities

SYNOPSIS

       sgml2xml-isoent [sgml-document]

DESCRIPTION

       sgml2xml-isoent converts an SGML document to XML, with support for the ISO entities.  This is done by using sgml2xml(1) from the SP package
       (or osx(1) from the OpenSP package), and the declaration for the XML version of the ISO entities is added to the output.  This  means  that
       the output of this conversion should work as-is with any XML tool.

       This  program  is often used for processing SGML DocBook documents with XML-based tools. In particular, db2x_xsltproc(1) calls this program
       as part of its --sgml option. On the other hand, it is probably not helpful for migrating a source SGML text file to XML, since the conver-
       sion mangles the original formatting.

       Since the XML version of the ISO entities are referred to directly, not via a DTD, this tool also works with document types other than Doc-
       Book.

NOTES

       The ISO entities are referred using the public identifiers ISO 8879:1986//ENTITIES//...//EN//XML.  The catalogs used when parsing the  con-
       verted  document  should resolve these entities to the appropriate place (on the local filesystem). If the entities are not resolved in the
       catalog, then the fallback is to get the entity files from the http://www.docbook.org/ Web site.

AUTHOR

       Steve Cheng <stevecheng@users.sourceforge.net>.

SEE ALSO

       sgml2xml(1), osx(1)

docbook2X 0.8.8 						   3 March 2007 						sgml2xml-isoent(1)

OSX(1)									osx								    OSX(1)

NAME

       osx - An SGML System Conforming to International Standard ISO 8879 -- Standard Generalized Markup Language

SYNOPSIS

       osx [-Cehilprvx] [-bencoding] [-ccatalog_file] [-Ddirectory] [-ffile] [-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 stan-
       dard output. osx will warn about SGML constructs which have no XML equivalent.

OPTIONS

       The following options are available:

		 -bencoding

	      Use encoding for output. By default osx uses UTF-8.

		 -cfile

	      Use the catalog entry file file.

	  -C

	      This has the same effect as in onsgmls(1).

	  -Ddirectory

	      Search directory for files specified in system identifiers. This has the same effect as in onsgmls(1).

	  -e

	      Describe open entities in error messages.

	  -ffile

	      Redirect errors to file. This is useful mainly with shells that do not support redirection of stderr.

	  -iname

	      This has the same effect as in onsgmls(1).

	  -v

	      Print the version number.

	  -wtype

	      Control warnings and errors according to type. This has the same effect as in onsgmls(1).

	  -xxml_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 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 instruc-
	      tions to contain the string >?, but requires that applications handle the escapes.

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

	      attlis Output an ATTLIST declaration for every element specifying the type of all attributes. The default will always be #IMPLIED.

	      Multiple -x options are allowed.

SEE ALSO

       onsgmls(1)

AUTHORS

       James Clark, Jane Peers <jane.peers@looksystems.co.uk>.

OpenJade							   January 2002 							    OSX(1)