From bf3efe8722f71b10ccae153d754328d900b614c7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tim=20R=C3=BChsen?= Date: Tue, 16 May 2017 15:43:11 +0200 Subject: [PATCH] README: Add notes for first-time contributors * README: Add text written by Bruno Haible --- ChangeLog | 5 +++++ README | 37 ++++++++++++++++++++++++++++++++++++- 2 files changed, 41 insertions(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index 2fa97a247..81f73449e 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2017-05-16 Tim Rühsen + + README: Add notes for first-time contributors + * README: Add text written by Bruno Haible + 2017-05-15 Bruno Haible gnulib-tool: Fix generated code when libtests contains module 'alloca'. diff --git a/README b/README index 0191f7a93..6ef131872 100644 --- a/README +++ b/README @@ -1 +1,36 @@ -Please see doc/gnulib-readme.texi for basic information about Gnulib. +Please create and read the docs with + + $ cd doc + $ make gnulib.html + $ xdg-open gnulib.html + +or read the online manual at + + https://www.gnu.org/software/gnulib/manual/gnulib.html + + +#### Contributor's Quick Start Guide #### + +First pick a subset of the Gnulib modules, that you want to work on. +To create a testdir for these modules: + + $ ./gnulib-tool --create-testdir --dir=../testdir1 --single-configure MODULE1 [MODULE2...] + +This testdir is something you can "./configure CPPFLAGS=-Wall && make && make check". + +For the set of Gnulib modules: + - If you don't specify any, it defaults to *all*! + - There is a script 'posix-modules' that returns the POSIX related modules. Use like this: + + $ ./gnulib-tool --create-testdir --dir=../testdir-posix --single-configure `./posix-modules` + +Note the difference between --dir=../testdir1 and --dir=/tmp/testdir1 : The former is on the +same file system as the gnulib checkout, and uses hard links to the .c and .h files; therefore +for quick edits of only .h and .c files you can do the edits in the testdir, test them +through "make" and "make check", and will usually find them present in the gnulib clone. +In the second case, or when you start to edit .m4 files or module descriptions, it's useful +to work in the gnulib clone, and repeatedly rerun the commands: + + $ ./gnulib-tool --create-testdir --dir=../testdir2 --single-configure MODULE1 [MODULE2...] + $ cd ../testdir2 + $ ./configure CPPFLAGS=-Wall && make && make check -- 2.11.0