summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorPaul Eggert <eggert@cs.ucla.edu>2015-12-07 10:03:52 -0800
committerPaul Eggert <eggert@cs.ucla.edu>2015-12-07 10:04:44 -0800
commitc840d3ad89a9016b4d2c22b77495f53b37625d5a (patch)
tree24dc02586f263bd20e5245205a30831c502792e5 /README
parentad9dde0b2562212f2e986be298c2df9e167e2e6a (diff)
downloadcoreutils-c840d3ad89a9016b4d2c22b77495f53b37625d5a.tar.gz
doc: promote 'sort --debug'
* README, doc/coreutils.texi (Introduction, sort invocation): Suggest 'sort --debug' more prominently.
Diffstat (limited to 'README')
-rw-r--r--README20
1 files changed, 13 insertions, 7 deletions
diff --git a/README b/README
index f50b6dfc4..183d4f832 100644
--- a/README
+++ b/README
@@ -59,9 +59,9 @@ files (man/*.x) are welcome. However, the authoritative documentation
is in texinfo form in the doc directory.
-*****************************************
+*********************************************
On Mac OS X 10.5.1 (Darwin 9.1), test failure
------------------------------------------
+---------------------------------------------
Mac OS X 10.5.1 (Darwin 9.1) provides only partial (and incompatible)
ACL support, so although "./configure && make" succeeds, "make check"
@@ -82,9 +82,9 @@ the mean time, you can configure with --disable-nls. For details,
see <http://thread.gmane.org/gmane.comp.lib.gnulib.bugs/12015/>.
-***********************
+*********************
Pre-C99 build failure
------------------------
+---------------------
In 2009 we added this requirement:
To build the coreutils from source, you must have a C99-conforming
@@ -165,6 +165,15 @@ root than when run by less privileged users.
Reporting bugs:
---------------
+Send bug reports, questions, comments, etc. to bug-coreutils@gnu.org.
+To suggest a patch, see the files README-hacking and HACKING for tips.
+
+If you have a problem with 'sort', try running 'sort --debug', as it
+can can often help find and fix problems without having to wait for an
+answer to a bug report. If the debug output does not suffice to fix
+the problem on your own, please compress and attach it to the rest of
+your bug report.
+
IMPORTANT: if you take the time to report a test failure,
please be sure to include the output of running 'make check'
in verbose mode for each failing test. For example,
@@ -176,9 +185,6 @@ run this command:
For some tests, you can get even more detail by adding DEBUG=yes.
Then include the contents of the file 'log' in your bug report.
-Send bug reports, questions, comments, etc. to bug-coreutils@gnu.org.
-If you would like to suggest a patch, see the files README-hacking
-and HACKING for tips.
***************************************