~q3cpma/misc-tools: README - sourcehut git


                                                                                
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
                            misc-tools
                            ==========

    Overview
    --------

A collection of miscellaneous tools made in C:
    * genhtab     Generate static C99 hash tables
    * htmldecode  HTML decoding to UTF-8
    * htmlencode  HTML encoding from UTF-8
    * mbcut       Multibyte aware string trimming
    * natsort     Natural sorting for UTF-8
    * urldecode   URL decoding
    * urlencode   URL encoding
    * wcswidth    wcswidth(3) wrapper


    Dependencies
    ------------

A POSIX environment with the following additions:
    * mktemp(1) -d                  (build)
    * curl(1), wget(1) or fetch(1)  (htmldecode build)
    * flex(1)                       (htmldecode build)


    Building and installation
    -------------------------

To build and install a tool (default values shown):
    $ BIN=<tool> [CC=c99] [LTO=false] [NATIVE=false] ./build.sh
    # BIN=<tool> [DESTDIR=] [PREFIX=/usr/local] ./build.sh install

Cleanup:
    $ BIN=<tool> ./build.sh clean

Uninstall:
    # BIN=<tool> ./build.sh uninstall

For all operations, omit BIN=<tool> to iterate on all tools. LTO
if strongly recommended for mbcut, to avoid binary bloat due
to utf8.c containing big Unicode LUTs.