aboutsummaryrefslogtreecommitdiffstats
path: root/HACKING (follow)
AgeCommit message (Collapse)AuthorFilesLines
2026-01-01maint: run 'make update-copyright'Collin Funk1-1/+1
2025-07-27doc: update git version documented in HACKINGCollin Funk1-1/+1
* HACKING: Mention that git version 1.6.4 or later is required since './bootstrap' will fail otherwise.
2025-01-01maint: update all copyright year number rangesPádraig Brady1-1/+1
Update to latest gnulib with new copyright year. Run "make update-copyright" and then... * gnulib: Update included in this commit as copyright years are the only change from the previous gnulib commit. * tests/init.sh: Sync with gnulib to pick up copyright year. * bootstrap: Likewise. * tests/sample-test: Adjust to use the single most recent year.
2024-01-01maint: update all copyright year number rangesPádraig Brady1-1/+1
Update to latest gnulib with new copyright year. Run "make update-copyright" and then... * gnulib: Update included in this commit as copyright years are the only change from the previous gnulib commit. * tests/init.sh: Sync with gnulib to pick up copyright year. * bootstrap: Manually update copyright year, until we fully sync with gnulib at a later stage. * tests/sample-test: Adjust to use the single most recent year.
2023-08-01maint: reformat text width in HACKINGDragan Simic1-9/+8
* HACKING: Adjust line lengths.
2023-02-04maint: prefer https: to git:Paul Eggert1-2/+2
The idea is to defend against some adversary-in-the-middle attacks.
2023-01-01maint: update all copyright year number rangesPádraig Brady1-1/+1
Update to latest gnulib with new copyright year. Run "make update-copyright" and then... * tests/init.sh: Sync with gnulib to pick up copyright year. * bootstrap: Manually update copyright year, until we fully sync with gnulib at a later stage. * tests/sample-test: Adjust to use the single most recent year.
2022-01-02maint: update all copyright year number rangesPádraig Brady1-1/+1
Run "make update-copyright" and then... * gnulib: Update to latest with copyright year adjusted. * tests/init.sh: Sync with gnulib to pick up copyright year. * bootstrap: Likewise. * tests/sample-test: Adjust to use the single most recent year.
2021-01-01maint: update all copyright year number rangesPádraig Brady1-1/+1
Run "make update-copyright" and then... * gnulib: Update to latest with copyright year adjusted. * tests/init.sh: Sync with gnulib to pick up copyright year. * bootstrap: Likewise. * tests/sample-test: Adjust to use the single most recent year.
2020-01-01maint: update all copyright year number rangesPádraig Brady1-1/+1
Run "make update-copyright" and then... * gnulib: Update to latest with copyright year adjusted. * tests/init.sh: Sync with gnulib to pick up copyright year. * bootstrap: Likewise. * tests/sample-test: Adjust to use the single most recent year.
2019-01-01maint: update all copyright year number rangesAssaf Gordon1-1/+1
Run "make update-copyright" and then... * gnulib: Update to latest with copyright year adjusted. * tests/init.sh: Sync with gnulib to pick up copyright year. * bootstrap: Likewise. * tests/sample-test: Adjust to use the single most recent year.
2018-01-01maint: update all copyright year number rangesPádraig Brady1-1/+1
Run "make update-copyright" and then... * gnulib: Update to latest with copyright year adjusted. * tests/init.sh: Sync with gnulib to pick up copyright year. * bootstrap: Likewise. * tests/sample-test: Adjust to use the single most recent year.
2017-05-03maint: fix various typos in recent commitsPádraig Brady1-2/+2
* NEWS: Grammar fixes. * HACKING: Likewise.
2017-04-29doc: update the instructions for generating a coverage reportPádraig Brady1-16/+14
* HACKING: Change from explicit instructions to using gnulib provided coverage testing targets. Also include instructions for adding root only tests to the report. Fixes http://bugs.gnu.org/26709
2017-02-07maint: fix HACKING instructions to run a single testMaxime de Roucy1-1/+1
* HACKING: s/make TEST=/make check TEST=/ The 'check' target was missing there since v8.20-57-geac397e.
2017-01-14maint: modernize URLsPaul Eggert1-9/+9
A lot of this is converting http: to https:. Also, gmane went away, so remove URLs that no longer work and are not easy to figure out what they were. Some of this stuff is so old that it no longer matters anyway.
2017-01-01maint: update all copyright year number rangesPádraig Brady1-1/+1
Run "make update-copyright" and then... * gnulib: Update to latest with copyright year adjusted. * tests/init.sh: Sync with gnulib to pick up copyright year. * bootstrap: Likewise. * tests/sample-test: Adjust to use the single most recent year.
2016-01-01maint: update all copyright year number rangesPádraig Brady1-1/+1
Run "make update-copyright" and then... * gnulib: Update to latest with copyright year adjusted. * tests/init.sh: Sync with gnulib to pick up copyright year. * bootstrap: Likewise. * tests/sample-test: Adjust to use the single most recent year.
2015-01-01maint: update all copyright year number rangesPádraig Brady1-1/+1
Run "make update-copyright" and then... * tests/sample-test: Adjust to use the single most recent year. * tests/du/bind-mount-dir-cycle-v2.sh: Fix case in copyright message, so that year is updated automatically in future.
2014-06-26tests: use predetermined NON_ROOT_GIDPádraig Brady1-1/+1
* HACKING: GID is more useful in tests than group name, so rename input param from NON_ROOT_GROUP to NON_ROOT_GID to make it obvious that only a group ID is now acceptable, thus allowing GID lookups to be avoided throughout the tests. * init.cfg (require_root_): Likewise. * tests/misc/truncate-owned-by-other.sh: Avoid looking up the GID. * tests/touch/now-owned-by-other.sh: Likewise. * tests/misc/chroot-credentials.sh: Likewise. Also fix an instance of comparison against NON_ROOT_GROUP which would have given a false failure if a non numeric value was passed in. * tests/id/setgid.sh: Use previously looked up gid as a more accurate base for the subsequent adjustment, and move the uid lookup within chroot, rather than having the overhead of a separate `id` invocation.
2014-01-02maint: update all copyright year number rangesBernhard Voelker1-1/+1
Run "make update-copyright", but then also run this, perl -pi -e 's/2\d\d\d-//' tests/sample-test to make that one script use the single most recent year number.
2013-01-01maint: update all copyright year number rangesJim Meyering1-1/+1
Run "make update-copyright", but then also run this, perl -pi -e 's/2\d\d\d-//' tests/sample-test to make that one script use the single most recent year number.
2012-12-20doc: tweak 'lcov' in HACKINGAssaf Gordon1-2/+2
* HACKING: In the paragraph about creating coverage statistics, use the correct -b (--base-directory) parameter.
2012-12-15doc: mention "git stash" in HACKINGAssaf Gordon1-0/+2
* HACKING: In the paragraph about switching branches, mention "git stash" as a way to continue while preserving uncommitted changes.
2012-12-06maint: adjust HACKING instructions to run a single testAssaf Gordon1-2/+4
* HACKING: Adjust as per the recent changes introduced when switching to non recursive make.
2012-10-13doc: improve HACKING guidelinesNikolas Kallis1-0/+1
* HACKING: Add "cd coreutils" after the git clone command. Copyright-paperwork-exempt: Yes
2012-04-03doc: identify/refer to source of each fixed bug in log and in NEWSJim Meyering1-0/+11
* HACKING (Commit log requirements): Describe our policy: when you fix a bug, put the "git describe" string of the bug-introducing commit in your commit log and put the "fixed-in-release version number" in the NEWS blurb.
2012-01-22maint: quote 'like this' or "like this", not `like this'Paul Eggert1-2/+2
* doc/coreutils.texi (Formatting the file names): coreutils now quotes 'like this'. * man/help2man: * src/timeout.c (usage): Quote 'like this' in diagnostics. * HACKING, Makefile.am, NEWS, README, README-hacking, TODO, cfg.mk: * doc/Makefile.am, doc/coreutils.texi, m4/jm-macros.m4: * man/Makefile.am, man/help2man, src/Makefile.am, src/copy.h: * src/extract-magic, src/ls.c, src/pinky.c, src/pr.c, src/sort.c: * src/split.c, src/timeout.c, src/who.c, tests/dd/skip-seek-past-file: * tests/pr/pr-tests: Quote 'like this' in commentary. * cfg.mk (old_NEWS_hash): Update due to changed old NEWS.
2012-01-01maint: update all copyright year number rangesJim Meyering1-1/+1
Run "make update-copyright".
2011-09-02doc: describe test control variablesPádraig Brady1-0/+10
* HACKING (Add tests): Mention the variables and default values. * README-release (Pre-release testing): Mention that setting the SHELL variable may be required. Suggested by Bruno Haible.
2011-07-27doc: add a vim indentation exampleIvan Sichmann Freitas1-3/+18
HACKING: add a vim example showing how to configure it to follow GNU indentation in coreutils source files.
2011-01-12doc: clean up HACKING guidelinesJim Meyering1-8/+4
* HACKING: Remove mention of "indent-tabs-mode: nil", since we've remove all of those directives. No longer needed. Remove dated (pre-emacs-23) reference regarding WhiteSpace mode.
2011-01-01maint: update all copyright year number rangesJim Meyering1-1/+1
Run "make update-copyright".
2010-12-28coreutils: keep lines within 80-column limitsPaul Eggert1-2/+2
* cfg.mk (LINE_LEN_MAX, FILTER_LONG_LINES): New macros. (sc_long_lines): New rule. * HACKING: Use shorter URLs to the same material. * doc/Makefile.am, doc/coreutils.texi, m4/boottime.m4: * man/help2man, man/stdbuf.x, src/Makefile.am, src/cat.c, src/copy.c: * src/cp.c, src/dd.c, src/df.c, src/du.c, src/groups.c, src/install.c: * src/ls.c, src/md5sum.c, src/mv.c, src/od.c, src/pinky.c, src/ptx.c: * src/readlink.c, src/remove.c, src/rmdir.c, src/setuidgid.c: * src/sort.c, src/tail.c, src/touch.c, tests/Coreutils.pm: * tests/cp/existing-perm-race, tests/cp/perm, tests/cp/preserve-gid: * tests/du/2g, tests/du/long-from-unreadable, tests/init.sh: * tests/install/basic-1, tests/ls/nameless-uid: * tests/ls/readdir-mountpoint-inode, tests/misc/chroot-credentials: * tests/misc/cut, tests/misc/date, tests/misc/join, tests/misc/md5sum: * tests/misc/sha1sum, tests/misc/sha224sum, tests/misc/sort: * tests/misc/sort-continue, tests/misc/sort-files0-from: * tests/misc/sort-rand, tests/misc/stdbuf, tests/misc/tr: * tests/misc/uniq, tests/mv/atomic, tests/mv/part-fail: * tests/mv/part-symlink, tests/mv/sticky-to-xpart, tests/pr/pr-tests: * tests/rm/fail-2eperm, tests/rm/interactive-always: Reformat to fit within 80 columns. * doc/Makefile.am (BAD_POSIX_PERL): New macro. * doc/coreutils.texi: Reword slightly, to make menus and index lines shorter. * src/md5sum.c: Redo --help output so that it fits within 79 columns, since that's a bit more portable and all the other --help strings fit in 79 columns.
2010-04-16* HACKING (Add tests): Change example name, "newtest" to "new-test".Jim Meyering1-2/+2
Not that anyone would confuse with something newt-related, but just because it is more readable that way. doc: tweak HACKING
2010-04-16doc: tweak HACKINGJim Meyering1-16/+16
* HACKING (Curly braces): Tweak a sentence. Filter a few paragraphs through "fmt".
2010-04-15doc: document our code formatting policy regarding curly bracesJim Meyering1-0/+101
* HACKING (Curly braces: use judiciously): New section.
2010-01-06maint: apply correct license to auxiliary filesEric Blake1-1/+1
* gnulib: Update, for maint.mk improvements. * HACKING: Use GFDL 1.3, not 1.2. * NEWS: Likewise. * README: Likewise. * cfg.mk (old_NEWS_hash): Update accordingly. * .gitignore: Ignore file created by 'make update-NEWS-hash'.
2010-01-01maint: update all FSF copyright year lists to include 2010Jim Meyering1-1/+1
Use this command: git ls-files | grep -v COPYING \ | xargs env UPDATE_COPYRIGHT_USE_INTERVALS=1 \ build-aux/update-copyright
2009-08-25doc: HACKING: mention the new space-only indentation policyJim Meyering1-12/+17
2009-08-25global: convert indentation-TABs to spacesJim Meyering1-2/+2
Transformed via this shell code: t=$'\t' git ls-files \ | grep -vE '(^|/)((GNU)?[Mm]akefile|ChangeLog)|\.(am|mk)$' \ | grep -vE 'tests/pr/|help2man' \ | xargs grep -lE "^ *$t" \ | xargs perl -MText::Tabs -ni -le \ '$m=/^( *\t[ \t]*)(.*)/; print $m ? expand($1) . $2 : $_'
2009-07-14doc: point to Guile's ChangeLog-writing guidelinesJim Meyering1-4/+9
* HACKING (Commit log requirements): Point to Guile's http://www.gnu.org/software/guile/changelogs/guile-changelogs_3.html. Mention that a bit of prose can be welcome.
2009-06-03doc: HACKING: minor adjustments, additionsJim Meyering1-2/+6
* HACKING (Amending...): Remove spurious "-e" used with commit --amend. (log message policy): Mention the 72-column limit. "build:" and "maint:" are common prefixes, these days.
2009-06-02doc: HACKING: mention the GNU Coding StandardsJim Meyering1-0/+3
* HACKING (Add documentation): Add a link to the GCS.
2009-05-17maint: HACKING: mention a few more useful git commandsJim Meyering1-1/+7
* HACKING (Miscellaneous useful git commands): Add a few.
2009-03-04policy: use git to help avoid trailing white spaceRalf Wildenhues1-0/+19
* HACKING (Avoid trailing white space): Describe how git can help.
2009-02-27* HACKING: avoid trailing white spaceJim Meyering1-0/+24
2009-02-18doc: explain how to recover from changes committed to masterJim Meyering1-3/+8
* HACKING: A beginner's commit-to-master is so common, and causes enough confusion, that we describe how to recover.
2009-02-18maint: add copyright noticesJim Meyering1-0/+10
* HACKING: Add copyright notice. * tests/test-lib.sh: Likewise.
2009-02-13maint: mention how to run a single test in HACKING docsPádraig Brady1-1/+3
* HACKING: Give an example of how to run a test in isolation. * README: Fix/simplify example for running a single test. * README-hacking: Reference the HACKING file.
generated by cgit v1.2.3 (git 2.39.1) at 2026-02-07 09:26:42 +0000