QTM's CMake options

Submitted by Matthew Smith on Mon, 2008-09-29 13:04
::

Here is the full list of options you can specify to CMake at configure stage. You must insert the following for each option:

-D OPTION_NAME:TYPE=VALUE

USE_STI:BOOL - If you are using Qt 4.2 or later, and your desktop includes a system tray - i.e. a set of icons which you can use to control programs without going through their main window - you can compile in the QTM system-tray icon. This provides much of QTM's distinctive functionality, such as QuickPost and the templates that go with it. Default: FALSE (but all binaries are supplied with the STI on where the Qt version supports it)

QDEBUG:BOOL - If you are a developer and are helping to fix bugs with QTM, set this option to TRUE. This will mean that messages will appear in the terminal window at certain intervals, a mechanism I use to identify when things go wrong. If you just want to use QTM for blogging, do not enable this. On Windows, this suspends the command prompt if you have one open, and opens one if you run QTM from Explorer. Default: FALSE

DESKTOP_ENTRY_PATH:PATH - QTM's build-system generates a file called qtm.desktop, which the desktop uses to decide where to put QTM in its menu system, such as in KDE and GNOME. Different systems look for this file in different places. Ubuntu, for example, uses /usr/share/applications, while Mandriva and PCLinuxOS use /usr/share/applications/kde (at least, if they are using KDE). Default: /usr/share/applications

MANPAGE_DIRECTORY:PATH - This supplies the location of the QTM manual page, which is displayed when someone types "man qtm" at the Unix command prompt. This is a rudimentary page, supplied mostly to comply with Debian packaging guidelines. Default: /usr/local/share/man/man1 (if compiled to install to /usr/local)

CMAKE_INSTALL_PREFIX:PATH - When you run "make install", this tells your system where to put QTM. If you are building a binary package, you should specify /usr, so that QTM goes to /usr/bin. Leave this out if installing it for your own use. Default: /usr/local (so that qtm will be in /usr/local/bin)

DONT_USE_PTE:BOOL - Only in 0.7 or later. This disables the use of QPlainTextEdit when Qt 4.4 is present (the class was only introduced with that version of Qt), forcing the use of QTextEdit for the main editing widget. This is recommended, as QPlainTextEdit is buggy. Default: TRUE

INSTALL_MARKDOWN:BOOL - Only in 0.7.2 or later on non-Mac Unix platforms. Installs Markdown to a "share" location in the file system (e.g. /usr/share or /usr/local/share) so that it can be used to process text when previewing entries formatted with Markdown. Note that some distributions provide a package of Markdown, so you might not need this option. Default: FALSE

MARKDOWN_LOCATION:PATH - Only in 0.7.2 or later on Windows and non-Mac Unix platforms. This specifies a default location where QTM might find Markdown (the user can override it); you will normally need to specify this if you are using a non-Debian Linux platform. It will not install Markdown to that location but relies on it being there. Default: /usr/bin/markdown on Unix and %APPDIRPATH%/Markdown on Windows.