Date:	Wed, 08 Aug 2001 22:27:09 +0300
From:	"Eli Zaretskii" <eliz AT is DOT elta DOT co DOT il>
Sender:	halo1 AT zahav DOT net DOT il
To:	"Mark E." <snowball3 AT bigfoot DOT com>
Message-Id:	<2110-Wed08Aug2001222709+0300-eliz@is.elta.co.il>
X-Mailer:	Emacs 20.6 (via feedmail 8.3.emacs20_6 I) and Blat ver 1.8.9
CC:	djgpp-workers AT delorie DOT com
In-reply-to:	<3B7146AE.26282.4FAE92@localhost> (snowball3@bigfoot.com)
Subject:	Re: TIOCGWINSZ docs
References:	<3B7146AE DOT 26282 DOT 4FAE92 AT localhost>
Reply-To:	djgpp-workers AT delorie DOT com
Errors-To:	nobody AT delorie DOT com
X-Mailing-List:	djgpp-workers AT delorie DOT com
X-Unsubscribes-To:	listserv AT delorie DOT com

> From: "Mark E." <snowball3 AT bigfoot DOT com>
> Date: Wed, 8 Aug 2001 14:03:26 -0400
> 
> My take on documenting TIOCGWINSZ:

Thanks.

> ! The UNIX version first checks if an FSEXT handler is associated with the file
> ! descriptor @var{fd}. If so, it calls the handler in the usual way
> ! @ref{File System Extensions}.

I'd say make @ref be a @pxref, and put it into parens.  A mere "@ref"
without something like "see" or "as described in" before it reads
wrong in the printed version.

> ! @item TIOCGWINSZ
> ! Fill the @code{struct winsize} structure pointed to by the third argument
> ! with the screen width and height.

Please add the description of struct winsize, because otherwise users
will need to look it up in the header file.

- Raw text -