This package contains an emacs major mode for editing SGML and XML
DTDs.  The current revision is 0.5, dated May 25, 1998.

* MANIFEST

File				Contents

readme.txt			The file you are reading
dot_emacs			Some things for your .emacs file
tdtd.el				A collection of DTD-related macros
tdtd-font.el			Font lock keywords for DTDs
changelog.txt			List of changes

* FEATURES

 - dtd-etags function for creating Emacs TAGS files for easy lookup of
   any element, parameter entity, or notation's definition using
   Emacs's built-in tag-lookup functions;

 - Font lock highlighting of declarations so that the important
   information stands out;

 - XML-specific behaviour that, at user option, is triggered by
   automatic detection of the XML Declaration; and

 - Functions for writing and editing declarations and comments to ease
   both creating and keeping a consistent style.

dtd-mode builds on sgml-mode, and the full sgml-mode functions are
still available.

dtd-mode uses many user-definable variables to control the formatting
of declarations, some of which are shown in the following examples:

 		        dtd-comment-start-column    dtd-dtd-max-column
                        |       	     dtd-comment-max-column  |
                        |       				  |  |
<!--                    This is a comment                          -->

           dtd-element-name-column
           |    	dtd-element-tag-ommission-column
           |            |   dtd-element-content-spec-start-column
           |            |   |dtd-element-content-spec-continuation-column
           |            |   ||  		    dtd-dtd-max-column
           |            |   ||  				     |
<!ELEMENT  element-tag  - - (insert, your, content, specification,
                             here)                                   >

* BUG REPORTS/ENCHANCEMENTS

I would be glad to accept bug reports and/or enhancements.

* INSTALLATION

1. Unzip the distribution.

   This should extract the files listed in the manifest above.

2. Copy the .el files to your emacs site-lisp directory (e.g.,
   /usr/local/lib/emacs/site-lisp).

3. Byte compile tdtd.el and tdtd-font.el using M-x byte-compile-file
   and supplying the path name of each file.

   If you byte-compiled a previous version of tdtd.el and
   tdtd-font.el, then you must byte-compile the new files (or remove
   the old .elc files) so that autoload loads the correct versions.

4. Add the elisp code in dot_emacs to your .emacs file.

5. When you visit a file with an extension of .dtd, etc., dtd-mode
   will automatically be loaded.

-----
$Id: readme.txt,v 1.7 1998/05/24 19:00:58 tkg Exp $