diff options
Diffstat (limited to 'HACKING')
| -rw-r--r-- | HACKING | 58 |
1 files changed, 48 insertions, 10 deletions
@@ -9,31 +9,31 @@ You will need reasonably recent versions of the build tools: * A C compiler. Such as GNU GCC. + Homepage: - http://gcc.gnu.org/ + https://gcc.gnu.org/ - * GNU automake + * GNU automake 1.16.4 or newer + Homepage: - http://www.gnu.org/software/automake/ + https://www.gnu.org/software/automake/ * GNU autoconf + Homepage: - http://www.gnu.org/software/autoconf/ + https://www.gnu.org/software/autoconf/ * GNU m4 + Homepage: - http://www.gnu.org/software/m4/ + https://www.gnu.org/software/m4/ * GNU gperf + Homepage: - http://www.gnu.org/software/gperf/ + https://www.gnu.org/software/gperf/ * GNU sed + Homepage: - http://www.gnu.org/software/sed/ + https://www.gnu.org/software/sed/ * Perl + Homepage: - http://www.perl.org/ + https://www.perl.org/ * Either an internet connection or a recent copy of GNU gnulib. In order to work with the HEAD of libunistring development, you need the @@ -44,11 +44,40 @@ You will need reasonably recent versions of the build tools: particular version of gnulib which is indicated in the GNULIB_GIT_COMMIT variable in version.sh. + Homepage: - http://www.gnu.org/software/gnulib/ + https://www.gnu.org/software/gnulib/ And, of course, the packages listed in the DEPENDENCIES file. -Then you can run the 'autogen.sh' script + +Additional requirements for maintainers +--------------------------------------- + +If you are a maintainer, you will want to minimize the number of tests that +are skipped. To this effect, you need to install a couple of locales, used by +the tests. By default, only those enabled in /etc/locale.gen are preinstalled. + +$ sudo localedef -i ar_SA -f ISO-8859-6 ar_SA.ISO-8859-6 +$ sudo localedef -i fr_FR -f ISO-8859-1 fr_FR.ISO-8859-1 +$ sudo localedef -i fr_FR -f UTF-8 fr_FR.UTF-8 +$ sudo localedef -i ja_JP -f EUC-JP ja_JP.EUC-JP +$ sudo localedef -i zh_CN -f GB18030 zh_CN.GB18030 + + +Building off the Git repository +=============================== + +Access to the Git repository is described at +https://savannah.gnu.org/git/?group=libunistring . + +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 Sources @@ -72,6 +101,15 @@ To speed up the build: linking and therefore should certainly not be distributed. +Continuous integration +====================== + +The package is built automatically, at regular intervals. You find the latest +build results here: + https://gitlab.com/gnu-libunistring/ci-distcheck/pipelines + https://gitlab.com/gnu-libunistring/ci-distcheck/-/jobs?scope=finished + + Running the testsuite in valgrind ================================= |