GNU bug report logs - #17185
diff --help doesn't mention short forms of some options

Previous Next

Package: diffutils;

Reported by: Jay Foad <jay.foad <at> gmail.com>

Date: Fri, 4 Apr 2014 15:46:01 UTC

Severity: normal

Done: Jim Meyering <jim <at> meyering.net>

Bug is archived. No further changes may be made.

Full log


Message #10 received at 17185-done <at> debbugs.gnu.org (full text, mbox):

From: Jim Meyering <jim <at> meyering.net>
To: Jay Foad <jay.foad <at> gmail.com>
Cc: 17185-done <at> debbugs.gnu.org
Subject: Re: [bug-diffutils] bug#17185: diff --help doesn't mention short
 forms of some options
Date: Sat, 30 Apr 2016 20:03:13 -0700
tags 17185 notabug
done

On Fri, Apr 4, 2014 at 4:05 AM, Jay Foad <jay.foad <at> gmail.com> wrote:
> $ diff --help | egrep "label|unidirectional|speed"
>       --label LABEL             use LABEL instead of file name
>       --unidirectional-new-file   treat absent first files as empty
>       --speed-large-files  assume large files and many scattered small changes
>
> It would be nice if the help text told me that these options have
> short forms -L, -P and -H respectively.

Thanks for noticing, but I have deliberately undocumented those
short-named options because they are slated to be used differently in
a future release: for link-traversal control, as is already done in
many other tools, e.g., find, cp, du:

$ cp --help|grep -e '-[LHP]'
  -H                           follow command-line symbolic links in SOURCE
  -L, --dereference            always follow symbolic links in SOURCE
  -P, --no-dereference         never follow symbolic links in SOURCE




This bug report was last modified 9 years and 54 days ago.

Previous Next


GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.