[newlib-cygwin] HOWTO: remove reference to TRAD_SYNOPSIS
Yaakov Selkowitz
yselkowitz@sourceware.org
Fri Dec 1 09:44:00 GMT 2017
https://sourceware.org/git/gitweb.cgi?p=newlib-cygwin.git;h=70afa0c7b31dd54fe6841d906afd3a8ae5c958cb
commit 70afa0c7b31dd54fe6841d906afd3a8ae5c958cb
Author: Yaakov Selkowitz <yselkowi@redhat.com>
Date: Thu Nov 30 02:52:35 2017 -0600
HOWTO: remove reference to TRAD_SYNOPSIS
Signed-off-by: Yaakov Selkowitz <yselkowi@redhat.com>
Diff:
---
newlib/HOWTO | 8 +-------
1 file changed, 1 insertion(+), 7 deletions(-)
diff --git a/newlib/HOWTO b/newlib/HOWTO
index c5754e5..bb49e79 100644
--- a/newlib/HOWTO
+++ b/newlib/HOWTO
@@ -47,14 +47,8 @@ but these, however, should be carefully limited and be given alternates for
when a non-printed manual is produced--such as when info pages are produced.
For an example of this kind of usage, see libm/common/s_logb.c.
- Please note that most files with documentation contain both an
-ANSI_SYNOPSIS and a TRAD_SYNOPSIS section. The TRAD_SYNOPSIS section gets
-deleted (since at least 2000) by makedoc, so when working on files these
-can safely be deleted and if you're making a new file, there is no need
-to add the TRAD_SYNOPSIS section.
-
If writing a new function that requires documentation, the required
-sections are FUNCTION, INDEX, ANSI_SYNOPSIS (or SYNOPSIS), DESCRIPTION, RETURNS,
+sections are FUNCTION, INDEX, SYNOPSIS, DESCRIPTION, RETURNS,
and PORTABILITY. BUGS and SEEALSO should be added as appropriate.
Source files which contain documentation are processed into ".def"
More information about the Newlib-cvs
mailing list