Hi! On 8/30/22 00:33, наб wrote:
Hi! On Tue, Aug 30, 2022 at 12:16:58AM +0200, Alejandro Colomar wrote:Types are formatted with .I, but that seems to be existing practice and I don't find it documented anywhere. (Branden, do you know of any source that discusses this? Is it also like that in other manual pages? Would you do that even if it is the main subject of the page?)I'd used B because the typedefs in SYNOPSIS were B. (FWIW mdoc agrees ‒ groff and mandoc Vt are italic in all output modes)+is used for terminal special characters, +.B speed_t +\(em baud rates, andI would use a 'for' here: A is used for X, B for Y, and C for Z. rather than A is used for X, B -- Y, and C--Z.Sure, see updated scissor-patch below. Best, -- >8 -- speed_t and tcflag_t were both unmentioned in general Issue 7 has this to say: The <termios.h> header shall define the following data types through typedef: cc_t Used for terminal special characters. speed_t Used for terminal baud rates. tcflag_t Used for terminal modes. The above types shall be all unsigned integer types.
I just realized you didn't sign the patches. Will sign them on your behalf if you want.
Cheers, Alex
--- man3type/cc_t.3type | 14 +++++++++++--- man3type/speed_t.3type | 1 + man3type/tcflag_t.3type | 1 + 3 files changed, 13 insertions(+), 3 deletions(-) create mode 100644 man3type/speed_t.3type create mode 100644 man3type/tcflag_t.3type diff --git a/man3type/cc_t.3type b/man3type/cc_t.3type index 029cf945c..6414dbf20 100644 --- a/man3type/cc_t.3type +++ b/man3type/cc_t.3type @@ -6,7 +6,7 @@ .\" .TH CC_T 3type 2021-11-02 "Linux man-pages (unreleased)" .SH NAME -cc_t \- terminal special characters +cc_t, speed_t, tcflag_t \- terminal special characters, baud rates, modes .SH LIBRARY Standard C library .RI ( libc ) @@ -15,10 +15,18 @@ Standard C library .B #include <termios.h> .PP .BR typedef " /* ... */ " cc_t; +.BR typedef " /* ... */ " speed_t; +.BR typedef " /* ... */ " tcflag_t; .fi .SH DESCRIPTION -Used for terminal special characters. -It is an unsigned integer type. +.I cc_t +is used for terminal special characters, +.I speed_t +for baud rates, and +.I tcflag_t +for modes. +.PP +All are unsigned integer types. .SH STANDARDS POSIX.1-2001 and later. .SH SEE ALSO diff --git a/man3type/speed_t.3type b/man3type/speed_t.3type new file mode 100644 index 000000000..26cfd0171 --- /dev/null +++ b/man3type/speed_t.3type @@ -0,0 +1 @@ +.so man3type/cc_t.3type diff --git a/man3type/tcflag_t.3type b/man3type/tcflag_t.3type new file mode 100644 index 000000000..26cfd0171 --- /dev/null +++ b/man3type/tcflag_t.3type @@ -0,0 +1 @@ +.so man3type/cc_t.3type
-- Alejandro Colomar <http://www.alejandro-colomar.es/>
Attachment:
OpenPGP_signature
Description: OpenPGP digital signature
