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
Precedence: bulk

> 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.