GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  DTDDIFF (1)

.ds Aq ’

NAME

dtddiff - Compare two SGML/XML DTDs

CONTENTS

SYNOPSIS



  dtddiff [options] <parsed-dtd1.xml> <parsed-dtd2.xml>



DESCRIPTION

<B>dtddiffB> compares two SGML/XML DTDs based upon the XML dumps generated by <B>dtdparseB>. The following summarizes the typically usage of dtddiff:



  dtdparse --outfile parsed-dtd1.xml dtd1.dtd
  dtdparse --outfile parsed-dtd2.xml dtd2.dtd
  dtddiff parsed-dtd1.xml parsed-dtd2.xml > dtd.diff



Since dtddiff processes the XML dumps from dtdparse, a full reparse of the DTDs is avoided.

dtddiff does a structural-based comparision. Therefore, the order of declarations in the DTDs does not affect the comparison.

The output generated by dtddiff is similiar in style to a context-based diff done by the program diff(1). The following is an example of the type of output generated:



  *** DocBook 4.1 DTD
  --- DocBook 4.2 DTD
  *************** Elements Added
  --- DocBook 4.2 DTD ----
  + bibliocoverage
  + biblioid
  + bibliorelation
  + bibliosource
  + blockinfo
  + citebiblioid
  + coref
  + errortext
  + personblurb
  + personname
  + refsection
  + refsectioninfo
  + textdata
  *************** Elements Changed
  ... [snip] ...

  *** DocBook 4.1 DTD ****

  ! entrytbl ::=
        (colspec*, spanspec*, thead?, tbody)
       -(entrytbl)

     entrytbl Attributes:
  !   charoff                NUTOKEN                    #IMPLIED
  !   colname                NMTOKEN                    #IMPLIED
  !   cols                   NUMBER                     #REQUIRED
  !   colsep                 NUMBER                     #IMPLIED
  !   nameend                NMTOKEN                    #IMPLIED
  !   namest                 NMTOKEN                    #IMPLIED
  !   rowsep                 NUMBER                     #IMPLIED
  !   spanname               NMTOKEN                    #IMPLIED
  !   tgroupstyle            NMTOKEN                    #IMPLIED

  --- DocBook 4.2 DTD ----

  ! entrytbl ::=
        (colspec*, spanspec*, thead?, tbody)

     entrytbl Attributes:
  !   charoff                CDATA                      #IMPLIED
  !   colname                CDATA                      #IMPLIED
  !   cols                   CDATA                      #REQUIRED
  !   colsep                 CDATA                      #IMPLIED
  !   nameend                CDATA                      #IMPLIED
  !   namest                 CDATA                      #IMPLIED
  !   rowsep                 CDATA                      #IMPLIED
  !   spanname               CDATA                      #IMPLIED
  !   tgroupstyle            CDATA                      #IMPLIED

  ... [snip] ...

  *** DocBook 4.1 DTD ****


     graphic Attributes:
  !   depth                  NUTOKEN                    #IMPLIED
  !   format                 [Enumeration]              #IMPLIED
  !                          BMP, CGM-CHAR, CGM-
  !                          BINARY, CGM-CLEAR,
  !                          DITROFF, DVI, EPS, EQN,
  !                          FAX, GIF, GIF87a, GIF89a,
  !                          JPG, JPEG, IGES, PCX,
  !                          PIC, PNG, PS, SGML, TBL,
  !                          TEX, TIFF, WMF, WPG,
  !                          linespecific
  !   scale                  NUMBER                     #IMPLIED
  !   scalefit               NUMBER                     #IMPLIED
  !   width                  NUTOKEN                    #IMPLIED

  --- DocBook 4.2 DTD ----


     graphic Attributes:
  +   contentdepth           CDATA                      #IMPLIED
  +   contentwidth           CDATA                      #IMPLIED
  +   valign                 [Enumeration]              #IMPLIED
  +                          top, middle, bottom
  !   depth                  CDATA                      #IMPLIED
  !   format                 [Enumeration]              #IMPLIED
  !                          BMP, CGM-CHAR, CGM-
  !                          BINARY, CGM-CLEAR,
  !                          DITROFF, DVI, EPS, EQN,
  !                          FAX, GIF, GIF87a, GIF89a,
  !                          JPG, JPEG, IGES, PCX,
  !                          PIC, PNG, PS, SGML, TBL,
  !                          TEX, TIFF, WMF, WPG, SVG,
  !                          linespecific
  !   scale                  CDATA                      #IMPLIED
  !   scalefit               CDATA                      #IMPLIED
  !   width                  CDATA                      #IMPLIED

  ... [snip] ...



Lines starting with a - (minus followed by a space) denote items removed. Lines starting with a + (plus followed by a space) denote items added. Lines starting with a ! (explanation point followed by a space) denote items changed.

OPTIONS

--attributes
--noattributes Print, or not, element attribute differences. The default is to print differences.
--content-model-expanded
--nocontent-model-expanded Expand, or not expand, element content models during comparison. Expanded models have all parameter entities resolved. The default is to use expanded content model.
--elements
--noelements Print, or not, element content model differences. The default is to print differences.
--general-ents
--nogeneral-ents Print, or not, general entity differences. The default is to <B>notB> print differences.
--parameter-ents
--noparameter-ents Print, or not, parameter entity differences. The default is to <B>notB> print differences.
--dump Do a textual dump of a DTD. When this option is specified, only a single DTD is dumped. This is mainly used for debugging purposes.
--version Print version and synopsis.
--help Print synopsis and options available.
--man Print manual page.

SEE ALSO

dtdparse, dtddiff2html

See SGML::DTDParse for an overview of the DTDParse package.

PREREQUISITES

<B>File::BasenameB>, <B>Getopt::LongB>, <B>Xml::ParserB>

AVAILABILITY

<http://dtdparse.sourceforge.net/>

AUTHORS

Earl Hood, <earl@earlhood.com>

COPYRIGHT AND LICENSE

See SGML::DTDParse for copyright and license information.
Search for    or go to Top of page |  Section 1 |  Main Index


perl v5.20.3 DTDDIFF (1) 2005-07-16

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.