cmd line opts (mt)-- Visualization of ../../src/eu/bandm/tools/option/absy/option.dtd

<!-- file description --><!-- This is an html rendering of the DTD file 
         option.dtd
     This Xhtml file is DYNAMIC, using Java-script.
     The semantically relevant contents of the initial state 
     of this file DOES DIFFER from the input. 
       (pis omitted, comments omitted)
     This file has been created by the command line
          <JAVA> eu.bandm.tools.dtm.Tool --source  \
             ../../src/eu/bandm/tools/option/absy/option.dtd --outputFormat  \
             xhtml --result file_option_dtd.html --windowtitle  \
             " cmd line opts (mt)" --elements onOff --attlists onOff  \
             --comments offOn --PIs offOn --inserts offOn  \
             --showFullInstructions 1 --showCommandLine 1 --analyses offOn  \
             --alphabeticDir offOn --commonAttThreshold 20 --PEs onOff --GEs  \
             onOff --collapseWS 1 --entityGraph offOn --elementGraph onOff  \
             --showCreationDate "for public use"
     This file has been created at 2019-01-30_09h47m59 for public use.
     For info about this program see http://bandm.eu/metatools .
-->
<!-- collapse/expand --><!-- Click the opening symbols (angle brackets etc.) for collapsing/expanding.
     Click references for the definitions.
     Click element/attlist name position for the counterpart/next attlist. 
     Wait on a reference or on such a name for a tooltip.
     To control ALL declarations of one kind use these links:
     expand  all PIs  comments  elements  attlists  PEs  
     collaps all PIs  comments  elements  attlists  PEs  
-->
<!-- alphabetic indexes --><!-- =========================================================



Element declarations (FIXME undef references)
action  and  bool  char  comment  condition  constant  defaults
desc  enum  enumeration  enumitem  enumset  float  int
not  optarg  option  optionlist  or  printout_title  rep
simpletypes  string  testequal  testgreater  text  type
uri  v  

Parameter entity declarations (FIXME undef references)
%conditions  %int  %primecondition  %simpletypes  %sorting  %testvalues


General entity declarations (FIXME undef references)

 ========================================================= --->


<!-- analyses --><!-- =========================================================

Parameter entities appearing DIRECTLY in content models:
%simpletypes  %testvalues  %conditions  

Parameter entities appearing INdirectly in content models:
%primecondition  

Parameter entities referred to, NOT in a content model,  :
%sorting  

Entities defined, but nowhere referred to:
%int  

Common attributes, identical name and type (ignoring value)
   in increasing frequency (minimally 20) :


Possible candidate elements for being declared abstract:
condition  not  simpletypes  

Content model entity candidates for abstract declaration:
%primecondition  %simpletypes  %testvalues  
 ========================================================= --->


<!-- entity usage graph --><!-- =========================================================

 ========================================================= --->
<!-- element containment graph --><!-- =========================================================

 ========================================================= --->
<!--  --><!-- XML 1.1 DTD  SYSTEM = "../option/absy/option.dtd" -->

<!--  --><!-- FIXME <? tdom PUBLIC ... -->

<!-- ?tdom --><?tdom doc - Source format for the Option compiler, for command line parsing, GUI input, 
 generation of documentation, etc.
 <br/> See also the 
<a href="http://bandm.eu/metatools/docs/usage/option.html">option compiler user documentation</a>.
 <br/>
?>

<!--  --><!-- <a href="{@docRoot}/../usage/option.html">mt option compiler user documentation</a>. -->


<!-- ?tdom --><?tdom default private?>
<!-- ?tdom --><?tdom xmlns="http://bandm.eu/doctypes/option" ?>

<!-- %int --><!ENTITY % int 'NMTOKEN'>

<!-- %sorting --><!ENTITY % sorting '( 0AaB | 0ABa | AaB0 | ABa0 | AaB | ABa )'>
<!--  --><!-- 
    sort styles containing "0" = sort by short names,
       followed by those without short names
    position of "0"-character indicates position of numeric keys.
    sort styles not containing "0" = sort by long keys,
       followed by those without long names, finally numbers-only
    AaB means not respecting case
    ABa means respecting case
