@database c_dtc.doc
@master doc/c_dtc.doc
@node main "c_dtc.doc"
@toc xref.library_xreffile@main
@{settabs 40}@{" c.datatype " link "c.datatype"}	

@endnode
@node "c.datatype" "c.datatype/c.datatype"

    @{b}NAME@{ub}
        c.datatype - data type for any c source

    @{b}FUNCTION@{ub}
        This datatype is designed to display C and C++ source codes. It
        display's different parts of the C source in different style and
        color.At the moment these parts are :
           STANDARD - any text which, doesn't match the following parts
           COMMENT  - any comment such like /* ... */ and // ...
           CPP      - any C-PreProcessor keyword like "#define" @{b}or@{ub} "#include"
           KEYWORD  - any C/C++ keyword, which isn't handled explicitly
           STORAGE  - extern,static,register,auto keywords
           TYPES    - basic type keywords like int,char,long etc.
           TYPENAME - any name following a struct,union,class or enum
           STRING   - any string or char literal
           NUMBER   - any number constant decimal,hex

        It uses a parser generated by bison with my yacc grammer.Because it's
        a parser, it may occur a parse error on some unusual source code. If
        this happens please send me a description of this parse error and
        maybe the input file. So I can fix this problem !

    @{b}PREFS@{ub}
        Env:DataTypes/c.prefs with the following two @{"ReadArgs()" link "dos/ReadArgs()"} templates :

        - CPART/A/K,PEN/N/K,R=RED/N/K,G=GREEN/N/K,B=BLUE/N/K,ITALIC/S,BOLD/S,
          UNDERLINED/S,@{"TEXT" link "AG:SysInc/exec/types.h/main" 70}/S

          CPART is one of the explaned cpart names like COMMENT or CPP.
          PEN assigns the color with the pen number to the specified part
          R,G,B defines a new color for the specified part. This color is
                allocated with @{"ObtainBestPenA" link "graphics/ObtainBestPenA()"}(...,@{"OBP_Precision" link "AG:SysInc/graphics/view.h/main" 245},
                                                  @{"PRECISION_ICON" link "AG:SysInc/graphics/view.h/main" 240});
          ITALIC,BOLD,UNDERLINED specifies the font style for the part
          @{"TEXT" link "AG:SysInc/exec/types.h/main" 70} treat this CPART as normal text

        - GLOBAL/A/S,TABLENGTH/N/K

          @{"GLOBAL" link "AG:SysInc/exec/types.h/main" 18} indicates, that this line is a global setting. Note: The
              /A/S combination isn't supported from @{"ReadArgs()" link "dos/ReadArgs()"}, so I check
              it manually !
          TABLENGTH - number of spaces to use for a tab !

    @{b}AUTHOR@{ub}
        Stefan Ruppert
        Windthorststrasse 5
        65439 Floersheim am Main
        Germany
        EMail: ruppert@vs3.informatik.fh-wiesbaden.de

    @{b}SEE ALSO@{ub}
        text.datatype


@endnode
