Highlight Dokumentation

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.

Lazy pointer - Problem unter MacOS X

Wenn das highlight Binary gestrippt wird, erscheint dieser Fehler beim Start:

dyld: lazy symbol binding failed: lazy pointer not found
dyld: lazy pointer not found
Trace/BPT trap

Um den Abbruch zu vermeiden, muss highlight ohne die -s (--strip) Option neu kompiliert werden (siehe src/makefile, LDFLAGS Variable).

Statisches Linken (um highlight als Service zu starten)

Wenn highlight nicht als Service gestartet werden kann, sollte es mit der -static Option gelinkt werden (siehe src/makefile, LDFLAGS Variable).

Installation unter Windows

Setup-Programm starten und Anweisungen folgen.