Installation

Paket-Inhalt

root of highlight-x.x
|
|-- examples            # examples for highlight scripting
|   |-- web_plugins     # plugins for various web toolkits
|   `-- swig            # SWIG interface and sample code
|-- gui_files           # supporting files for the optional GUI
|   |-- ext             # file open filter configuration
|   `-- l10n            # GUI translations
|-- langDefs            # language definitions (*.lang)
|-- man                 # man page
|-- src                 # source code
|   |-- cli             # command line interface code
|   |-- core            # highlight core code (builds the library)
|   |   |-- astyle      # Artistic Style code
|   |   |-- Diliculum   # Diliculum code
|   |   `-- re          # Regex code
|   `-- gui-qt          # optional GUI code
|   `-- include         # Header files
|   |   |-- astyle      # Artistic Style headers
|   |   |-- Diliculum   # Diliculum headers
|   |   `-- re          # Regex headers
`-- themes              # color themes (*.theme)

AUTHORS                 # contributors of code and patches
ChangeLog               # list of changes
COPYING                 # license
Doxyfile                # Doxygen configuration
filetypes.conf          # file type extension configuration
highlight.desktop       # desktop integration of optional GUI
INSTALL                 # this file
makefile                # basic makefile
README                  # user manual
README_DE               # German user manual
README_LANGLIST         # list of supported languages
README_REGEX            # regular expression manual
TODO                    # just ideas, no plans

Abhängigkeiten

Zum Kompileren werden Lua5.1 (devel-Paket) und zumindets die Boost-Header benötgt.

Installation des Source-Pakets

tar xzvf highlight-x.x-x.tar.gz
cd highlight-x.x-x
make help
make
make all-gui (optional, zum Kompilieren der wxWidgets GUI)
make install
(Je nach Installationsziel sind root-Rechte nötig)
make clean (optional)
make apidocs (optional)
(Doxygen muss installiert sein)

Das Standard-Installationsverzeichnis von highlight ist /usr/share/highlight.
Sie können das Verzeichnis zur Kompilier- oder zur Laufzeit ändern:

Lesen Sie in highlight/makefile wie Sie mit einer Compilerdirektive das Verzeichnis anpassen können (HL_DATA_DIR)
Definieren Sie mit der Option --data-dir zur Laufzeit ein neues Datenverzeichnis.
Sie können diesen Parameter in der Highlight-Konfigurationsdatei dauerhaft speichern ($HOME/.highlightrc).
Definieren Sie mit der Option --add-data-dir einen zusätzlichen Suchpfad.
Dateien werden dann zuerst in diesem Pfad gesucht. Diesen Paramter können Sie ebenfalls in $HOME/.highlightrc festlegen.

Bekannte Compiler-Probleme

Gibt es einen stringstream / sstream Header für gcc 2.95.2?
Siehe http://sources.redhat.com/ml/libstdc++/2000-q2/msg00700/sstream
Core dumps mit gcc 2.96 (RedHat 7.1, 7.3)
Redhat hat ein inoffizielles Release des GCC ausgeliefert, die eine fehlerhafte Implementierung von stringsteam enthielt.
Siehe http://www.mail-archive.com/gcc-bugs@gcc.gnu.org/msg22146.html
Kann nur durch Update des GCC auf 3.x gelöst werden. (Gemeldet von Mark Hessling)
Unbekannter "right" IO-Manipulator
In htmlcode.cpp: `right' undeclared (first use this function) (Each undeclared identifier is reported only once for each function it appears in.)
Kann nur durch Update des GCC auf 3.x gelöst werden. (Gemeldet von Christoph Bier)

Installation unter Windows

Setup-Programm starten und Anweisungen folgen.