awtk/3rd/libunibreak
2018-09-23 07:10:43 +08:00
..
src remove unused files 2018-09-23 07:10:43 +08:00
tools add line break 2018-07-27 10:50:05 +08:00
.clang-format add line break 2018-07-27 10:50:05 +08:00
.gitignore add line break 2018-07-27 10:50:05 +08:00
.mailmap add line break 2018-07-27 10:50:05 +08:00
AUTHORS add line break 2018-07-27 10:50:05 +08:00
autogen.sh add line break 2018-07-27 10:50:05 +08:00
bootstrap add line break 2018-07-27 10:50:05 +08:00
ChangeLog add line break 2018-07-27 10:50:05 +08:00
configure.ac add line break 2018-07-27 10:50:05 +08:00
Doxyfile add line break 2018-07-27 10:50:05 +08:00
libunibreak.pc.in add line break 2018-07-27 10:50:05 +08:00
LICENCE add line break 2018-07-27 10:50:05 +08:00
Makefile.am add line break 2018-07-27 10:50:05 +08:00
NEWS add line break 2018-07-27 10:50:05 +08:00
purge add line break 2018-07-27 10:50:05 +08:00
README.md add line break 2018-07-27 10:50:05 +08:00
SConscript add line break 2018-07-27 10:50:05 +08:00

LIBUNIBREAK

Overview

This is the README file for libunibreak, an implementation of the line breaking and word breaking algorithms as described in Unicode Standard Annex 14 and Unicode Standard Annex 29. Check the project's home page for up-to-date information.

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 Public Data, and the Unicode Terms of Use may apply.

Installation

There are three ways to build the library:

  1. 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.
    • type make wordbreakdata to regenerate wordbreakdata.c from WordBreakProperty.txt.
    • type make graphemebreakdata to regenerate graphemebreakdata.c from GraphemeBreakProperty.txt.
  2. On systems where GCC and Binutils are supported, one can type

     cd src
     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.
    • type make wordbreakdata to regenerate wordbreakdata.c from WordBreakProperty.txt.
    • type make graphemebreakdata to regenerate graphemebreakdata.c from GraphemeBreakProperty.txt.
  3. On Windows, apart from using method 1 (Cygwin/MSYS) and method 2 (MinGW), MSVC can also be used. Type

     cd src
     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="libunibreak - Win32 Release"
    

Documentation

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