This is the mail archive of the
newlib@sourceware.org
mailing list for the newlib project.
[PATCH] makedoc: warn about some obsolete and deprecated commands
- From: Jon Turney <jon dot turney at dronecode dot org dot uk>
- To: newlib at sourceware dot org
- Cc: Jon Turney <jon dot turney at dronecode dot org dot uk>
- Date: Thu, 7 Dec 2017 12:11:24 +0000
- Subject: [PATCH] makedoc: warn about some obsolete and deprecated commands
- Authentication-results: sourceware.org; auth=none
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 <jon.turney@dronecode.org.uk>
---
newlib/doc/doc.str | 17 ++---------------
newlib/doc/makedoc.c | 14 +++++++++++++-
2 files changed, 15 insertions(+), 16 deletions(-)
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');
--
2.15.1