tools/meson-check-api-docs.sh

   1 #!/bin/sh
   2
   3 set -eu
   4
   5 sd_good=0
   6 sd_total=0
   7 udev_good=0
   8 udev_total=0
   9
  10 for symbol in `nm -g --defined-only "$@" | grep " T " | cut -d" " -f3 | sort -u` ; do
  11         if test -f ${MESON_BUILD_ROOT}/man/$symbol.3 ; then
  12                 echo "✓ Symbol $symbol() is documented."
  13                 good=1
  14         else
  15                 printf "  \x1b[1;31mSymbol $symbol() lacks documentation.\x1b[0m\n"
  16                 good=0
  17         fi
  18
  19         case $symbol in
  20                 sd_*)
  21                         ((sd_good+=good))
  22                         ((sd_total+=1))
  23                         ;;
  24                 udev_*)
  25                         ((udev_good+=good))
  26                         ((udev_total+=1))
  27                         ;;
  28                 *)
  29                         echo 'unknown symbol prefix'
  30                         exit 1
  31         esac
  32 done
  33
  34 echo "libsystemd: $sd_good/$sd_total libudev: $udev_good/$udev_total"