73 lines
1.8 KiB
Plaintext
73 lines
1.8 KiB
Plaintext
All you need to know when hacking (modifying) GNU libiconv or when building
|
|
it off the Git repository.
|
|
|
|
|
|
Requirements
|
|
============
|
|
|
|
You will need reasonably recent versions of the build tools:
|
|
|
|
* A C compiler. Such as GNU GCC.
|
|
+ Homepage:
|
|
https://gcc.gnu.org/
|
|
|
|
* GNU automake 1.16.x
|
|
+ Homepage:
|
|
https://www.gnu.org/software/automake/
|
|
|
|
* GNU autoconf 2.69 or newer
|
|
+ Homepage:
|
|
https://www.gnu.org/software/autoconf/
|
|
|
|
* GNU m4
|
|
+ Homepage:
|
|
https://www.gnu.org/software/m4/
|
|
|
|
* GNU gperf
|
|
+ Homepage:
|
|
https://www.gnu.org/software/gperf/
|
|
|
|
* GNU groff 1.17 or newer
|
|
+ Homepage:
|
|
https://www.gnu.org/software/groff/
|
|
|
|
* Perl
|
|
+ Homepage:
|
|
https://www.perl.org/
|
|
|
|
* Either an internet connection or a recent copy of GNU gnulib.
|
|
+ Homepage:
|
|
https://www.gnu.org/software/gnulib/
|
|
|
|
And, of course, the packages listed in the DEPENDENCIES file.
|
|
|
|
|
|
Building off the Git repository
|
|
===============================
|
|
|
|
Access to the Git repository is described at
|
|
https://savannah.gnu.org/git/?group=libiconv .
|
|
|
|
After fetching the sources from the Git repository, peek at the comments in
|
|
autogen.sh, then run
|
|
./gitsub.sh pull
|
|
./autogen.sh
|
|
Then you can proceed with "./configure" as usual.
|
|
|
|
Each time you want to update the source, do not only "git pull". Instead do
|
|
git pull && ./gitsub.sh pull
|
|
./autogen.sh
|
|
|
|
|
|
Adding new encodings
|
|
====================
|
|
|
|
For an indication which encodings are acceptable in the official version of
|
|
GNU libiconv, take a look at NOTES.
|
|
|
|
For an indication which files need to be modified when adding a new encoding,
|
|
look for example at the 2007-05-25 ChangeLog entry for RK1048. The lib/*.h
|
|
file for an encoding is usually generated by one of the tools in the tools/
|
|
directory. All you need to provide is the conversion table in the format of
|
|
the many *.TXT files.
|