Welcome to mirror list, hosted at ThFree Co, Russian Federation.

cygwin.com/git/newlib-cygwin.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJon Turney <jon.turney@dronecode.org.uk>2017-12-05 21:40:44 +0300
committerJon Turney <jon.turney@dronecode.org.uk>2017-12-08 15:09:03 +0300
commit2ce4e1e5ad5b694a729e5df13cccaaf514abad45 (patch)
tree2572262d8d8fb8beaa70ac12b490e0d28ab40c27 /newlib/doc
parent06bd0ecc8dc472e3b2c3d54de994c11122559ee2 (diff)
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 <jon.turney@dronecode.org.uk>
Diffstat (limited to 'newlib/doc')
-rw-r--r--newlib/doc/doc.str17
-rw-r--r--newlib/doc/makedoc.c14
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');