Beyond Linux® From Scratch (systemd Edition) - Version r13.0-1289

Chapter 9. General Libraries

libical-4.0.5

Introduction to libical

The libical package contains an implementation of the iCalendar protocols and data formats.

[Note]

Note

This package is known to build and work properly using an LFS 13.1 platform.

Package Information

libical Dependencies

Required

CMake-4.4.2

Recommended

GLib-2.88.3 (with GObject Introspection), libxml2-2.15.3, and Vala-0.56.19 (both required for GNOME)

Optional

Doxygen-1.18.0 (for the API documentation), Graphviz-15.1.1 (for the API documentation), GTK-Doc-1.36.1 (for the API documentation), ICU-78.3, PyGObject-3.56.3 (for some tests), and Berkeley DB (deprecated)

Installation of libical

Install libical by running the following commands:

[Note]

Note

This package may occasionally fail when building with multiple processors. See Using Multiple Processors for more information. 

mkdir build &&
cd    build &&

cmake -D CMAKE_INSTALL_PREFIX=/usr  \
      -D CMAKE_BUILD_TYPE=Release   \
      -D LIBICAL_STATIC=NO          \
      -D LIBICAL_BUILD_DOCS=false   \
      -D LIBICAL_GLIB_VAPI=true     \
      -D LIBICAL_JAVA_BINDINGS=OFF  \
      -D LIBICAL_GOBJECT_INTROSPECTION=true \
      .. &&
make -j1

If you have Doxygen-1.18.0, Graphviz-15.1.1, and GTK-Doc-1.36.1 installed and wish to build the API documentation, you should remove the -D LIBICAL_BUILD_DOCS=false switch and issue: 

make docs

If you wish to run the tests, issue: 

cmake .. -D LIBICAL_BUILD_TESTING=ON &&
make &&
make test

Now, as the root user: 

make install

If you have built the API documentation, install by issuing, as root user: 

install -vdm755 /usr/share/doc/libical-4.0.5/html &&
cp -vr apidocs/html/* /usr/share/doc/libical-4.0.5/html

Command Explanations

-D CMAKE_BUILD_TYPE=Release: This switch is used to apply higher level of the compiler optimizations.

-D LIBICAL_STATIC=NO: This switch is used in order to only build the shared libraries.

-D LIBICAL_BUILD_DOCS=false: This switch prevents building the GTK documentation. Remove if you want to build the documentation.

-D LIBICAL_GOBJECT_INTROSPECTION=true: This switch is used to generate GObject metadata bindings.

-D LIBICAL_GLIB_VAPI=true: This switch is used to build bindings for Vala-0.56.19.

-D LIBICAL_ENABLE_BUILTIN_TZDATA=true: This switch is used to use the included timezone data.

Contents

Installed Programs: None
Installed Libraries: libical.so, libicalss.so, libicalss_cxx.so, libicalvcal.so, libicalvcard.so (experimental), libical-glib.so, and libical_cxx.so
Installed Directory: /usr/include/libical, /usr/include/libical-glib, /usr/lib/cmake/LibIcal, /usr/libexec/libical, /usr/share/gtk-doc/libical-glib (when docs are built), and /usr/share/doc/libical-4.0.5

Short Descriptions

libical.so

contains the libical API functions

libical_cxx.so

contains the libical C++ bindings

libical-glib.so

contains the libical glib bindings

libicalss.so

is a library that allows you to store iCal component data on disk in a variety of ways

libicalss_cxx.so

contains the libicalss C++ bindings

libicalvcal.so

is a vCard/vCalendar C interface

libicalvcard.so

is an experimental library for handling VCARD formatted data