d4cab.pref

HTML style tags.

d4c&b puts those highlights around various keywords and sections. By modifing those you change the visual style of d4c&b HTML output.

This file shows the default values for all tags.

Each tag is a list of HTML tags, without the enclosing `<>', separated by `,'. For example 

TOCheaders CENTER,STRONG
generates `<CENTER><STRONG>...</STRONG></CENTER>'.

To add plain characters to a tag, wrap them inside a ``C++'' string. For example,

  SampHighlight        SAMP,"`","'"
Will result in <SAMP>`...'</SAMP> in the HTML file. On the other hand, 
  SampHighlight        "`",SAMP,"'"
results in `<SAMP>...</SAMP>'. In general, when two strings appear one after the other, they are located inside the preceding tags. When placed before (after) the tags, they are located on the outside.

General settings

TOCbody
Tag around TOC section.

TOCheaders CENTER,STRONG
TOC section keywords like `dirs', `files' etc.

FileBody
Tag around generated files.

DirectoryTopicHeader CENTER,H1
A @top name.

ChapterName CENTER,H2
A @chapter name.

FileNameHeader CENTER,H2
Name of elements file, at head of elements page.

FootNotes HR, FONT SIZE=-1
Separates footnotes from page text.

FootnoteRef SUP
Tag aroung footnote hypelink text.

Next 4 tags control the way file items are organized in a page. The template is 
  <FileItems>

    <EntryStart>
       <EntryRef> element-1-name </EntryRef>
       <EntryComment> element-1 comment </EntryComment>
    </EntryStart>

    <EntryStart>
       <EntryRef> element-2-name </EntryRef>
       <EntryComment> element-2 comment </EntryComment>
    </EntryStart>

    ...

  </FileItems>
My personal preference is DL,P,DT,DD.

FileItems UL

EntryStart P

EntryRef LI

EntryComment BR

HTML highlights for texinfo commands

EmphHighlight EM
@emph{}

DfnHighlight DFN
@dfn{}

CodeHighlight CODE
@code{}

SampHighlight SAMP
@samp{}

KbdHighlight KBD
@kbd{}

StrongHighlight STRONG
@strong{}

VarHighlight VAR
@var{}

FileHighlight "`","'"
@file{}

ArgHighlight I
Highlight around function arguments names.

URLHighlight "`","'"
@url{} highlight.

TitlefontHighlight H1
@titlefont{}

SmallCapsHighlight FONT FACE="times"
Highlight for @smallcaps{}.

ExampleHighlight
Highlight for @example section.

DisplayHighlight FONT FACE="helvetica"
Highlight for @display section.

SmallExampleHighlight FONT SIZE=3
Highlight for @smallexample section.

miscellaneous

RefNotFound U
How to tag an un-resolved reference.

Highlights for navigation line connecting chapters.

  <NavigationHighlight>
    <NavigationKWHighlight> Next:  </NavigationKWHighlight> link
    <NavigationKWHighlight> Prev:  </NavigationKWHighlight> link
  </NavigationHighlight>

NavigationHighlight P ALIGN=RIGHT

NavigationKWHighlight

MenuItemHighlight LI
Around @menu @item

BeforeMenuNonItem <P><HR>
Inside @menu section.

MathFuncNameHighlight CODE,STRONG
Around @math function name (such as sin,cos etc)

``C++'' settings

ClassSummary H2
Class summary lines.

Next 4 tags control how class name and derived class are presented. The template is, 
 <ClassHeader>class
  <ClassFullName>A::<ClassName>B</ClassName> </ClassFullName> :
    <ClassDerivedAccess>public </ClassDerivedAccess> ...  </ClassHeader>

ClassHeader
Wrap around the whole thing.

ClassFullName FONT SIZE=+2
Warp around full qualified class name.

ClassName STRONG
Warp around class name only.

ClassDerivedAccess I
Wrap around derived classes access keywords (`public', `virtua' etc).

Mark-ups of special names.

VarName STRONG
``C++'' Variable name.

FunctionName STRONG
``C++'' function name.

ClassMembersHeader STRONG
Around class parts header (`public members:', `private members:' etc.)

ClassMember STRONG
Name of enum,typedef and friend declarations.

EnumElement STRONG
Name inside enum declaration.

TCL settings

TCLproc STRONG
TCL proc name.

Bison settings

BisonRuleName STRONG
Bison rule name.

BisonTokenNames STRONG
Bison tokens in `%token', `%type' etc.

BisonSection H2
Around `union', `tokens' etc. in bison grammar file.

Flex settings

FlexDefinition STRONG
Name of flex definition.

FlexState STRONG
Name of flex state.

FlexSection H2
Around flex section headers.

UserEntryName STRONG
Highlight for element in application specific file.

Other values

Separator <HR>
HTML separator command .

Pre defined file suffixes (See Determining file type).

C++FileSuffixes cc C h
Known ``C++'' suffixes.

TCLFileSuffixes tcl
Known TCL suffixes.

BisonFileSuffixes y
Known bison suffixes.

FlexFileSuffixes l
Known flex suffixes.

DocFileSuffixes doc
Known d4c&b suffixes

TexiFileSuffixes texi
Known texinfo suffixes

Highlight
User defined highlights.

UserFile
Pre defined user file specifications.

SortItems true
Sort file elements according to categories?

RefNargsWarning true
Warn if @ref has the wrong number of arguments.

IndexName c concept
Full index name.

EnumSpacing -1
Number of spaces between enum entries on HTML page.

Ncolumns 80
Target number columns in page.

LinesInIndexPage 40
Maximum number of lines in column of an index page.

NotSupportedTexiCommandWarning true
Warn when encountering a non supported texinfo command in a texinfo file .

IgnoreCC
``C++'' keywords that are eliminated from display.

DefaultProtection public
Default protection setting.

DefaultVebosity concise
Default verbosity setting.

TTHpath
Full path to TTH.