Re: Another manpage grammar tweak (ath.4)
On Thu, Apr 11, 2013 at 10:58:00PM -0400, Brian Callahan wrote: Hi tech -- Here's another small fix to correct a grammatically incorrect sentence in ath.4 OK? ~Brian Index: ath.4 === RCS file: /cvs/src/share/man/man4/ath.4,v retrieving revision 1.55 diff -u -p -r1.55 ath.4 --- ath.414 Feb 2013 07:40:42 -1.55 +++ ath.412 Apr 2013 02:54:45 - @@ -78,7 +78,7 @@ transmit speeds as above for 802.11a and .It AR5212 These devices support 802.11a, 802.11b, and 802.11g operation with transmit speeds as above for 802.11a, 802.11b, and 802.11g operation -(802.11g speeds are the same as for 802.11a speeds). +(802.11g speeds are the same as 802.11a speeds). .El .Pp All chips also support an Atheros Turbo Mode (TM) that operates in the hmm. i don;t think this is grammatically incorrect at all. it might sound strange to some ears, i guess. but wrong? why is it wrong? i guess we can reword it if folks think it sounds odd (or wrong ;) but if i had to do that, i'd say it'd sound better as the same as those for 802.11a. your mail suggests there's another man fix around. have i missed something? jmc
Re: Another manpage grammar tweak (ath.4)
On 04/12/13 08:07, Jason McIntyre wrote: On Thu, Apr 11, 2013 at 10:58:00PM -0400, Brian Callahan wrote: Hi tech -- Here's another small fix to correct a grammatically incorrect sentence in ath.4 OK? ~Brian Index: ath.4 === RCS file: /cvs/src/share/man/man4/ath.4,v retrieving revision 1.55 diff -u -p -r1.55 ath.4 --- ath.414 Feb 2013 07:40:42 -1.55 +++ ath.412 Apr 2013 02:54:45 - @@ -78,7 +78,7 @@ transmit speeds as above for 802.11a and .It AR5212 These devices support 802.11a, 802.11b, and 802.11g operation with transmit speeds as above for 802.11a, 802.11b, and 802.11g operation -(802.11g speeds are the same as for 802.11a speeds). +(802.11g speeds are the same as 802.11a speeds). .El .Pp All chips also support an Atheros Turbo Mode (TM) that operates in the hmm. i don;t think this is grammatically incorrect at all. it might sound strange to some ears, i guess. but wrong? why is it wrong? Cause the 802.11a speeds don't have speeds? Admittedly I'm not a native speaker, but I'd agree with the OP. i guess we can reword it if folks think it sounds odd (or wrong ;) but if i had to do that, i'd say it'd sound better as the same as those for 802.11a. This sounds even better. My ok on that one if you feel you need it. :) /Alexander your mail suggests there's another man fix around. have i missed something? jmc
Re: Another manpage grammar tweak (ath.4)
On Fri, Apr 12, 2013 at 08:30:16AM +0200, Alexander Hall wrote: .It AR5212 These devices support 802.11a, 802.11b, and 802.11g operation with transmit speeds as above for 802.11a, 802.11b, and 802.11g operation -(802.11g speeds are the same as for 802.11a speeds). +(802.11g speeds are the same as 802.11a speeds). .El .Pp All chips also support an Atheros Turbo Mode (TM) that operates in the hmm. i don;t think this is grammatically incorrect at all. it might sound strange to some ears, i guess. but wrong? why is it wrong? Cause the 802.11a speeds don't have speeds? Admittedly I'm not a native speaker, but I'd agree with the OP. it's not saying that. it says, in essence, that 11g speeds are the same as for (the) 11a speeds (listed above). it is omitting parts that can be left out because the intent should be fairly obvious. i guess we can reword it if folks think it sounds odd (or wrong ;) but if i had to do that, i'd say it'd sound better as the same as those for 802.11a. This sounds even better. My ok on that one if you feel you need it. :) i don;t really think it needs changed, unless folks are unhappy that it's unclear (or feel its wrong). i guess that's 2 votes so far to change it though ;) jmc
Re: Another manpage grammar tweak (ath.4)
On 04/12/13 08:40, Jason McIntyre wrote: On Fri, Apr 12, 2013 at 08:30:16AM +0200, Alexander Hall wrote: .It AR5212 These devices support 802.11a, 802.11b, and 802.11g operation with transmit speeds as above for 802.11a, 802.11b, and 802.11g operation -(802.11g speeds are the same as for 802.11a speeds). +(802.11g speeds are the same as 802.11a speeds). .El .Pp All chips also support an Atheros Turbo Mode (TM) that operates in the hmm. i don;t think this is grammatically incorrect at all. it might sound strange to some ears, i guess. but wrong? why is it wrong? Cause the 802.11a speeds don't have speeds? Admittedly I'm not a native speaker, but I'd agree with the OP. it's not saying that. it says, in essence, that 11g speeds are the same as for (the) 11a speeds (listed above). it is omitting parts that can be left out because the intent should be fairly obvious. The omitted parts didn't bother me, it's the for that doesn't make sense in my head, as that makes me read I have the same number of socks as your socks [do], implying that the socks have socks, instead of I have the same number of socks as you [do]. Anyway, this isn't a bikeshed I'm very attached to. Just emptying my pockets of pennies. i guess we can reword it if folks think it sounds odd (or wrong ;) but if i had to do that, i'd say it'd sound better as the same as those for 802.11a. This sounds even better. My ok on that one if you feel you need it. :) i don;t really think it needs changed, unless folks are unhappy that it's unclear (or feel its wrong). i guess that's 2 votes so far to change it though ;) Your veto easily outnumbers the two of us though. :-) /Alexander jmc
Re: Another manpage grammar tweak (ath.4)
On 4/12/2013 3:08 AM, Alexander Hall wrote: On 04/12/13 08:40, Jason McIntyre wrote: On Fri, Apr 12, 2013 at 08:30:16AM +0200, Alexander Hall wrote: .It AR5212 These devices support 802.11a, 802.11b, and 802.11g operation with transmit speeds as above for 802.11a, 802.11b, and 802.11g operation -(802.11g speeds are the same as for 802.11a speeds). +(802.11g speeds are the same as 802.11a speeds). .El .Pp All chips also support an Atheros Turbo Mode (TM) that operates in the hmm. i don;t think this is grammatically incorrect at all. it might sound strange to some ears, i guess. but wrong? why is it wrong? Cause the 802.11a speeds don't have speeds? Admittedly I'm not a native speaker, but I'd agree with the OP. it's not saying that. it says, in essence, that 11g speeds are the same as for (the) 11a speeds (listed above). it is omitting parts that can be left out because the intent should be fairly obvious. 11g speeds are the same as for the 11a speeds listed above is still awkward due to its wordiness. You can just say 11g and 11a speeds are the same. And the for still really bothers my ears in that sentence. The omitted parts didn't bother me, it's the for that doesn't make sense in my head, as that makes me read I have the same number of socks as your socks [do], implying that the socks have socks, instead of I have the same number of socks as you [do]. Anyway, this isn't a bikeshed I'm very attached to. Just emptying my pockets of pennies. i guess we can reword it if folks think it sounds odd (or wrong ;) but if i had to do that, i'd say it'd sound better as the same as those for 802.11a. We can go this route. ok for me too. Like Alex, I'm not attached to this. Just pointing out my thoughts. ~Brian
Re: Another manpage grammar tweak (ath.4)
Does this information belong in a device-specific manual in the first place? I don't see it in the manual for any other devices.. Maybe it would be better to remove this and replace with a note in ifmedia(4), or maybe A/B/G markers in the MEDIA TYPES AND OPTIONS FOR IEEE802.11 WIRELESS LAN table.
Re: Another manpage grammar tweak (ath.4)
On Fri, Apr 12, 2013 at 07:40:05AM +0100, Jason McIntyre wrote: On Fri, Apr 12, 2013 at 08:30:16AM +0200, Alexander Hall wrote: .It AR5212 These devices support 802.11a, 802.11b, and 802.11g operation with transmit speeds as above for 802.11a, 802.11b, and 802.11g operation -(802.11g speeds are the same as for 802.11a speeds). +(802.11g speeds are the same as 802.11a speeds). .El .Pp All chips also support an Atheros Turbo Mode (TM) that operates in the hmm. i don;t think this is grammatically incorrect at all. it might sound strange to some ears, i guess. but wrong? why is it wrong? Cause the 802.11a speeds don't have speeds? Admittedly I'm not a native speaker, but I'd agree with the OP. it's not saying that. it says, in essence, that 11g speeds are the same as for (the) 11a speeds (listed above). it is omitting parts that can be left out because the intent should be fairly obvious. i guess we can reword it if folks think it sounds odd (or wrong ;) but if i had to do that, i'd say it'd sound better as the same as those for 802.11a. This sounds even better. My ok on that one if you feel you need it. :) i don;t really think it needs changed, unless folks are unhappy that it's unclear (or feel its wrong). i guess that's 2 votes so far to change it though ;) jmc I'm with jmc. Doesn't seem wrong to me, a native Canadian speaker. Ken
Re: Another manpage grammar tweak (ath.4)
On Fri, Apr 12, 2013 at 12:38:29PM +0100, Stuart Henderson wrote: Does this information belong in a device-specific manual in the first place? I don't see it in the manual for any other devices.. Maybe it would be better to remove this and replace with a note in ifmedia(4), or maybe A/B/G markers in the MEDIA TYPES AND OPTIONS FOR IEEE802.11 WIRELESS LAN table. it maybe doesn;t belong there properly, but i certainly don;t think it does any harm. no objection to updating ifmedia(4) either - that certainly seems a better way. if we do that, i'd have no objection to zapping it from ath(4) (or whatever page it is we're discussing). jmc
Another manpage grammar tweak (ath.4)
Hi tech -- Here's another small fix to correct a grammatically incorrect sentence in ath.4 OK? ~Brian Index: ath.4 === RCS file: /cvs/src/share/man/man4/ath.4,v retrieving revision 1.55 diff -u -p -r1.55 ath.4 --- ath.414 Feb 2013 07:40:42 -1.55 +++ ath.412 Apr 2013 02:54:45 - @@ -78,7 +78,7 @@ transmit speeds as above for 802.11a and .It AR5212 These devices support 802.11a, 802.11b, and 802.11g operation with transmit speeds as above for 802.11a, 802.11b, and 802.11g operation -(802.11g speeds are the same as for 802.11a speeds). +(802.11g speeds are the same as 802.11a speeds). .El .Pp All chips also support an Atheros Turbo Mode (TM) that operates in the
