[Reproducible-builds] Bug#826894: diffoscope --help isn't clear that it operates on directories as well as files

[Ceridwen]

Source: diffoscope
Version: 54
Severity: minor
User: reproducible-builds at lists.alioth.debian.org

Dear Maintainer,

The --help text for diffoscope gives no indication that it operates on
directories as well as files:

usage: diffoscope [-h] [--version] [--list-tools [LIST_TOOLS]] [--debug]
                  [--debugger] [--html output] [--html-dir output]
                  [--text output] [--max-report-size BYTES]
                  [--separate-file-diff-size BYTES]
                  [--max-diff-block-lines MAX_DIFF_BLOCK_LINES]
                  [--max-diff-input-lines MAX_DIFF_INPUT_LINES]
                  [--fuzzy-threshold FUZZY_THRESHOLD] [--new-file] [--css url]
                  [--jquery url]
                  file1 file2

Highlight differences between two builds of Debian packages

positional arguments:
  file1                 first file to compare
  file2                 second file to compare
<snip>

This should give some indication that diffoscope can compare
directories as well as files.

-- System Information:
Debian Release: jessie/sid
  APT prefers wily-updates
  APT policy: (500, 'wily-updates'), (500, 'wily-security'), (500, 'wily'), (100, 'wily-backports')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 4.2.0-36-generic (SMP w/8 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)