From a2b581cb2550391f719268e72f031322215661f7 Mon Sep 17 00:00:00 2001 From: Alexandre Oliva Date: Fri, 21 Nov 2014 02:06:19 -0200 Subject: [PATCH] Require check-safety.sh to pass; wish for check that all fns are documented for ChangeLog * manual/Makefile ($(objpfx)stamp-summary): Require check-safety.sh to pass. * manual/check-safety.sh: Wish for verification that every @deftypefn and @deftypefun is followed by a @safety remark. --- ChangeLog | 7 +++++++ manual/Makefile | 2 +- manual/check-safety.sh | 5 +++++ 3 files changed, 13 insertions(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index 3f0cbbc7c1..a83383ee06 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,10 @@ +2014-11-21 Alexandre Oliva + + * manual/Makefile ($(objpfx)stamp-summary): Require + check-safety.sh to pass. + * manual/check-safety.sh: Wish for verification that every + @deftypefn and @deftypefun is followed by a @safety remark. + 2014-11-20 Roland McGrath * nptl/unwind.c (unwind_cleanup): Use __libc_fatal. diff --git a/manual/Makefile b/manual/Makefile index 62217a2d7a..1f481f251a 100644 --- a/manual/Makefile +++ b/manual/Makefile @@ -84,7 +84,7 @@ $(objpfx)libc/index.html: $(addprefix $(objpfx),$(libc-texi-generated)) $(objpfx)summary.texi: $(objpfx)stamp-summary ; $(objpfx)stamp-summary: summary.awk $(filter-out $(objpfx)summary.texi, \ $(texis-path)) - -$(SHELL) ./check-safety.sh $(filter-out $(objpfx)%, $(texis-path)) + $(SHELL) ./check-safety.sh $(filter-out $(objpfx)%, $(texis-path)) $(AWK) -f $^ | sort -t' ' -df -k 1,1 | tr '\014' '\012' \ > $(objpfx)summary-tmp $(move-if-change) $(objpfx)summary-tmp $(objpfx)summary.texi diff --git a/manual/check-safety.sh b/manual/check-safety.sh index 701624d3b1..aaad313c08 100644 --- a/manual/check-safety.sh +++ b/manual/check-safety.sh @@ -30,6 +30,11 @@ success=: # If no arguments are given, take all *.texi files in the current directory. test $# != 0 || set *.texi +# FIXME: check that each @deftypefu?n is followed by a @safety note, +# with nothing but @deftypefu?nx and comment lines in between. (There +# might be more stuff too). + + # Check that all safety remarks have entries for all of MT, AS and AC, # in this order, with an optional prelim note before them. grep -n '^@safety' "$@" | -- 2.11.4.GIT