Update the documentation in respect to the version of flex and bison that can be used.

Debug output for lexical analyzer

Adjust internationalization part to current situation

The previous commit (pull request) was missing the debug output possibility for config.l and partial for doctokinizer.l.
The later is called on different places by means of the generic definition doctokinizerYYlex, which is declared by means of YY_DECL.
To be able to add the debug output the YY_DECL had to be redefined to be a new function and the new function, with the debug output possibility, has to be called through the original function name.

Debug output for lexical analyzer

In case of error messages like:
    input buffer overflow, can't enlarge buffer because scanner uses REJECT
it is not always directly clear from which lexical analyzer (.l file) this problem comes.
This patch helps to find these problems and does the following things:
- when using the option -d lex with doxygen each time a lexical analyzer is called at the start a line like the following line will be given:
    Entering lexical analyzer: pre.l (for: ..../file.c)
  and at the end:
    Finished lexical analyzer: pre.l (for: ..../file.c)
- in case the lexical analyzer has been translated with the -d option of lex / flex the above mentioned lines will be given as part of the lexical analyzer output (to stderr) and look like:
    --entering lexical analyzer: pre.l (for: ..../file.c)
    --finished lexical analyzer: pre.l (for: ..../file.c)

Space missing in error message.

Bug 711787 - Long initialization line in C stops doxygen

the word 'in' and the vale of filesOption were concatenated

An extra "breakpoint" in the input string has been created in the form of a , (comma), so for initialization lines the line will be shorter and the , (comma) will be copied later on.

Merge branch 'feature/build1' of https://github.com/albert-github/doxygen into albert-github-feature/build1

- .gitignore
src/unistd.h is not on src directory anymore (windows version is on winbuild directory)

- doxywizard.pro.in
consistency 0bj -> ../../objects

- Doxygen.sln
build doxygen 64 bit debug too

- Doxygen.vcproj
Config was missing (cannot be automatic due to the fact that there are 2 rules in 1 file), see also Doxywizard.vcproj

- Doxywizard.vcproj
consistency in respect to directories
$(QTDIR)/mkspecs/msvc2005 -> $(QTDIR)/mkspecs/msvc2008
settings part was present for x64 but not for Win32 (x64 not necessary for doxywizard)
Config_dw was missing (cannot be automatic due to the fact that there are 2 rules in 1 file), see also Doxygen.vcproj

- Version.rules
version.py does not need any arguments

- doxyindexer.vcproj
consistency in respect to directories

- doxysearch.vcproj
consistency in respect to directories

Esperanto not supported by htmlhelp compiler

reverting for esperanto to default language (US English)

Doxysearch under Cygwin should not have extension cgi.exe but just .cgi

Build problem with unistd.h and Cygwin

The standard g++ compiler under windows (win32-g++) has unistd.gh file; Microsoft windows does not have it, therfore it is better to use the winbuild directory in case of windows adn no dependency otherwise

Patch regarding generating the rules file for the windows build regardin...

bug_647517  - make install prepends a slash to the installation path

Patch regarding generating the rules file for the windows build regarding languages, some inconsistencies in the (windows) build system, corrections to some spelling.

- maintainers.txt
Spelling correction

- config.xml
Added missing languages
Extended some descriptions

- htmlhelp.cpp
Added missing languages
Spelling corrections

- language.cpp
Corrected call in respect to Serbian-Cyrillic

- translator_br.h
Spelling correction

- translator_fa.h
Corrected (not used) define in respect to LeftToRight

- translator_mk.h
Spelling correction

- translator_sc.h
Corrected in respect to consistency for Serbian-Cyrillic

- Doxygen.sln
Added project dependency as otherwise there might be a problem with the generation of version.cpp

- Doxygen.vcproj
Added rules for selecting languages to be used during translation
Corrected some incorrect references / directories
Corrected names of generated files / directories so they won't overwrite / conflict (especially during parallel builds)
Corrected name of genhead <-> gen_head (consistency with rules file)

- Doxywizard.vcproj
Corrected some incorrect references / directories
Corrected names of generated files / directories so they won't overwrite / conflict (especially during parallel builds)
Note place of resulting executable has hanged (more consistent now)

- Settings.rules
Corrected place where configure file can be found

- Version.rules
Corrected place where configure file can be found

- doxyindexer.vcproj
Corrected some incorrect references / directories
Corrected names of generated files / directories so they won't overwrite / conflict (especially during parallel builds)

- doxysearch.vcproj
Corrected some incorrect references / directories
Corrected names of generated files / directories so they won't overwrite / conflict (especially during parallel builds)

- iconv.vcproj
Corrected some incorrect references / directories
Corrected names of generated files / directories so they won't overwrite / conflict (especially during parallel builds)

- qtools.vcproj
Corrected some incorrect references / directories
Corrected names of generated files / directories so they won't overwrite / conflict (especially during parallel builds)

- lang_cfg.py
Script to generate the file lang_cfg.h based on the specified languages in the windows GUI or in the configure script.

- languages.py
Script to generate languages pane in the windows GUI
This file has to be called outside visual studio as it generates the rules for the Languages pane in the GUI (command on src directory python languages.py > ..\winbuild\Languages.rules)

- Languages.rules
Result file from language.py (old file was completely wrong and not used)
This file has to be generated outside visual studio as it contains the rules for the Languages pane in the GUI

- configure
Use lang_cfg.py script (consistency) instead of (internal) perl script.

Removed superfluous /