File: README.markdown

package info (click to toggle)
haskell-text-icu 0.8.0.5-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 536 kB
  • sloc: haskell: 1,210; ansic: 1,147; makefile: 4
file content (84 lines) | stat: -rw-r--r-- 2,041 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
# Text-ICU: Comprehensive support for string manipulation

This package provides the Data.Text.ICU library, for performing
complex manipulation of Unicode text.  It provides features such as
the following:

* Unicode normalization

* Conversion to and from many common and obscure encodings

* Date and number formatting

* Comparison and collation

## Prerequisites

This library is implemented as bindings to the well-respected [ICU
library](https://icu.unicode.org/) (which is not bundled, and must
be installed separately).

### macOS

    brew install icu4c
    brew link icu4c --force

You might need:

    export PKG_CONFIG_PATH="$(brew --prefix)/opt/icu4c/lib/pkgconfig"

### Debian/Ubuntu

    sudo apt-get update
    sudo apt-get install libicu-dev

### Fedora/CentOS

    sudo dnf install unzip libicu-devel

### Nix/NixOS

    nix-shell --packages icu

### Windows/MSYS2

Under MSYS2, `ICU` can be installed via `pacman`.

    pacman --noconfirm -S mingw-w64-x86_64-icu

Depending on the age of the MSYS2 installation, the keyring might need
to be updated to avoid certification issues, and `pkg-config` might
need to be added.  In this case, do this first:

    pacman --noconfirm -Sy msys2-keyring
    pacman --noconfirm -S mingw-w64-x86_64-pkgconf

### Windows/stack

With `stack` on Windows, which comes with its _own_ bundled MSYS2, the
following commands give up-to-date system dependencies for
`text-icu-0.8.0` (tested 2023-09-30):

    stack exec -- pacman --noconfirm -Sy msys2-keyring
    stack exec -- pacman --noconfirm -S mingw-w64-x86_64-pkgconf
    stack exec -- pacman --noconfirm -S mingw-w64-x86_64-icu


## Compatibility

Upstream ICU occasionally introduces backwards-incompatible API
breaks. This package tries to stay up to date with upstream, and is
currently more or less in sync with ICU 72.

Minimum required version is ICU 62.


## Get involved!

Please report bugs via the
[github issue tracker](https://github.com/haskell/text-icu/issues).


## Authors

This library was written by Bryan O'Sullivan.