Re: docs/117798: formatting oddity in sysmouse(4)

The following reply was made to PR docs/117798; it has been noted by GNATS.

From: "Poul-Henning Kamp" <[e-mail]>
To: Maxim Konovalov <[e-mail]>
Cc: [e-mail]
Subject: Re: docs/117798: formatting oddity in sysmouse(4) 
Date: Sat, 03 Nov 2007 23:11:45 +0000

 In message <[e-mail]>, Maxim Konovalov writes:
 >> >Description:
 >> 	man 4 sysmouse has a formatting oddity:
 >>
 >>                 MOUSE_MOTION_EVENT and MOUSE_BUTTON_EVENT are newer interface
 >>                 and are designed to be used together.  They are intended to
 >>                 replace functions performed by MOUSE_ACTION alone.
 >>
 >>      u          This union is one of
 >>
 >>                 data
 >>
 >>                       struct mouse_data {
 >>                           int x;
 >>
 >>
 >Why do you think so?  This section describes "union u" from struct
 >mouse_info.
 
 While it may be technically correctly formatted, it certainly looks
 confusing to the casual user.
 
 The the union had been more sensibly named, it would not be a problem,
 but for a single letter name like 'u', I'd propos quoting it, to make
 it clear that it is the actual and entire name.
 
 -- 
 Poul-Henning Kamp       | UNIX since Zilog Zeus 3.20
 [e-mail]         | TCP/IP since RFC 956
 FreeBSD committer       | BSD since 4.3-tahoe    
 Never attribute to malice what can adequately be explained by incompetence.
_______________________________________________
[e-mail] mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "[e-mail]"