LIBLINEBREAK

Deprecation Notice

Liblinebreak has been superseded by libunibreak in order to support more break types based on Unicode specifications. Please check out libunibreak for future updates.

Overview

Liblinebreak is an implementation of the line breaking algorithm as described in Unicode 6.0.0 Standard Annex 14, Revision 26. It breaks lines that contain Unicode characters. It is designed to be used in a generic text renderer. FBReader is one real-world example, and you may also check some simple sample code, like showbreak and breaktext.

Download

The latest version (2.1) of liblinebreak can be download here, and you may want to check What’s New if you are an existing user.

CVS Access

Please check the information here. The module path is ‘common/tools/linebreak’.

Licence

This library is released under an open-source licence, the zlib/libpng licence. Please check the file LICENCE for details.

Apart from using the algorithm, part of the code is derived from the Unicode Online Data, and the Unicode Terms of Use may apply.

Installation

There are three ways to build the library:

On *NIX systems supported by the autoconfiscation tools, do the normal
```
     ./configure
     make
     sudo make install
```
to build and install both the dynamic and static libraries. In addition, one may
- type ‘make doc’ to generate the doxygen documentation; or
- type ‘make linebreakdata’ to regenerate linebreakdata.c from LineBreak.txt.
On systems where GCC and Binutils are supported, one can type
```
     cp -p Makefile.gcc Makefile
     make
```
to build the static library. In addition, one may
- type ‘make debug’ or ‘make release’ to explicitly generate the debug or release build;
- type ‘make doc’ to generate the doxygen documentation; or
- type ‘make linebreakdata’ to regenerate linebreakdata.c from LineBreak.txt.
On Windows, apart from using method 1 (Cygwin/MSYS) and method 2 (MinGW), MSVC can also be used. Type
```
     nmake -f Makefile.msvc
```
to build the static library. By default the debug release is built. To build the release version
```
     nmake -f Makefile.msvc CFG="linebreak - Win32 Release"
```

Documentation

Check the generated document doc/html/linebreak_8h.html in the downloaded file for the public interfaces exposed to applications.