Bug#133336: Manpage is also buggy

[GOTO Masanori <gotom@debian.or.jp>]

At Fri, 27 Dec 2002 11:56:08 -0500,
H. S. Teoh <hsteoh@quickfur.ath.cx> wrote:
> reassign 133336 glibc-doc,manpages-dev
> thanks
> 
> The manpage termios(3) also claims it returns int:
> 
>        int cfmakeraw(struct termios *termios_p);
> 
> And /usr/include/termios.h (libc6-dev 2.3.1-3) still defines it as
> returning void. Neither the info page nor the manpage makes any mention of
> what exactly cfmakeraw() returns---indicative of possible oversight by
> whoever wrote the original docs.
> 
> According to glibc-2.3.1/termios/cfmakeraw.c:
> 
> void
> cfmakeraw (t)
>      struct termios *t;
> {
>  ...
> }
> 
> 
> So I submit that this is a documentation bug.

Thanks for your report. I think applying this patch is OK for glibc-doc.


--- manual/terminal.texi	2002-10-11 02:50:16.000000000 +0900
+++ manual/terminal.texi.new	2002-12-29 12:16:50.000000000 +0900
@@ -1617,7 +1617,7 @@
 
 @comment termios.h
 @comment BSD
-@deftypefun int cfmakeraw (struct termios *@var{termios-p})
+@deftypefun void cfmakeraw (struct termios *@var{termios-p})
 This function provides an easy way to set up @code{*@var{termios-p}} for
 what has traditionally been called ``raw mode'' in BSD.  This uses
 noncanonical input, and turns off most processing to give an unmodified


-- gotom