NAME

       stag-autoschema - writes the implicit stag-schema for a stag file

SYNOPSIS

         stag-autoschema -w sxpr sample-data.xml

         stag-autoschema -dtd sample-data.xml

DESCRIPTION

       Takes a stag compatible file (xml, sxpr, itext), or a file in any format plus a parser,
       and writes out the implicit underlying stag-schema

       stag-schema should look relatively self-explanatory.

       Here is an example stag-schema, shown in sxpr syntax:

         (db
          (person*
           (name "s"
           (address+
            (address_type "s")
            (street "s")
            (street2? "s")
            (city "s")
            (zip? "s")))))

       The database db contains zero or more persons, each person has a mandatory name and at
       least one address.

       The cardinality mnemonics are as follows:

       +   1 or more

       ?   0 or one

       *   0 or more

       The default cardinality is 1

ARGUMENTS

       -p|parser FORMAT
           FORMAT is one of xml, sxpr or itext, or the name of a perl module

           xml assumed as default

       -dtd
           exports schema as DTD

       -w|writer FORMAT
           FORMAT is one of xml, sxpr or itext, or the name of a perl module, OR DTD

           The default is sxpr

           note that stag schemas exported as xml will be invalid xml, due to the use of symbols
           *, +, ? in the node names

LIMITATIONS

       not event based - memory usage becomes exhorbitant on large files; prepare a small sample
       beforehand