File: README

package info (click to toggle)
libt3config 0.2.11-1
  • links: PTS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 524 kB
  • sloc: ansic: 3,753; sh: 828; xml: 172; lex: 87; makefile: 56
file content (76 lines) | stat: -rw-r--r-- 2,315 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
Introduction
============

The libt3config library provides functions for reading and writing simple
structured configuration files. libt3config provides the following features:

- Simple structured syntax.
- Simple API for reading and manipulating configurations.
- Parsed configurations use typed data (boolean, integer, floating point number
  string, list, section).
- Schema definitions, allowing verification of the structure of loaded
  configuration data.
- No use of global variables, allowing easy use in threaded programs (with the
  exception that if uselocale is not available, set_locale should not be called
  at the same time in another thread while reading or writing configuration
  data).

libt3config is part of the Tilde Terminal Toolkit (T3)
[http://os.ghalkes.nl/t3/]

libt3config is licensed under the GNU General Public License version 3. See the
file COPYING for details.


Prerequisites and installation
==============================

libt3config requires GNU libtool to be compiled.

There are two ways in which to compile libt3config:

Using the configure script:
---

$ ./configure
or
$ ./configure --prefix=/usr
(see ./configure --help for more tuning options)
$ make all
$ make install
(assumes working install program)

Manually editing the Makefile to suit your computer:
---

$ cp Makefile.in Makefile

Edit the values for the different variables, using the comments in the
Makefile for guidance, to suit your environment.

$ make all
$ make install
(assumes working install program)

libt3config provides support functions for the XDG Base Directory Specification,
using several non-ANSI C functions. These are: fdopen, fileno, mkdir, close,
fsync, unlink and mkstemp. If these are not available, the XDG support
functions will be replaced with stub functions and the t3_config_xdg_supported
function will return t3_false.

The Makefiles in the distribution should work on all POSIX compatible make's.
They have been tested using both GNU make and BSD make.


Reporting bugs
==============

If you think you have found a bug, please check that you are using the latest
version of libt3config [http://os.ghalkes.nl/t3/libt3config.html]. When
reporting bugs, please include a minimal example that demonstrates the problem.


Author
======

Gertjan Halkes <libt3config@ghalkes.nl>