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

Chapter 9. General Libraries

libical-4.0.0

Introduction to libical

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

[Note]

Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

Package Information

libical Dependencies

Required

CMake-4.3.2

Recommended

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

Optional

Doxygen-1.17.0 (for the API documentation), Graphviz-14.1.5 (for the API documentation), GTK-Doc-1.36.1 (for the API documentation), ICU-78.3, PyGObject-3.56.2 (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.17.0, Graphviz-14.1.5, 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, add the -D LIBICAL_BUILD_TESTING=ON option to CMake when configuring this package and then issue: 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.0/html &&
cp -vr apidocs/html/* /usr/share/doc/libical-4.0.0/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.0

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