fix docbookgen.cpp to support other than english

    1. support other than english
    2. fix broken example link id
    3. fix incomplete TOC : no Classe etc.
    4. add brief description for Functions etc.
    5. Comply with REPEAT_BRIEF
    6. Do not output duplicated contents when detailed descripton is missing.
    7. set table colwidth for Param/RetVal

Bug 722940 - classes with same name in different namespace adding to same group

Fixed typos in comments. No functional changes.

Fortran color CALL as keyword

Fortran code color END (regression pull request 259)

This is a regression on pull request 259.
Fortran code like:
      end if
was not colored properly anymore. This has been corrected with this patch.

Color the word CALL as keyword.

If two classes with the same name, but in different namespaces (so different qualified names) were added to the same group, only one of them would end up in the group.
The problem is caused by qualifiedName of the class not containing the qualified name but the class name when a class is added to the group.
A workaround is to use the name attribute of the class, which does contain the qualified name.

Bug 687576 - Add support for LATEX_EXTRA_STYLESHEET

Extra empty line in source fragments

Support for INLINE_SOURCES in Fortran

Fortran continuation character seen as begin of function call

Fortran color code of END

The color for the single END in Fortran code was of the color of the flow type entities though for all the flow entities the entity name is mandatory. For the entity statements of some keywords e.g. SUBROUTINE and FUNCTION the entity name is not mandatory with the END statement. The color of the single END statement has been changed from the flow type to the normal keyword type.

In case in fixed format code a line like:
"     x   ( " existed and the x was on position 6 the "x   (" was seen as the start of a function call.

Fortran does not yet support the INLINE_SOURCES, with this patch (part of) this omission is solved.

In case of a language that does not uses curly brackets to define blocks (such as Fortran) there was a newline character in the variable c and this was written in the "code fragment" buffer and subsequently written to the output resulting in and extra empty line on top. I languages using curly brackets this is later overwritten by the while loop searching for the open curly bracket.

Fix bug: language switch command skipped when langauge id contains "-" letter

Fixed typos in comments.

Support language switch for language ids, 'Japanese-en', 'Korean-en', 'Serbian-Cyrillic', and similer langauge ids.

Support visible=no for main page tab.

Bug ?? for page numbers in the latex indices

LaTeX problem with 2 consecutive single quotes

Added the possibility for  LATEX_EXTRA_STYLESHEET analogous to  HTML_EXTRA_STYLESHEET. Special attention has been paid to the extension as ".sty" is automatically added by the \usepackage

Due to the fact that the path was not stripped from the file name in case CREATE_SUBDIRS was set to YES there was a reference to a non existing page reference. In the corresponding hypertarget and label the path was already stripped.

In LaTeX 2 consecutive single quotes are joined to 1 double quote. This leads in texts where 2 single quotes are intended to a strange view. An example is the initial value for variables. E.g. in Fortran: character(len=10) :: A = ''  (i.e an empty string which can either be defined as '' or as "") or in C: char *sq  = "''". In the source listings this is OK but in the description text it was not OK.