From: Mark Wooding Date: Tue, 23 Jun 2020 09:16:54 +0000 (+0100) Subject: lib/keyword.3.in, lib/sod-structs.3.in: Use `.VS' and `.VE'. X-Git-Url: https://git.distorted.org.uk/~mdw/sod/commitdiff_plain/f759343aff29934005d0008a6c729b0545f2c98c lib/keyword.3.in, lib/sod-structs.3.in: Use `.VS' and `.VE'. --- diff --git a/lib/keyword.3.in b/lib/keyword.3.in index dc2aa5f..826d80c 100644 --- a/lib/keyword.3.in +++ b/lib/keyword.3.in @@ -204,16 +204,12 @@ so code size will naturally suffer. . .SS Type definitions The header file defines two simple structure types. -.PP -.IP -.nf -.ft B +.VS struct kwval { const char *kw; const void *val; }; -.fi -.PP +.VE The .B kwval structure describes a keyword argument name/value pair. @@ -230,16 +226,12 @@ of the value. makes the size of a .B kwval object independent of the actual argument type.) -.PP -.IP -.nf -.ft B +.VS struct kwtab { const struct kwval *v; size_t n; }; -.fi -.PP +.VE The .B kwtab structure describes a list of keyword arguments, @@ -489,16 +481,12 @@ It should expand to a sequence of one or more list items of the form with no separation between them. .PP For example: -.IP -.nf -.ft B +.VS #define example_KWSET(_) \e .in +4m _(int, x, 0) \e _(const char *, y, NULL) -.fi -.ft P -.PP +.VE Each .I name should be a distinct C identifier; @@ -1114,9 +1102,7 @@ As an example of the kind of special effect which can be achieved using this hook, the following hacking answers whether a function recognizes a particular keyword argument. -.IP -.nf -.ft B +.VS #define KWARGS_TEST(k, val) KWARGS(K(k, val) K(kw.unknown, 0)) static jmp_buf kw_test_jmp; @@ -1145,8 +1131,7 @@ KW_TEST(f, somefunc(1, "two", 3, KWARGS_TEST("shiny", 68.7))); /* now f is nonzero if `somefunc' accepts the `shiny' keyword * (which we hope wants a double argument) */ -.ft P -.fi +.VE . .\"-------------------------------------------------------------------------- .SH BUGS diff --git a/lib/sod-structs.3.in b/lib/sod-structs.3.in index 5cdff33..2774811 100644 --- a/lib/sod-structs.3.in +++ b/lib/sod-structs.3.in @@ -512,9 +512,7 @@ The entire state of an instance of is contained in a single structure of type .B struct .IB C __ilayout \fR. -.IP -.nf -.ft B +.VS struct \fIC\fB__ilayout { \h'2n'union \fIC\fB__ichainu_\fIh\fB { \h'4n'struct \fIC\fB__ichain_\fIh\fB { @@ -534,9 +532,7 @@ struct \fIC\fB__ilayout { }; typedef struct \fIC\fB__ichain_\fIh\fB \fIC\fB; -.ft P -.fi -.PP +.VE The set of superclasses of .IR C , including itself, @@ -700,9 +696,7 @@ A vtable for a class with chain head .I H has the following general structure. -.IP -.nf -.ft B +.VS union \fIC\fB__vtu_\fIh\fB { \h'2n'struct \fIC\fB__vt_\fIh\fB { \h'4n'const \fIP\fB *_class; @@ -721,9 +715,7 @@ union \fIC\fB__vtu_\fIh\fB { }; extern const union \fIC\fB__vtu_\fIh\fB \fIC\fB__vtable_\fIh\fB; -.ft P -.fi -.PP +.VE In the following, let .I M