From 2ce4e1e5ad5b694a729e5df13cccaaf514abad45 Mon Sep 17 00:00:00 2001 From: Jon Turney Date: Tue, 5 Dec 2017 18:40:44 +0000 Subject: makedoc: warn about some obsolete and deprecated commands To follow up the thread starting at [1], since all uses of TRAD_SYNOPSIS have been removed, and all uses of ANSI_SYNOPSIS have been renamed to SYNOPSIS, we can now warn about the use of these. [1] https://sourceware.org/ml/newlib/2017/msg01182.html Signed-off-by: Jon Turney --- newlib/doc/doc.str | 17 ++--------------- newlib/doc/makedoc.c | 14 +++++++++++++- 2 files changed, 15 insertions(+), 16 deletions(-) (limited to 'newlib/doc') diff --git a/newlib/doc/doc.str b/newlib/doc/doc.str index 949c6e794..b0bfc9ea4 100644 --- a/newlib/doc/doc.str +++ b/newlib/doc/doc.str @@ -62,25 +62,12 @@ indent catstr "@end example\n" catstr - - ; - -: OLDTRAD_SYNOPSIS - skip_past_newline - "@strong{Traditional Synopsis}\n" catstr - "@example\n" catstr - get_stuff_in_command - do_fancy_stuff - nokill_bogus_lines - indent - catstr - "@end example\n" catstr - + "ANSI_SYNOPSIS is deprecated, use SYNOPSIS instead" warn ; : TRAD_SYNOPSIS skip_past_newline - + "TRAD_SYNOPSIS is obsolete and ignored" warn ; : INDEX diff --git a/newlib/doc/makedoc.c b/newlib/doc/makedoc.c index 45ddfb81e..3f4ff4c06 100644 --- a/newlib/doc/makedoc.c +++ b/newlib/doc/makedoc.c @@ -1019,6 +1019,17 @@ WORD(maybecatstr) } +/* write tos to stderr */ +WORD(warn) +{ + fputs("Warning: ", stderr); + fwrite(tos->ptr, tos->write_idx, 1, stderr); + fputc('\n', stderr); + delete_string(tos); + tos--; + pc++; +} + char * DEFUN(nextword,(string, word), char *string AND @@ -1390,7 +1401,8 @@ char *av[]) add_intrinsic("kill_bogus_lines", kill_bogus_lines); add_intrinsic("indent", indent); add_intrinsic("internalmode", internalmode); - + add_intrinsic("warn", warn); + /* Put a nl at the start */ catchar(&buffer,'\n'); -- cgit v1.2.3