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

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 17185 in the body.
You can then email your comments to 17185 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Jay Foad <jay.foad <at> gmail.com>
To: bug-diffutils <at> gnu.org
Subject: diff --help doesn't mention short forms of some options
Date: Fri, 4 Apr 2014 12:05:21 +0100

$ 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,
Jay.

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

Previous Next

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