diff options
-rw-r--r-- | ChangeLog | 12 | ||||
-rw-r--r-- | README-hacking | 44 |
2 files changed, 32 insertions, 24 deletions
@@ -1,3 +1,15 @@ +2014-05-12 James Youngman <jay@gnu.org> + + Several updates and clarifications to README-hacking. + * README-hacking: Explain that tool-versions.txt is not checked + into git. The repository has grown from 14MB to 16MB. Gnulib is + now a submodule and the directory we keep it in has changed. + Remove the suggestion to rsync the translations from the + translation project, since the files that fetches seem to be out + of date. Move the instruction to update ChangeLog to a more + prominent place. Mention that there is an electronic process for + assignments in some locations. Update the copyright year. + 2014-05-11 James Youngman <jay@gnu.org> * gnulib: Update submodule to current version at origin/master. diff --git a/README-hacking b/README-hacking index 5ce65b83..7d38f769 100644 --- a/README-hacking +++ b/README-hacking @@ -18,10 +18,15 @@ Prerequisites * GNU gettext * GNU Dejagnu +Dejagnu is in fact optional, but it's strongly recommened, since it is +needed to run findutils' test suite (which is how you know that find +works once it is built on your system). + The configure program should tell you if you try to use a version of -one of these tools which is not oif a recent enough version. The file +one of these tools which is not of a recent enough version. The file tool-versions.txt indicates which version of each tool the current -release was built and tested with. +release was built and tested with. This is included in the tar-file +releases, but it's not checked in to git. Use the latest upstream sources @@ -31,8 +36,8 @@ Use the latest upstream sources git clone git://git.sv.gnu.org/findutils -This will download the whole repository, it's about 14MB. If you -already have a copy you can refresh it with +This will download the whole repository, it's about 16MB once fetched. +If you already have a copy you can refresh it with: git checkout master (to switch to your copy of the master branch) git pull (to collect and merge changes) @@ -46,17 +51,10 @@ already have a copy you can refresh it with sh import-gnulib.sh This command will use git to check out the version of gnulib which is - intended to work with the findutils source you already have, as - configured by the file import-gnulib.config. The gnulib code itself - is left in the directory "gnulib-git". The "gnulib" directory - contains just the gnulib files that findutils needs during the build - process. - - If you want to build findutils with a different version of gnulib, - just edit import-gnulib.config to change the version and then re-run - import-gnulib.sh. When specifying the version, you can specify - either the date or a tag. If making any kind of release, please - use a fully identifying version (rather than just, say, "HEAD"). + intended to work with the findutils source you already have (gnulib + is used as a git submodule). The gnulib code itself is left in the + directory "gnulib". The "gl" directory contains just the gnulib + files that findutils needs during the build process. The import-gnulib.sh script will also run Autoconf and Automake to generate the "configure" script and "Makefile.in" files. Should you @@ -67,10 +65,6 @@ already have a copy you can refresh it with autoconf && \ automake --add-missing --copy -3. (Optional) Update the translations - - rsync -Lrtvz translationproject.org::tp/latest/findutils/ po - 3. Run "configure" and "make" in the normal way. If you have GNU libintl installed, you can just run "configure". @@ -143,9 +137,9 @@ If you plan to submit changes to findutils, please make sure you have read the GNU coding standard (http://www.gnu.org/prep/standards/). Some common things you might have forgotten to do are: + - add a ChangeLog entry (for now we still do that manually) - document your change in both the manual pages and the Texinfo file - re-run the test suite (with Dejagnu installed!) - - add a ChangeLog entry (for now we still do that manually) - add a test case for the bug you're fixing or feature you're adding - mention your fix or change (if it's significant) in the NEWS file @@ -189,9 +183,11 @@ Copyright assignment If your change is significant (i.e., if it adds more than ~10 lines), then you'll have to have a copyright assignment on file with the FSF. Since that involves first an email exchange between you and the FSF, -and then the exchange (FSF to you, then back) of an actual sheet of paper -with your signature on it, and finally, some administrative processing -in Boston, the process can take a few weeks. +and then the exchange (FSF to you, then back) of an actual sheet of +paper with your signature on it, and finally, some administrative +processing in Boston, the process can take a few weeks (for +contributors in some geographies, this can all be done electronically, +saving a lot of time). The forms to choose from are in gnulib's doc/Copyright/ directory. If you want to assign a single change, you should use the file, @@ -212,7 +208,7 @@ In case you're wondering why we bother with all of this, read this: ======================================================================== -Copyright (C) 2009, 2010 Free Software Foundation, Inc. +Copyright (C) 2009, 2010, 2014 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or |