* [PATCH] termios.3: Add information how to set baudrate to any other value @ 2021-07-30 15:30 Pali Rohár 2021-07-30 18:29 ` Alejandro Colomar (man-pages) 2021-07-30 18:45 ` [PATCH v2] termios.3: Add information how to set baud rate " Pali Rohár 0 siblings, 2 replies; 10+ messages in thread From: Pali Rohár @ 2021-07-30 15:30 UTC (permalink / raw) To: linux-man, Alejandro Colomar, Michael Kerrisk Signed-off-by: Pali Rohár <pali@kernel.org> --- man3/termios.3 | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/man3/termios.3 b/man3/termios.3 index b7cdec507524..4d4593a33c32 100644 --- a/man3/termios.3 +++ b/man3/termios.3 @@ -967,6 +967,12 @@ Normally, this will disconnect the line. \fBCBAUDEX\fP is a mask for the speeds beyond those defined in POSIX.1 (57600 and above). Thus, \fBB57600\fP & \fBCBAUDEX\fP is nonzero. +Setting baudrate to other value than defined by +.B Bnnn +constants is possible via +.B TCSETS2 +ioctl, see +.BR ioctl_tty (2). .PP .BR cfgetispeed () returns the input baud rate stored in the \fItermios\fP structure. -- 2.20.1 ^ permalink raw reply related [flat|nested] 10+ messages in thread
* Re: [PATCH] termios.3: Add information how to set baudrate to any other value 2021-07-30 15:30 [PATCH] termios.3: Add information how to set baudrate to any other value Pali Rohár @ 2021-07-30 18:29 ` Alejandro Colomar (man-pages) 2021-07-31 1:50 ` G. Branden Robinson 2021-07-30 18:45 ` [PATCH v2] termios.3: Add information how to set baud rate " Pali Rohár 1 sibling, 1 reply; 10+ messages in thread From: Alejandro Colomar (man-pages) @ 2021-07-30 18:29 UTC (permalink / raw) To: Pali Rohár, linux-man, Michael Kerrisk Hi Pali, On 7/30/21 5:30 PM, Pali Rohár wrote: > Signed-off-by: Pali Rohár <pali@kernel.org> Please see some comments below. Thanks, Alex > --- > man3/termios.3 | 6 ++++++ > 1 file changed, 6 insertions(+) > > diff --git a/man3/termios.3 b/man3/termios.3 > index b7cdec507524..4d4593a33c32 100644 > --- a/man3/termios.3 > +++ b/man3/termios.3 > @@ -967,6 +967,12 @@ Normally, this will disconnect the line. > \fBCBAUDEX\fP is a mask > for the speeds beyond those defined in POSIX.1 (57600 and above). > Thus, \fBB57600\fP & \fBCBAUDEX\fP is nonzero. I think this should go on a separate paragraph, don't you? .PP? > +Setting baudrate to other value than defined by wfix?: Setting the baud rate to a value other that those defined by > +.B Bnnn > +constants is possible via s/via/via the/? > +.B TCSETS2 > +ioctl, see s/,/;/ > +.BR ioctl_tty (2). > .PP > .BR cfgetispeed () > returns the input baud rate stored in the \fItermios\fP structure. > -- Alejandro Colomar Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/ http://www.alejandro-colomar.es/ ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH] termios.3: Add information how to set baudrate to any other value 2021-07-30 18:29 ` Alejandro Colomar (man-pages) @ 2021-07-31 1:50 ` G. Branden Robinson 2021-07-31 11:24 ` Alejandro Colomar (man-pages) 0 siblings, 1 reply; 10+ messages in thread From: G. Branden Robinson @ 2021-07-31 1:50 UTC (permalink / raw) To: Alejandro Colomar (man-pages); +Cc: Pali Rohár, linux-man, Michael Kerrisk [-- Attachment #1: Type: text/plain, Size: 1206 bytes --] Hi, Pali & Alex! At 2021-07-30T20:29:24+0200, Alejandro Colomar (man-pages) wrote: > > for the speeds beyond those defined in POSIX.1 (57600 and above). > > Thus, \fBB57600\fP & \fBCBAUDEX\fP is nonzero. > > I think this should go on a separate paragraph, don't you? I would line break after the comma, quote the multiword literal in case the bold attribute gets stripped out of the output (copying and pasting man page text into emails, for instance), and use font style macros instead of font selection escape sequences. > .PP? > > > +Setting baudrate to other value than defined by > > wfix?: > > Setting the baud rate to a value other that those defined by I'd say "baud rate" as two words in English prose (contrast with C), but "than" is correct. > > +.B Bnnn > > +constants is possible via > > s/via/via the/? I agree. > > > +.B TCSETS2 > > +ioctl, see > > s/,/;/ I agree. Comma splices are evil. Incidentally, when checking for semantic newline issues, I use the following search pattern in Vim. /[.;:]. Strictly, I should say /[.;:!?][^\\] and were to bind that to a key, that's probably what I'd use. Regards, Branden [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH] termios.3: Add information how to set baudrate to any other value 2021-07-31 1:50 ` G. Branden Robinson @ 2021-07-31 11:24 ` Alejandro Colomar (man-pages) 0 siblings, 0 replies; 10+ messages in thread From: Alejandro Colomar (man-pages) @ 2021-07-31 11:24 UTC (permalink / raw) To: G. Branden Robinson; +Cc: Pali Rohár, linux-man, Michael Kerrisk Hi Branden, On 7/31/21 3:50 AM, G. Branden Robinson wrote: > Hi, Pali & Alex! > > At 2021-07-30T20:29:24+0200, Alejandro Colomar (man-pages) wrote: >>> for the speeds beyond those defined in POSIX.1 (57600 and above). >>> Thus, \fBB57600\fP & \fBCBAUDEX\fP is nonzero. >> >> I think this should go on a separate paragraph, don't you? > > I would line break after the comma, quote the multiword literal in case > the bold attribute gets stripped out of the output (copying and > pasting man page text into emails, for instance), and use font style > macros instead of font selection escape sequences. I would too, but that was already existing text that was out of the scope of this patch :/ > >> .PP? >> >>> +Setting baudrate to other value than defined by >> >> wfix?: >> >> Setting the baud rate to a value other that those defined by > > I'd say "baud rate" as two words in English prose (contrast with C), but > "than" is correct. Ouch! I meant "than"; "that" was a typo that I introduced. As I already applied the patch, I'll fix it myself in my tree before sending it to Michael. Thanks, Alex > >>> +.B Bnnn >>> +constants is possible via >> >> s/via/via the/? > > I agree. > >> >>> +.B TCSETS2 >>> +ioctl, see >> >> s/,/;/ > > I agree. Comma splices are evil. > > Incidentally, when checking for semantic newline issues, I use the > following search pattern in Vim. > > /[.;:]. > > Strictly, I should say > > /[.;:!?][^\\] > > and were to bind that to a key, that's probably what I'd use. > > Regards, > Branden > -- Alejandro Colomar Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/ http://www.alejandro-colomar.es/ ^ permalink raw reply [flat|nested] 10+ messages in thread
* [PATCH v2] termios.3: Add information how to set baud rate to any other value 2021-07-30 15:30 [PATCH] termios.3: Add information how to set baudrate to any other value Pali Rohár 2021-07-30 18:29 ` Alejandro Colomar (man-pages) @ 2021-07-30 18:45 ` Pali Rohár 2021-07-30 18:59 ` Alejandro Colomar (man-pages) 2021-07-31 0:19 ` G. Branden Robinson 1 sibling, 2 replies; 10+ messages in thread From: Pali Rohár @ 2021-07-30 18:45 UTC (permalink / raw) To: linux-man, Alejandro Colomar, Michael Kerrisk Signed-off-by: Pali Rohár <pali@kernel.org> --- man3/termios.3 | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/man3/termios.3 b/man3/termios.3 index b7cdec507524..7b195c95912b 100644 --- a/man3/termios.3 +++ b/man3/termios.3 @@ -968,6 +968,13 @@ Normally, this will disconnect the line. for the speeds beyond those defined in POSIX.1 (57600 and above). Thus, \fBB57600\fP & \fBCBAUDEX\fP is nonzero. .PP +Setting the baud rate to a value other that those defined by +.B Bnnn +constants is possible via the +.B TCSETS2 +ioctl; see +.BR ioctl_tty (2). +.PP .BR cfgetispeed () returns the input baud rate stored in the \fItermios\fP structure. .PP -- 2.20.1 ^ permalink raw reply related [flat|nested] 10+ messages in thread
* Re: [PATCH v2] termios.3: Add information how to set baud rate to any other value 2021-07-30 18:45 ` [PATCH v2] termios.3: Add information how to set baud rate " Pali Rohár @ 2021-07-30 18:59 ` Alejandro Colomar (man-pages) 2021-07-31 0:19 ` G. Branden Robinson 1 sibling, 0 replies; 10+ messages in thread From: Alejandro Colomar (man-pages) @ 2021-07-30 18:59 UTC (permalink / raw) To: Pali Rohár, linux-man, Michael Kerrisk Hi Pali, On 7/30/21 8:45 PM, Pali Rohár wrote: > Signed-off-by: Pali Rohár <pali@kernel.org> Patch applied. Thanks, Alex > --- > man3/termios.3 | 7 +++++++ > 1 file changed, 7 insertions(+) > > diff --git a/man3/termios.3 b/man3/termios.3 > index b7cdec507524..7b195c95912b 100644 > --- a/man3/termios.3 > +++ b/man3/termios.3 > @@ -968,6 +968,13 @@ Normally, this will disconnect the line. > for the speeds beyond those defined in POSIX.1 (57600 and above). > Thus, \fBB57600\fP & \fBCBAUDEX\fP is nonzero. > .PP > +Setting the baud rate to a value other that those defined by > +.B Bnnn > +constants is possible via the > +.B TCSETS2 > +ioctl; see > +.BR ioctl_tty (2). > +.PP > .BR cfgetispeed () > returns the input baud rate stored in the \fItermios\fP structure. > .PP > -- Alejandro Colomar Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/ http://www.alejandro-colomar.es/ ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH v2] termios.3: Add information how to set baud rate to any other value 2021-07-30 18:45 ` [PATCH v2] termios.3: Add information how to set baud rate " Pali Rohár 2021-07-30 18:59 ` Alejandro Colomar (man-pages) @ 2021-07-31 0:19 ` G. Branden Robinson 2021-07-31 11:04 ` Alejandro Colomar (man-pages) 1 sibling, 1 reply; 10+ messages in thread From: G. Branden Robinson @ 2021-07-31 0:19 UTC (permalink / raw) To: Pali Rohár; +Cc: linux-man, Alejandro Colomar, Michael Kerrisk [-- Attachment #1: Type: text/plain, Size: 268 bytes --] Hi, Pali! At 2021-07-30T20:45:36+0200, Pali Rohár wrote: > +Setting the baud rate to a value other that those defined by > +.B Bnnn > +constants is possible via the I'd say .BI B nnn because the "nnn" is not literal, but variable. Regards, Branden [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH v2] termios.3: Add information how to set baud rate to any other value 2021-07-31 0:19 ` G. Branden Robinson @ 2021-07-31 11:04 ` Alejandro Colomar (man-pages) 2021-07-31 11:06 ` Pali Rohár 0 siblings, 1 reply; 10+ messages in thread From: Alejandro Colomar (man-pages) @ 2021-07-31 11:04 UTC (permalink / raw) To: G. Branden Robinson, Pali Rohár, Michael Kerrisk; +Cc: linux-man Hi Branden, On 7/31/21 2:19 AM, G. Branden Robinson wrote: > Hi, Pali! > > At 2021-07-30T20:45:36+0200, Pali Rohár wrote: >> +Setting the baud rate to a value other that those defined by >> +.B Bnnn >> +constants is possible via the > > I'd say > > .BI B nnn > > because the "nnn" is not literal, but variable. Agree. But as I already merged the patch, I'll add a new patch with that change. Moreover, man pages mostly-consistently use .B Bnn style (although incorrectly, from reading groff_man(7)), so it deserves a separate patch. Thanks, Ale > > Regards, > Branden > -- Alejandro Colomar Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/ http://www.alejandro-colomar.es/ ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH v2] termios.3: Add information how to set baud rate to any other value 2021-07-31 11:04 ` Alejandro Colomar (man-pages) @ 2021-07-31 11:06 ` Pali Rohár 2021-08-01 11:07 ` Alejandro Colomar (man-pages) 0 siblings, 1 reply; 10+ messages in thread From: Pali Rohár @ 2021-07-31 11:06 UTC (permalink / raw) To: Alejandro Colomar (man-pages) Cc: G. Branden Robinson, Michael Kerrisk, linux-man On Saturday 31 July 2021 13:04:50 Alejandro Colomar (man-pages) wrote: > Hi Branden, > > On 7/31/21 2:19 AM, G. Branden Robinson wrote: > > Hi, Pali! > > > > At 2021-07-30T20:45:36+0200, Pali Rohár wrote: > > > +Setting the baud rate to a value other that those defined by > > > +.B Bnnn > > > +constants is possible via the > > > > I'd say > > > > .BI B nnn > > > > because the "nnn" is not literal, but variable. > > Agree. > > But as I already merged the patch, I'll add a new patch with that change. > Moreover, man pages mostly-consistently use .B Bnn style (although > incorrectly, from reading groff_man(7)), so it deserves a separate patch. Makes sense. Would you fix style on all places ('git grep Bnn')? > Thanks, > > Ale > > > > > Regards, > > Branden > > > > > -- > Alejandro Colomar > Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/ > http://www.alejandro-colomar.es/ ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH v2] termios.3: Add information how to set baud rate to any other value 2021-07-31 11:06 ` Pali Rohár @ 2021-08-01 11:07 ` Alejandro Colomar (man-pages) 0 siblings, 0 replies; 10+ messages in thread From: Alejandro Colomar (man-pages) @ 2021-08-01 11:07 UTC (permalink / raw) To: Pali Rohár; +Cc: G. Branden Robinson, Michael Kerrisk, linux-man Hi Pali, On 7/31/21 1:06 PM, Pali Rohár wrote: > On Saturday 31 July 2021 13:04:50 Alejandro Colomar (man-pages) wrote: >> Hi Branden, >> >> On 7/31/21 2:19 AM, G. Branden Robinson wrote: >>> Hi, Pali! >>> >>> At 2021-07-30T20:45:36+0200, Pali Rohár wrote: >>>> +Setting the baud rate to a value other that those defined by >>>> +.B Bnnn >>>> +constants is possible via the >>> >>> I'd say >>> >>> .BI B nnn >>> >>> because the "nnn" is not literal, but variable. >> >> Agree. >> >> But as I already merged the patch, I'll add a new patch with that change. >> Moreover, man pages mostly-consistently use .B Bnn style (although >> incorrectly, from reading groff_man(7)), so it deserves a separate patch. > > Makes sense. Would you fix style on all places ('git grep Bnn')? I fixed it right now for Bnnn: <https://github.com/alejandro-colomar/man-pages/commit/e505393f80d040a03f3c2955e0d236c8e109ee6e> I'll try to fix it for every other case of FOO* in the pages soon. Regards, Alex -- Alejandro Colomar Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/ http://www.alejandro-colomar.es/ ^ permalink raw reply [flat|nested] 10+ messages in thread
end of thread, other threads:[~2021-08-01 11:07 UTC | newest] Thread overview: 10+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2021-07-30 15:30 [PATCH] termios.3: Add information how to set baudrate to any other value Pali Rohár 2021-07-30 18:29 ` Alejandro Colomar (man-pages) 2021-07-31 1:50 ` G. Branden Robinson 2021-07-31 11:24 ` Alejandro Colomar (man-pages) 2021-07-30 18:45 ` [PATCH v2] termios.3: Add information how to set baud rate " Pali Rohár 2021-07-30 18:59 ` Alejandro Colomar (man-pages) 2021-07-31 0:19 ` G. Branden Robinson 2021-07-31 11:04 ` Alejandro Colomar (man-pages) 2021-07-31 11:06 ` Pali Rohár 2021-08-01 11:07 ` Alejandro Colomar (man-pages)
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).