TODO: Add entries (documentation needed); remove the "add mktemp program" one.
[platform/upstream/coreutils.git] / TODO
1 document the following in coreutils.texi:
2   runcon
3   chcon
4   mktemp
5   [
6   pinky
7   uptime
8 Also document the SELinux changes.
9
10 comm: add an option, --output-delimiter=STR
11   Files to change: src/comm.c, ChangeLog, NEWS, doc/coreutils.texi,
12   Add a new file, tests/misc/comm (use another file in that directory as
13   a template), to exercise the new option.  Suggestion from Dan Jacobson.
14
15 printf:
16   Now that gnulib supports *printf("%a"), import one of the
17   *printf-posix modules so that printf(1) will support %a even on
18   platforms where the native *printf(3) is deficient.
19   Suggestion from Eric Blake.
20
21 renice: POSIX utility, needs implementing.
22   suggestion from Karl Berry (among others).
23
24 install: add an option to specify the program used to strip binaries.
25   suggestion from Karl Berry
26
27 doc/coreutils.texi:
28   Address this comment: FIXME: mv's behavior in this case is system-dependent
29   Better still: fix the code so it's *not* system-dependent.
30
31 ls: add --format=FORMAT option that controls how each line is printed.
32
33 cp --no-preserve=X should not attempt to preserve attribute X
34   reported by Andreas Schwab
35
36 copy.c: Address the FIXME-maybe comment in copy_internal.
37 And once that's done, add an exclusion so that `cp --link'
38 no longer incurs the overhead of saving src. dev/ino and dest. filename
39 in the hash table.
40
41 See if we can be consistent about where --verbose sends its output:
42   These all send --verbose output to stdout:
43     head, tail, rm, cp, mv, ln, chmod, chown, chgrp, install, ln
44   These send it to stderr:
45     shred mkdir split
46   readlink is different
47
48 Write an autoconf test to work around build failure in HPUX's 64-bit mode.
49 See notes in README -- and remove them once there's a work-around.
50
51 Integrate use of sendfile, suggested here:
52   http://mail.gnu.org/archive/html/bug-fileutils/2003-03/msg00030.html
53 I don't plan to do that, since a few tests demonstrate no significant benefit.
54
55 Should printf '\0123' print "\n3"?
56   per report from TAKAI Kousuke on Mar 27
57   http://mail.gnu.org/archive/html/bug-coreutils/2003-03/index.html
58
59 printf: consider adapting builtins/printf.def from bash
60
61 df: add `--total' option, suggested here http://bugs.debian.org/186007
62
63 seq: give better diagnostics for invalid formats:
64    e.g. no or too many % directives
65 seq: consider allowing format string to contain no %-directives
66
67 tail: don't use xlseek; it *exits*.
68   Instead, maybe use a macro and return nonzero.
69
70 tr: support nontrivial equivalence classes, e.g. [=e=] with LC_COLLATE=fr_FR
71
72 lib/strftime.c: Since %N is the only format that we need but that
73   glibc's strftime doesn't support, consider using a wrapper that
74   would expand /%(-_)?\d*N/ to the desired string and then pass the
75   resulting string to glibc's strftime.
76
77 unexpand: [http://www.opengroup.org/onlinepubs/007908799/xcu/unexpand.html]
78   printf 'x\t \t y\n'|unexpand -t 8,9 should print its input, unmodified.
79   printf 'x\t \t y\n'|unexpand -t 5,8 should print "x\ty\n"
80
81 Let GNU su use the `wheel' group if appropriate.
82   (there are a couple patches, already)
83
84 sort: Investigate better sorting algorithms; see Knuth vol. 3.
85
86   We tried list merge sort, but it was about 50% slower than the
87   recursive algorithm currently used by sortlines, and it used more
88   comparisons.  We're not sure why this was, as the theory suggests it
89   should do fewer comparisons, so perhaps this should be revisited.
90   List merge sort was implemented in the style of Knuth algorithm
91   5.2.4L, with the optimization suggested by exercise 5.2.4-22.  The
92   test case was 140,213,394 bytes, 426,4424 lines, text taken from the
93   GCC 3.3 distribution, sort.c compiled with GCC 2.95.4 and running on
94   Debian 3.0r1 GNU/Linux, 2.4GHz Pentium 4, single pass with no
95   temporary files and plenty of RAM.
96
97   Since comparisons seem to be the bottleneck, perhaps the best
98   algorithm to try next should be merge insertion.  See Knuth section
99   5.3.1, who credits Lester Ford, Jr. and Selmer Johnson, American
100   Mathematical Monthly 66 (1959), 387-389.
101
102 cp --recursive: perform dir traversals in source and dest hierarchy rather
103   than forming full file names.  The latter (current) approach fails
104   unnecessarily when the names become very long.
105
106 Remove suspicious uses of alloca (ones that may allocate more than
107    about 4k)
108
109 Adapt these contribution guidelines for coreutils:
110   http://sources.redhat.com/automake/contribute.html
111
112
113 Changes expected to go in, someday.
114 ======================================
115
116   dd patch from Olivier Delhomme
117
118   Andreas Gruenbacher's xattr changes
119
120   Apply Bruno Haible's hostname changes
121
122   test/mv/*: clean up $other_partition_tmpdir in all cases
123
124   ls: when both -l and --dereference-command-line-symlink-to-dir are
125   specified, consider whether to let the latter select whether to
126   dereference command line symlinks to directories.  Since -l has
127   an implicit --NO-dereference-command-line-symlink-to-dir meaning.
128   Pointed out by Karl Berry.
129
130   A more efficient version of factor, and possibly one that
131   accepts inputs of size 2^64 and larger.
132
133   dd: consider adding an option to suppress `bytes/block read/written'
134   output to stderr.  Suggested here:
135     http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=165045
136
137   Pending copyright papers:
138   ------------------------
139   ls --color: Ed Avis' patch to suppress escape sequences for
140     non-highlighted files
141
142   getpwnam from Bruce Korb
143
144   pb (progress bar) from Miika Pekkarinen
145
146   ------------------------------
147
148 Remove long-deprecated options.  Search case-insensitive for
149 `deprecated' and `remove in '.  Automate this.
150
151 Add a distcheck-time test to ensure that every distributed
152 file is either read-only(indicating generated) or is
153 version-controlled and up to date.
154
155 Implement Ulrich Drepper's suggestion to use getgrouplist rather
156   than getugroups.  This affects only `id', but makes a big difference
157   on systems with many users and/or groups, and makes id usable once
158   again on systems where access restrictions make getugroups fail.
159   But first we'll need a run-test (either in an autoconf macro or at
160   run time) to avoid the segfault bug in libc-2.3.2's getgrouplist.
161   In that case, we'd revert to using a new (to-be-written) getgrouplist
162   module that does most of what `id' already does.  Or just avoid the
163   buggy use of getgrouplist by never passing it a buffer of length zero.
164   See https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=200327
165
166 remove `%s' notation:
167   grep -E "\`%.{,4}s'" src/*.c
168
169 remove or adjust chown's --changes option, since it
170   can't always do what it currently says it does.
171
172 Adapt tools like wc, tr, fmt, etc. (most of the textutils) to be
173   multibyte aware.  The problem is that I want to avoid duplicating
174   significant blocks of logic, yet I also want to incur only minimal
175   (preferably `no') cost when operating in single-byte mode.
176
177 Remove all uses of the `register' keyword
178
179 pr's use of nstrftime can make it malloc a very large (up to SIZE_MAX) buffer
180
181 ls.c: use gettime rather than clock_gettime, gettimeofday, time
182
183 -----
184
185 Copyright (C) 2002-2007 Free Software Foundation, Inc.
186
187 This program is free software: you can redistribute it and/or modify
188 it under the terms of the GNU General Public License as published by
189 the Free Software Foundation, either version 3 of the License, or
190 (at your option) any later version.
191
192 This program is distributed in the hope that it will be useful,
193 but WITHOUT ANY WARRANTY; without even the implied warranty of
194 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
195 GNU General Public License for more details.
196
197 You should have received a copy of the GNU General Public License
198 along with this program.  If not, see <http://www.gnu.org/licenses/>.