-->

<!-- ?tdom --><?tdom public optionlist?>
<!-- ?tdom --><?tdom doc optionlist Sequence of a collection of command line options, to
be compiled into GUI mask, online help method, parsing method, etc. 
(In several contexts, the sequential order is significant.) ?>
<!-- ?tdom --><?tdom doc optionlist@fragmentedLists Whether reperated option arguments may be continued
following some other option(s). ?>
<!-- ?tdom --><?tdom doc optionlist@setterFunctions Whether setter methods will be synthesized
for editing the value of an option instance ?>
<!-- EL optionlist --><!ELEMENT optionlist  (printout_title?, (enumeration | option | comment)+) >
<!-- @optionlist --><!ATTLIST optionlist  defaultSorting %sorting; "AaB0"
                      fragmentedLists (yes|no) 'yes' 
                      setterFunctions (yes|no) 'no' 
>


<!-- EL printout_title --><!ELEMENT printout_title (text)+>
<!-- ?tdom --><?tdom doc printout_title The text to be printed as a header line in the "usage()" function.
Can be specified for several languages. ?>

<!--  --><!-- testweise mixed content: 
<!ELEMENT br EMPTY>
<!ELEMENT emph (#PCDATA)>
<!ELEMENT text (#PCDATA | br | emph)* >
-->

<!--  --><!-- ORIG GILT: -->
<!-- EL text --><!ELEMENT text (#PCDATA)>

<!-- @text --><!ATTLIST text  lang  NMTOKEN #REQUIRED>
<!-- ?tdom --><?tdom doc text One translation into one particular language. 
(Its role and meaning depend on the enclosing context element.) ?>

<!-- EL desc --><!ELEMENT desc (text)+>
<!-- ?tdom --><?tdom doc desc One description, in several languages. 
(Its role and meaning depend on the enclosing context element.) ?>



<!--  --><!-- =========================================================================== -->

<!-- EL enumeration --><!ELEMENT enumeration (desc?, (enumitem)+) >
<!-- @enumeration --><!ATTLIST enumeration name NMTOKEN #REQUIRED>
<!-- ?tdom --><?tdom doc enumeration An enumeration type which can be used for several parameters of
 several options ?>
<!-- ?tdom --><?tdom doc enumeration@name  Used to refer to this enumeration when defining the type
 of option parameters ?>


<!-- EL enumitem --><!ELEMENT enumitem (desc)? >
<!-- @enumitem --><!ATTLIST enumitem value      CDATA #REQUIRED
                   compilable NMTOKEN #IMPLIED
>
<!-- ?tdom --><?tdom doc enumitem One position in an enumeration type (represented by the enclosing
 context element). ?>
<!-- ?tdom --><?tdom doc enumitem@value  Text as which this item appears to the user, on the command line, in
 a GUI, etc. 
 It maybe not a valid Java identifier. In this case {@code @compilable} must be given. ?>
<!-- ?tdom --><?tdom doc enumitem@compilable  Text as which this item is realized in the generated code.
 It must be a valid Java identifier, and must be present if {@code @value} is not. ?>


<!--  --><!-- =========================================================================== -->

<!-- EL comment --><!ELEMENT comment (text)+>
<!-- @comment --><!ATTLIST comment name  NMTOKEN #IMPLIED>
<!-- ?tdom --><?tdom doc comment Multi-Lingual text which separates groups of options and appears in 
 a GUI screen mask, etc.  Mostly used for further explanations and directives to the user. ?>
<!-- ?tdom --><?tdom doc comment@name  mangled into a variable name which gives access to the
 corresponding graphic sub-object  in the generated GUI class. ?>

<!--  --><!-- =========================================================================== -->

<!--  --><!-- TESTWEISE subsequence
<!ELEMENT option ((desc, type), condition?) >
 -->
<!--  --><!-- orig gilt :  -->
<!-- EL option --><!ELEMENT option (desc, type, condition?) >  

<!-- @option --><!ATTLIST option name     NMTOKEN #IMPLIED
                 abbrev   NMTOKEN #IMPLIED 
                 required (yes|no) "no"   >
<!-- ?tdom --><?tdom doc option Definition of one particular option as it appears on a command line,
 in the GUI, etc. At least one of {@code @name} or {@code @abbrev} must be given! ?>
<!-- ?tdom --><?tdom doc option@name  the long name, entered in the commandline with two minus signs,
 like "{@code --help}". Must have more than one character. ?>
<!-- ?tdom --><?tdom doc option@abbrev   the short name, entered in the commandline with one minus sign,
 like "{@code -h}". Must have exactly one character. ?>
<!-- ?tdom --><?tdom doc option@required Says whether this option must be present on the command line. 
 Is used to synthesize  checking code. ?>

<!-- %simpletypes --><!ENTITY %  simpletypes '(int | float | bool | char | string | uri 
                              | enum | enumset | action)'>
<!-- EL simpletypes --><!ELEMENT simpletypes (%simpletypes;)>

<!-- EL type --><!ELEMENT type ( (%simpletypes;)*, rep?   )>
<!-- ?tdom --><?tdom doc type Sequence of the types of all arguments of a particular option . ?>


<!-- EL int --><!ELEMENT int EMPTY>
<!-- @int --><!ATTLIST int default    NMTOKEN #IMPLIED>
<!-- ?tdom --><?tdom doc int Describes one integer argument in an option's list of argument types. 
 Please note that negative ints cannot be entered at the beginnig of a repetition group
 due to parsing ambiguity. ?>
<!-- ?tdom --><?tdom doc int@default Default value in case the option is missing completely. ?>

<!-- EL float --><!ELEMENT float EMPTY>
<!-- @float --><!ATTLIST float default    NMTOKEN #IMPLIED>
<!-- ?tdom --><?tdom doc float Describes one floating point argument in an option's list of argument types.
(Floats can be translated to Java "float" or "double", controlled by an operation parameter. ?>
<!-- ?tdom --><?tdom doc float@default Default value in case the option is missing completely. ?>

<!-- EL bool --><!ELEMENT bool EMPTY>
<!-- @bool --><!ATTLIST bool default    NMTOKEN #IMPLIED>
<!-- ?tdom --><?tdom doc bool Describes one boolean argument in an option's list of argument types. ?>
<!-- ?tdom --><?tdom doc bool@default Default value in case the option is missing completely. ?>

<!-- EL char --><!ELEMENT char EMPTY>
<!-- @char --><!ATTLIST char default    CDATA #IMPLIED>
<!-- ?tdom --><?tdom doc char Describes one character value argument in an option's list of argument types. ?>
<!-- ?tdom --><?tdom doc char@default Default value in case the option is missing completely. ?>

<!-- EL string --><!ELEMENT string EMPTY>
<!-- @string --><!ATTLIST string default    CDATA #IMPLIED>
<!-- ?tdom --><?tdom doc string Describes one string value argument in an option's list of argument types. ?>
<!-- ?tdom --><?tdom doc string@default Default value in case the option is missing completely. ?>


<!-- EL uri --><!ELEMENT uri EMPTY>
<!-- @uri --><!ATTLIST uri default    CDATA    #IMPLIED>
<!-- ?tdom --><?tdom doc uri Describes one uri value argument in an option's list of argument types. ?>
<!-- ?tdom --><?tdom doc uri@default Default value in case the option is missing completely. ?>


<!-- EL rep --><!ELEMENT rep ( (%simpletypes;)+, defaults?) >
<!-- @rep --><!ATTLIST rep kind     (plus|star) #REQUIRED>
<!-- ?tdom --><?tdom doc rep Describes a sequence of value types in an option's list of argument types which 
 can appear more than once. ?>
<!-- ?tdom --><?tdom doc rep@kind Whether the empty sequence is a valid input ("star", not "plus") ?>


<!-- EL defaults --><!ELEMENT defaults (v)+>
<!-- EL v --><!ELEMENT v (#PCDATA)>
<!-- ?tdom --><?tdom doc defaults gives the sequence of default values for a repetition group, is the
 option is completely omitted. The number of contained elements must be an integral
 multiple of the length of the containing repetion group. ?>
<!-- ?tdom --><?tdom doc v One single default value, parsed as if it stood on a command line input. ?>

<!-- EL enum --><!ELEMENT enum  EMPTY>
<!-- @enum --><!ATTLIST enum name NMTOKEN    #REQUIRED
               default NMTOKEN  #IMPLIED>
<!-- ?tdom --><?tdom doc enum  Refers to an Enumeration as the type of the value of an option's argument. ?>
<!-- ?tdom --><?tdom doc enum@name The name of the enum, for referring. ?>
<!-- ?tdom --><?tdom doc enum@default The enumeration item which shall be used as 
 default value, if the option is missing completely. The text must be the Java identifier,
 i.e. the  compilable version, not the command line version. ?>

<!-- EL enumset --><!ELEMENT enumset  EMPTY>
<!-- @enumset --><!ATTLIST enumset name    NMTOKEN    #REQUIRED
                  default NMTOKENS   #IMPLIED>
<!-- ?tdom --><?tdom doc enumset  Refers to an Enumeration as the base type for a set type for 
 the value of an option's argument. ?>
<!-- ?tdom --><?tdom doc enumset@name The name of the enum, for referring. ?>
<!-- ?tdom --><?tdom doc enumset@default The enumeration items which make the set value be used as 
 default value, if the option is missing completely. The text must be a sequence of 
 Java identifiers, i.e. the  compilable versions, not the command line versions. ?>


<!-- EL action --><!ELEMENT action EMPTY>
<!-- @action --><!ATTLIST action name NMTOKEN #REQUIRED>
<!-- ?tdom --><?tdom doc action NOT YET SUPPORTED. ?>
<!-- ?tdom --><?tdom doc action@name identifies the triggered action, NOT YET SUPPORTED. ?>

<!--  --><!-- =========================================================================== -->

<!-- %primecondition --><!ENTITY % primecondition '(testequal| testgreater)'>
<!-- %conditions --><!ENTITY % conditions '((%primecondition;) | and | or | not)'>

<!-- EL condition --><!ELEMENT condition (%conditions;) >
<!-- EL and --><!ELEMENT and       (%conditions;)+ >
<!-- EL or --><!ELEMENT or        (%conditions;)+ >
<!-- EL not --><!ELEMENT not       (%conditions;) >
<!-- ?tdom --><?tdom doc condition Enabling condition which "un-greys" the input fields of an option,
 if fulfilled. ?>
<!-- ?tdom --><?tdom doc and Conjuntive combination of two conditions for enabling an option. ?>
<!-- ?tdom --><?tdom doc or Disjuntive combination of two conditions for enabling an option. ?>
<!-- ?tdom --><?tdom doc not Negation of a condition for enabling an option. ?>

<!-- %testvalues --><!ENTITY % testvalues '(constant | optarg)'>

<!-- EL testequal --><!ELEMENT testequal (%testvalues;,%testvalues;)>
<!-- ?tdom --><?tdom doc testequal Enabling condition whether both arguments have the same numric value. ?>

<!-- EL testgreater --><!ELEMENT testgreater (%testvalues;,%testvalues;)>
<!-- ?tdom --><?tdom doc testequal Enabling condition whether first argument is strictly larger 
 than the second. ?>

<!-- EL constant --><!ELEMENT constant EMPTY>
<!-- @constant --><!ATTLIST constant value NMTOKEN #REQUIRED>
<!-- ?tdom --><?tdom doc constant Constant number to test against some current option argument value,
for forming an enabling condition. ?>

<!-- EL optarg --><!ELEMENT optarg EMPTY>
<!-- @optarg --><!ATTLIST optarg option NMTOKEN #REQUIRED
                 number NMTOKEN #IMPLIED
                >
<!-- ?tdom --><?tdom doc optarg Reference to some option's current argument value, to test it in an
enabling  condition. ?>
<!-- ?tdom --><?tdom doc optarg@option The option from which the current argument value is taken. 
It is identified either by its long name or its short abbrev value. ?>
<!-- ?tdom --><?tdom doc optarg@number The argument of the option by its (zero-based) position index.
The value of this argument is taken for comparison. 
 (The argument values of a repetition group are currently not adressable; neither is its length.) ?>

<!--  --><!-- eof -->