[Bug 280434] diff(1) man-page (and no-param help) documents --ignore-all-blanks but option is named --ignore-all-space

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=280434

            Bug ID: 280434
           Summary: diff(1) man-page (and no-param help) documents
                    --ignore-all-blanks but option is named
                    --ignore-all-space
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Manual Pages
          Assignee: bugs@FreeBSD.org
          Reporter: freebsd@tim.thechases.com
                CC: doc@FreeBSD.org

The man page documents an "--ignore-all-blanks" flag

    $ man diff | ul -t dumb | grep -e '-w.*ignore'
     -w --ignore-all-blanks

as does the help

    $ diff 2>&1 | grep 'ignore-all'
       diff [-aBbditwW] [--expand-tabs] [--ignore-all-blanks]

however there is no --ignore-all-blanks option.  According to the source
(usr.bin/diff/diff.c:107) there's an --ignore-all-space option which is the
synonym for the -w option (like what the man-page describes).

So the man-page conflicts with the source code (which is also conflicts with
itself)


    $ grep ignore-all /usr/src/usr.bin/diff/diff.c
        { "ignore-all-space",           no_argument,            0,      'w' },
            "       diff [-aBbditwW] [--expand-tabs] [--ignore-all-blanks]\n"

FWIW, GNU diff(1) uses --ignore-all-space not --ignore-all-blanks if you're
looking for a nudge favoring one vs the other.

-- 
You are receiving this mail because:
You are on the CC list for the bug.