summaryrefslogtreecommitdiffstats
path: root/tests/misc/usage_vs_refs.sh
blob: e112f04b34db93deba3826bf014b25775bcd6aac (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
#!/bin/sh
# Verify that all supported options have references in docs

# Copyright (C) 2026 Free Software Foundation, Inc.

# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.

# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.

# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <https://www.gnu.org/licenses/>.

. "${srcdir=.}/tests/init.sh"; path_prepend_ ./src


getopts() {
  skip='--help|--version'              # These refs treated specially

  env "$1" --help |
  grep -E '^(  -|      --)' |          # find options
  grep -Ev -- " - |-M.*from first" |   # exclude invalid matches
  sed -e 's/^ *//' -e's/  .*//' |      # strip leading space and descriptions
  tr ' ' '\n' |                        # split to one per line
  sed -n 's/^\(--\?[^,=[]*\).*/\1/p' | # Remove parameters
  grep -Ev -- "$skip"                  # These refs treated specially
}

for prg in $built_programs; do

  dprg=$prg
  test $prg = ginstall && dprg=install
  test $prg = '[' && dprg=test
  test $prg = 'dir' && dprg=ls
  test $prg = 'vdir' && dprg=ls
  test $prg = 'md5sum' && dprg=cksum
  test $prg = 'b2sum' && dprg=cksum
  test $prg = 'sha1sum' && dprg=cksum
  test $prg = 'sha224sum' && dprg=cksum
  test $prg = 'sha256sum' && dprg=cksum
  test $prg = 'sha384sum' && dprg=cksum
  test $prg = 'sha512sum' && dprg=cksum

  test "$DEBUG" && echo processing $sprg
  got_option=false
  for opt in $(getopts $prg); do
    got_option=true
    if ! grep -E "opt(Itemx?|Anchor)\\{$dprg,$opt[,}]" \
          "$abs_top_srcdir/doc/coreutils.texi" >/dev/null; then
      if ! grep "optItemx\\?{\\\\cmd\\\\,$opt," \
            "$abs_top_srcdir/doc/coreutils.texi" >/dev/null; then
        printf -- '%s %s reference missing in texi\n' $dprg $opt >&2
        fail=1
      elif test "$DEBUG"; then
        echo "only matched $dprg $opt in a general macro"
      fi
    fi
  done
  test "$DEBUG" && test $got_option = false && echo No options for $prg ?

done

Exit $fail