mirror of
https://gitlab.freedesktop.org/cairo/cairo.git
synced 2026-01-03 15:10:17 +01:00
966bf2fe6a
Instead of expecting awk in /usr/bin, this commit changes the code to call awk through a shell so that $PATH is searched. Since this awk script shouldn't really be called manually, this is done by removing the shebang from the awk script, marking it non-executable and fixing up the caller. Bugzilla: https://bugs.freedesktop.org/show_bug.cgi?id=67674 Reviewed-by: Bryce Harrington <b.harrington@samsung.com> Signed-off-by: Uli Schlachter <psychon@znc.in>
82 lines
2.5 KiB
Bash
Executable file
82 lines
2.5 KiB
Bash
Executable file
#!/bin/sh
|
|
|
|
LC_ALL=C
|
|
export LC_ALL
|
|
|
|
if grep --version 2>/dev/null | grep GNU >/dev/null; then
|
|
:
|
|
else
|
|
echo "GNU grep not found; skipping test"
|
|
exit 0
|
|
fi
|
|
|
|
test -z "$srcdir" && srcdir=.
|
|
stat=0
|
|
|
|
echo Checking documentation for incorrect syntax
|
|
|
|
cd "$srcdir"
|
|
|
|
if test "x$SGML_DOCS" = x; then
|
|
FILES=$all_cairo_files
|
|
if test "x$FILES" = x; then
|
|
FILES=`find . -name 'cairo*.h' -or -name 'cairo*.c' -or -name 'cairo*.cpp'`
|
|
fi
|
|
fi
|
|
|
|
enum_regexp="\([^%@']\|^\)\<\(FALSE\|TRUE\|NULL\|CAIRO_[0-9A-Z_]*\)\($\|[^(A-Za-z0-9_]\)"
|
|
if test "x$SGML_DOCS" = x; then
|
|
enum_regexp='^[^:]*:[/ ][*]\(\|[ \t].*\)'$enum_regexp\($\|[^:]\)
|
|
fi
|
|
if echo $FILES | xargs grep . /dev/null | sed -e '/<programlisting>/,/<\/programlisting>/d' | grep "$enum_regexp" | grep -v '#####'; then
|
|
stat=1
|
|
echo Error: some macros in the docs are not prefixed by percent sign.
|
|
echo Fix this by searching for the following regexp in the above files:
|
|
echo " '$enum_regexp'"
|
|
fi >&2
|
|
|
|
type_regexp="\( .*[^#']\| \|^\)\<cairo[0-9a-z_]*_t\>\($\|[^:]$\|[^:].\)"
|
|
if test "x$SGML_DOCS" = x; then
|
|
type_regexp='^[^:]*:[/ ][*]'$type_regexp
|
|
else
|
|
type_regexp='\(.'$type_regexp'\)\|\('$type_regexp'.\)'
|
|
fi
|
|
|
|
if echo $FILES | xargs grep . /dev/null | sed -e '/<programlisting>/,/<\/programlisting>/d' | grep -v "@Title" | grep "$type_regexp" | grep -v '#####'; then
|
|
stat=1
|
|
echo Error: some type names in the docs are not prefixed by hash sign,
|
|
echo neither are the only token in the doc line followed by colon.
|
|
echo Fix this by searching for the following regexp in the above files:
|
|
echo " '$type_regexp'"
|
|
fi >&2
|
|
|
|
func_regexp="\([^#']\|^\)\<\(cairo_[][<>/0-9a-z_]*\>[^][<>(]\)"
|
|
if test "x$SGML_DOCS" = x; then
|
|
func_regexp='^[^:]*:[/ ][*]\(\|[ \t].*\)'$func_regexp
|
|
fi
|
|
|
|
# We need to filter out gtk-doc markup errors for program listings.
|
|
if echo $FILES | xargs grep . /dev/null | sed -e '/<programlisting>/,/<\/programlisting>/d' | grep "$func_regexp" | grep -v '^[^:]*: [*] [a-z_0-9]*:$' | grep -v '#####'; then
|
|
stat=1
|
|
echo Error: some function names in the docs are not followed by parentheses.
|
|
echo Fix this by searching for the following regexp in the above files:
|
|
echo " '$func_regexp'"
|
|
fi >&2
|
|
|
|
note_regexp='\<NOTE\>'
|
|
if echo $FILES | xargs grep "$note_regexp" /dev/null; then
|
|
stat=1
|
|
echo Error: some source files contain the string 'NOTE'.
|
|
echo Be civil and replace it by 'Note' please.
|
|
fi >&2
|
|
|
|
# Only run the syntax checker on the source files (not doc/)
|
|
if test -e ./check-doc-syntax.awk; then
|
|
if echo $FILES | xargs awk -f ./check-doc-syntax.awk ; then
|
|
:
|
|
else
|
|
stat=1
|
|
fi >&2
|
|
fi
|
|
|
|
exit $stat
|