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
85
86
87
88
89
90
|
LibUniNamesList
***************
LibUniNamesList holds www.unicode.org Nameslist.txt data which can be useful
for programs that need Unicode "Names", "Annotations" and block definitions.
Accessing LibUniNamesList Information
*************************************
Older versions of LibUniNamesList consisted of static data arrays which can
be accessed simply as arrays. This access still exists for compatibility
with older programs that use this method. One example program using this
older method is FontForge 20120731-b. The latest version of LibUniNamesList
contains functions which help simplify access to the same data.
Functions to access data in LibUniNamesList is listed here with the oldest
listed first, and latest added function listed last. If more functions are
added, they will be added to the bottom of this list.
1) const char *uniNamesList_name(unsigned long uni);
2) const char *uniNamesList_annot(unsigned long uni);
3) const char *uniNamesList_NamesListVersion(void);
For a better description of each function, check "nameslist.h", and you can
see an example of how to use these funtions in Fontforge ~ 2013xxxx
Building and Installing LibUniNamesList
***************************************
Read the file INSTALLATION for details on building LibUniNamesList using this
package. This package contains 2 libraries, but only 1 is built by default:
1) libuninameslist - holds NamesList.txt data from www.unicode.org
2) libuninameslist-fr - holds an older French 5.0 NamesList.txt
If you need the older libuninameslist-fr library then you will need to enable
building it since the current default is to not build it since this library
appears not to be maintained any longer (last version found was 5.0).
configure --enable-oldfrenchlib
(Also note, that due to it being an older version, you will want to make use
of "nameslist-fr.h" since some information and dimensions are different)
The build process can be summarized quickly like this:
Download LibUniNamesList*.tar.gz
Move it somewhere appropriate (temp perhaps?) and type:
$ tar -xzf libuninameslist*.tar.gz
$ cd libuninameslist????????
$ ./configure
$ make
$ su
# make install
# exit
$
How to Update LibUniNamesList (for maintainers)
***********************************************
The main purpose for LibUniNamesList is to contain a current copy of the
latest updated version of Nameslist.txt as published by www.unicode.org
which can then be accessed by users needing this information.
This means every now and then, LibUniNamesList needs to be updated with new
information. To do this, you will need to get the latest NamesList.txt file
from www.unicode.org which will then be used to build a new namelist.c file.
Let's say the next version of NamesList is version 6.2.
1) Update configure.ac with the new timestamp:
uninameslist_package_stamp "20130501" <-"YYYYMMDD" format
2) Update configure.ac with the new NamesList version:
uninameslist_nameslist_ver "6.2"
3) Increment the point release, was 0.2, now becomes 0.3. NOTE: This minor
point number may get large since LibUniNamesList is backwards compatible.
uninameslist_major_version '0'
uninameslist_minor_version '3'
(if a future update of ListeDesNoms.txt >5.0 appears, then update this;
oldfr_major_version '0'
oldfr_minor_version '2' )
4) Update the config system, and create a versioned buildnameslist.h:
autoreconf -i -Wall
automake --foreign
./configure
5) Build new updated {nameslist.c, nameslist.h, nameslist-fr.c} files.
You will need NamesList.txt and ListeDesNoms.txt in the same directory.
gcc -o buildnameslist buildnameslist.c
./buildnameslist
Please report any bugs, patches and/or improvements to:
fontforge-devel@lists.sourceforge.net
This file was last updated:
2013-may-01, by Joe Da Silva
|
