This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: enable MTASC-safety sanity check in manual generation
- From: Alexandre Oliva <aoliva at redhat dot com>
- To: libc-alpha at sourceware dot org
- Date: Wed, 19 Nov 2014 17:59:58 -0200
- Subject: Re: enable MTASC-safety sanity check in manual generation
- Authentication-results: sourceware.org; auth=none
- References: <or389va0jb dot fsf at free dot home>
On Nov 7, 2014, Alexandre Oliva <aoliva@redhat.com> wrote:
> I meant to post this shortly after the 2.19 release, but I forgot.
> This is not expected to have any visible effect, but if anyone gets the
> build to fail because of the error that was previously ignored, please
> let me know, and I'll look into it.
> Ok to install?
Ping? I supose this is trivial enough that I could check it in without
a review by a third party, but I'll wait a couple more days just in
case.
> From: Alexandre Oliva <aoliva@redhat.com>
> for ChangeLog
> * manual/check-safety.sh: Check that each @deftypefn or
> @deftypefun is followed by a @safety remark.
> * manual/Makefile ($(objpfx)stamp-summary): Require
> check-safety.sh to pass.
> ---
> manual/Makefile | 2 +-
> manual/check-safety.sh | 5 +++++
> 2 files changed, 6 insertions(+), 1 deletion(-)
> diff --git a/manual/Makefile b/manual/Makefile
> index 62217a2..1f481f2 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 701624d..aaad313 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' "$@" |
--
Alexandre Oliva, freedom fighter http://FSFLA.org/~lxoliva/
You must be the change you wish to see in the world. -- Gandhi
Be Free! -- http://FSFLA.org/ FSF Latin America board member
Free Software Evangelist|Red Hat Brasil GNU Toolchain Engineer