| 1 |
(0) Compiling libcwidget |
| 2 |
|
| 3 |
Compiling cwidget requires a C++ compiler and the ncurses library in |
| 4 |
its wide-character form (libncursesw). To generate API |
| 5 |
documentation, you will also need doxygen (see |
| 6 |
http://www.doxygen.org). |
| 7 |
|
| 8 |
To compile the library, run "./configure && make". If doxygen is |
| 9 |
installed, you can build documentation in the directory "doc" by |
| 10 |
running "make doc". |
| 11 |
|
| 12 |
|
| 13 |
|
| 14 |
(1) Installing libcwidget |
| 15 |
|
| 16 |
To install the library, run "make install". |
| 17 |
|
| 18 |
|
| 19 |
|
| 20 |
(2) Writing software that uses cwidget. |
| 21 |
|
| 22 |
To include cwidget headers, you should use include paths starting |
| 23 |
with cwidget: |
| 24 |
|
| 25 |
#include <cwidget/widgets/tree.h> |
| 26 |
|
| 27 |
See the headers and the generated documentation for more |
| 28 |
information. |
| 29 |
|
| 30 |
|
| 31 |
|
| 32 |
(3) Compiling software that uses cwidget. (pkg-config) |
| 33 |
|
| 34 |
The canonical way to retrieve the include and link flags for programs |
| 35 |
using cwidget is through pkg-config. By hand, the commands: |
| 36 |
|
| 37 |
pkg-config --cflags cwidget |
| 38 |
pkg-config --libs cwidget |
| 39 |
|
| 40 |
will give you compile and linker flags for a program using cwidget. |
| 41 |
You can also include the following line in your configure.ac: |
| 42 |
|
| 43 |
PKG_CHECK_MODULES([CWIDGET], [cwidget]) |
| 44 |
|
| 45 |
See pkg-config(1) for more details. |
| 46 |
|
| 47 |
|
| 48 |
|
| 49 |
(4) Compiling software that uses cwidget. (manual) |
| 50 |
|
| 51 |
Using pkg-config is recommended, as this will insulate you against |
| 52 |
any changes in the layout of the library. However, if you do not |
| 53 |
wish to use pkg-config, you can find the cwidget headers in |
| 54 |
$(includedir) and $(libdir)/cwidget, and the libraries in $(libdir). |
| 55 |
Typically this will mean /usr/include and /usr/local/lib. (the |
| 56 |
configuration header is placed under $(libdir) because it is |
| 57 |
system-dependent data) |