sgmldiff(1) [centos man page]
SGMLDIFF(1) SGMLDIFF(1) NAME
sgmldiff - Find differences in the markup of two SGML files SYNOPSIS
sgmldiff [ options ... ] file1 file2 [ -a | --attributes | -c [ attributes | nesting | textpos ] | --context [ attributes | nesting | textpos ] | -s | --statistics | -h | --help | -v | --version ] DESCRIPTION
This perl script allows to determine the structural differences between two SGML files. It compares the files, regardless of what is in between the tags, to only focus on the markup. Its output is similar to diff(1). The typical use of sgmldiff is to compare an SGML file with its translation into another language. If the translation was done cleanly, sgmldiff returns without finding any difference in the markup. An example of a typical call to sgmldiff is: sgmldiff english.sgml italiano.sgml If there are differences in markup between both files, sgmldiff will output a series of differences reports summarized with lines of the form: 169a164 At line 169 of the first file, line 164 of the second file has been added. 8a12,15 At line 8 of the first file, lines 12 to 15 of the second file have been added. 41d28 Line 41 of the first file has been destroyed, to obtain line 28 of the second file. 63,66d61 Lines 63 to 66 of the first file have been destroyed. to obtain line 61 of the second file. 52c51 Line 52 of the first file has been changed into line 51 of the second file. 5,7c8,10 Lines 5 to 7 of the first file have been changed into lines 8 to 10 of the second line. In addition to those summaries, the lines of the first file are shown preceeded by '<' and the lines of the second file are shown preceeded by '>". OPTIONS
Here is the list of actions that can be requested to sgmldiff: [ -a | --attributes ] Include the attribute values in the difference tests. Don't set this value if the attributes are likely to be translated. Set this value if the attributes value shouldn't change between both files. Default is to don't include the attributes in the difference tests. [ -c [ attributes | nesting | textpos ] | --context [ attributes | nesting | textpos ] ] Add more context to the difference. Since every test between the tags is removed before testing the differences, sgmldiff is likely to resynchronize itself at the wrong place, by thinking the location in both files correspond, while it's not true. By adding more context to the compared area, such risk is disminished. The allowed values for the --context option are: attributes Take into account the attribute names. The attribute values are controlled by the attributes option. nesting Take into account the nesting level of all the compared tags. textpos Take into account the position in the text. [ -s | --statistics ] Print some SGML information at the end. [ -h | --help ] Print a short help message and exit [ -v | --version ] Print the version identifier and exit FILES
AUTHORS
Frederik Fouvry Developer of sgmldiff. SEE ALSO
jw(1) conversion from a SGML file to other file formats nsgmls(1) a base component of Jade DSSSL engine http://sources.redhat.com/docbook-tools/ <URL:http://sources.redhat.com/docbook-tools/> the home page of the DocBook tools, a compendium of all tools necessary to process DocBook files, including the DocBook-utils 11 February 2004 SGMLDIFF(1)
Check Out this Related Man Page
JW(1) JW(1) NAME
jw, docbook2dvi, docbook2html, docbook2man, docbook2pdf, docbook2ps, docbook2rtf, docbook2tex, docbook2texi, docbook2txt - (Jade Wrapper) converts SGML files to other formats SYNOPSIS
jw [ -f frontend | --frontend frontend ] [ -b backend | --backend backend ] [ -c file | --cat file ] [ -n | --nostd ] [ -d file|default|none | --dsl file|default|none ] [ -l file | --dcl file ] [ -s path | --sgmlbase path ] [ -p program | --parser program ] [ -o directory | --output directory ] [ -V variable[=value] ] [ -u | --nochunks ] [ -i section | --include section ] [ -w type|list | --warning type|list ] [ -e type|list | --error type|list ] [ -h | --help ] [ -v | --version ] SGML-file docbook2dvi SGML-file docbook2html SGML-file docbook2man SGML-file docbook2pdf SGML-file docbook2ps SGML-file docbook2rtf SGML-file docbook2tex SGML-file docbook2texi SGML-file docbook2txt SGML-file DESCRIPTION
The jw shell script allows to convert a DocBook file (or some other SGML-based format) to other formats (including HTML, RTF, PS and PDF) with an easy-to-understand syntax. It hides most of Jade's or OpenJade complexity and adds comfortable features. Other scripts like docbook2html, docbook2rtf or docbook2ps provide different ways of calling jw that might be easier to remember. For the moment, jw does not handle XML, but only SGML. This utility assumes that several other components are installed. The list includes: o the ISO character entities for SGML o James Clark's DSSSL engine, jade, or an equivalent parser like OpenJade o the DocBook DTD from the OASIS consortium o Norman Walsh's DocBook modular style sheets (or some other set of DSSSL style sheets) o Sebastian Rahtz's jadetex set of TeX macros for jade (for backends intended to "printing" formats like PDF, RTF or PostScript) o A perl interpreter (for backends that use perl) o SGMLSpm from CPAN (for backends that use sgmls) o Lynx HTML browser (for the txt backend) The jw script is basically called like this: jw mydoc.sgml where mydoc.sgml is a SGML file. The command line above uses default options: it converts from DocBook (the default frontend) to HTML (the default backend), does not put the result in a subdirectory (unless specified otherwise in the style sheets), etc. In this example, the "mydoc" file name as well as the ".sgml" extension can be replaced by anything else. Current extensions for SGML Doc- Book files include ".sgml", ".sgm", ".docbook", and ".db". The processed file mydoc.sgml can be in any other directory than the current one. Here we have chosen to generate HTML output. In fact we can use any of the backends stored in the backends/ subdirectory of the DocBook- utils distribution directory (usually /usr/share/sgml/docbook/utils-0.6.12). Similarly, you can use any frontend defined in the frontends/ subdirectory to convert from another input format. This sample command creates one or many HTML files with arbitrary file names in the current directory. This default behavior can be changed through command line options and/or customization style sheets. OPTIONS
The following options apply to the conversion script: -f frontend | --frontend frontend Allows to specify another frontend than default docbook. The list of currently available frontends is: docbook Converts docbook with Norman Walsh's style sheets. This frontend searches in the subdirectories of the base SGML directory for a file named html/docbook.dsl or print/docbook.dsl (depending on the backend's type: html or print). -b backend | --backend backend Allows to specify another backend than default HTML. The list of currently available backends is: dvi Converts to DVI (DeVice Independant files) by calling Jade or OpenJade. html Converts to HTML (HyperText Markup Language) by calling Jade or OpenJade. man Converts a refentry to a Unix manual page by calling docbook2man. Does not work with other SGML document types than DocBook. pdf Converts to PDF (Portable Document Format) by calling Jade or OpenJade. ps Converts to PostScript by calling Jade or OpenJade. rtf Converts to RTF (Rich Text Format) by calling Jade or OpenJade. The resulting file can then be inported into MS Word or one of its Linux replacement programs. tex Converts to TeX by calling Jade or OpenJade. texi Converts to GNU TeXinfo pages by calling docbook2texi. Does not work with other SGML document types than DocBook. txt Converts to a bare text file by calling Jade or OpenJade, then Lynx. -c file | --cat file Allows to use an extra SGML Open Catalog that will list other files like customization style sheets, adaptations to the DocBook Doc- ument Type Definition, special character entities, etc. This catalog is added to the list of catalogs determined by the script (see option --nostd below) -n | --nostd Do not use the standard SGML Open Catalogs. Normally, the standard catalogs list is determined like this: o if the centralized catalog exists, then use it. The centralized catalog is a list of all catalogs that might be necessary that usually resides in /etc/sgml. Its name is provided by the frontend, for example the docbook frontend returns /etc/sgml/sgml-doc- book.cat. o Otherwise, take all the files named catalog from the subdirectories of the SGML base directory (usually /usr/share/sgml). This option is useful in conjunction with the --cat option to use only the catalogs that are specified on the command line. -d file|default|none | --dsl file|default|none Allows to use a customized style sheet instead of the default one. A "target" starting with a hash mark "#" can be appended to the file name. As a result, only the corresponding part of the style sheet is executed (the "style specification" whose "identificator" is equal to the target's name). A common use of this mechanism is to define "#html" and "#print" targets to trigger the corresponding part of a replacement style sheet which is common for both HTML and printout conversion. By replacing the file name with "default", the default style sheet provided with the frontend is used. For example, the docbook frontend returns ./docbook.dsl#html (or ./docbook.dsl#print) in the SGML base directory. By replacing the file name with "none", no replacement style sheet is used, not even the default style sheet. The style sheet which is used is also determined by the frontend. For example, the docbook frontend returns Norman Walsh's html/docbook.dsl (or print/doc- book.dsl) found somewhere below the SGML base directory. If no --dsl option is specified, then "--dsl default" is used. -l file | --dcl file Allows to use a customized SGML declaration instead of the default one. The file name of the default SGML declaration is not set for SGML files, and is set to xml.dcl in the SGML base directory for XML files. -s path | --sgmlbase path Allows to use another location for the SGML base directory. This is the directory below which all SGML DTDs, style sheets, entities, etc are installed. The default value is /usr/share/sgml. -p program | --parser program Specify the parser to use (Jade or OpenJade) if several are installed. If this option is not specified, the script first tries to use Jade, then it tries OpenJade. -o directory | --output directory Set output directory where all the resulting files will be stored. If the style sheets define a subdirectory where to store the resulting files too, the subdirectory defined by the style sheets will be placed below the subdirectory defined by this option. -V variable=[value] Set a variable (to a value, if one is specified). -u | --nochunks Output only one big file. This option is useful only when generating HTML, because the output can be split into several files. This option overrides the setting that may be done in the style sheets. -i section | --include section Declare a SGML marked section as "include". A SGML marked section is a kind of conditional part of a document. If it is declared "ignore", it will be left ignored, otherwise it will be processed. An example of such a marked section would be: <DOCTYPE mydoc [ <!ENTITY % confidential "ignore"> ]> <mydoc> ... <![ %confidential [ Some confidential text... ]]> ... </mydoc> -w type|list | --warning type|list Enables or disables the display of given types of warnings. Several -w options might be entered on the command line. Warning types that start with "no-" disable the corresponding warnings, the other types enable them. If the warning type is replaced with "list", then a list of allowed warning types is displayed. -e type|list | --error type|list Disables given types of errors. Several -e options might be entered on the command line. All error types start with "no-". If the error type is replaced with "list", then a list of allowed error types is displayed. -h | --help Print a short help message and exit -v | --version Print the version identifier and exit FILES
/etc/sgml/sgml-docbook.cat Centralized SGML open catalog. This file name might vary if another frontend than docbook is used. /usr/share/sgml/docbook/utils-0.6.12/backends The various backends /usr/share/sgml/docbook/utils-0.6.12/frontends The various frontends /usr/share/sgml/docbook/utils-0.6.12/helpers The various helper scripts like docbook2man or docbook2texi AUTHORS
Eric Bischoff (jw shell script and a few backends), Jochem Huhmann (the man and texi backends) SEE ALSO
docbook2man-spec.pl(1), docbook2texi-spec.pl(1), install-catalog(8), nsgmls(1), docbook-utils homepage <URL:http://sources.redhat.com/doc- book-tools/>. 05 February 2003 JW(1)