Lines Matching +full:literal +full:- +full:block

3 .\" Copyright (c) 2010-2021, 2024, 2025 Ingo Schwarze <schwarze@openbsd.org>
64 They provide free-form text to be printed; the formatting of the text
66 .Bd -literal -offset indent
91 A well-formed
116 The following is a well-formed skeleton
120 .Bd -literal -offset indent
172 .Bl -ohang -offset Ds
176 .Bd -literal -offset indent
211 .Bd -literal -offset indent
225 .Bd -literal -offset indent
241 macros should follow C header-file conventions.
244 .Bd -literal -offset indent
289 macro or the end of an enclosing block, whichever comes first.
293 .Bd -literal -offset indent
301 .Bd -literal -offset indent
303 \&.Bl \-tag \-width Ds
326 macro followed by a non-standard section name, and each having
338 Implementation-specific notes should be kept here.
374 This often contains snippets of well-formed, well-tested invocations.
401 Cross-references should conventionally be ordered first by section, then
433 Known bugs, limitations, and work-arounds should be described
445 .Bl -column "Brq, Bro, Brc" description
453 .Bl -column "Brq, Bro, Brc" description
462 .Bl -column "Brq, Bro, Brc" description
463 .It Ic \&Bd , \&Ed Ta display block:
468 .It Ic \&Dl Ta indented literal display (one line)
469 .It Ic \&Ql Ta normal in-line literal display: Ql text
470 .It Ic \&Li Ta unquoted in-line literal display: Li text
471 .It Ic \&Bl , \&El Ta list block:
478 .It Ic \&Rs , \&%* , \&Re Ta bibliographic block (references)
481 .Bl -column "Brq, Bro, Brc" description
486 .It Ic \&Bk , \&Ek Ta keep block: Fl words
489 .Bl -column "Brq, Bro, Brc" description
490 .It Ic \&Nm Ta start a SYNOPSIS block with the name of a utility
500 .Bl -column "Brq, Bro, Brc" description
505 .It Ic \&Fo , \&Fc Ta function block: Ar funcname
515 .Bl -column "Brq, Bro, Brc" description
524 .Bl -column "Brq, Bro, Brc" description
528 .It Ic \&Bf , \&Ef Ta font block: Fl Ar type | Cm \&Em | \&Li | \&Sy
531 .Bl -column "Brq, Bro, Brc" description
542 .Bl -column "Brq, Bro, Brc" description
559 .Bl -tag -width 3n
563 block.
572 block.
573 This macro may also be used in a non-bibliographic context when
578 block.
582 block.
590 block.
594 block.
598 block.
602 block.
606 block.
617 block.
624 block.
628 block.
629 This macro may also be used in a non-bibliographical context when
636 block.
640 block.
657 .Bl -tag -width "-nosplitX" -offset indent -compact
682 .Dl \&.An -nosplit
684 .It Ic \&Ao Ar block
685 Begin a block enclosed by angle brackets.
708 .Bd -literal -offset indent
728 usually renders with non-ASCII characters in non-ASCII output modes,
770 .Bl -tag -width "v[1-7] | 32vX" -offset indent -compact
771 .It Cm v[1-7] | 32v
776 .It Cm V | V.[1-4]
799 block.
803 Begin a display block.
807 By default, a display block is preceded by a vertical space.
812 .Bl -tag -width 13n -offset indent
814 Produce one output line from each input line, and center-justify each line.
819 Change the positions of line breaks to fill each line, and left- and
820 right-justify the resulting block.
821 .It Fl literal
823 and do not justify the block at all.
825 Always use a constant-width font.
828 Change the positions of line breaks to fill each line, and left-justify
829 the resulting block.
832 .Fl literal ,
841 .Bl -tag -width 13n -offset indent
846 .Bl -item
848 One of the pre-defined strings
851 .Cm indent-two ,
882 .Bd -literal -offset indent
883 \&.Bd \-literal \-offset indent \-compact
893 .It Ic \&Bf Fl emphasis | literal | symbolic | Cm \&Em | \&Li | \&Sy
894 Change the font mode for a scoped block of text.
904 .Fl literal
933 .Bd -literal -offset indent
934 \&.Bk \-words
940 Be careful in using over-long lines within a keep block!
983 .Bl -tag -width 12n -offset indent
999 For two-column lists, using
1044 .Bl -tag -width 12n -offset indent
1056 Item bodies follow items heads on the same line, using normal inter-word
1084 .It Ic \&Bo Ar block
1085 Begin a block enclosed by square brackets.
1089 .Bd -literal -offset indent -compact
1116 block.
1118 .It Ic \&Bro Ar block
1119 Begin a block enclosed by curly braces.
1123 .Bd -literal -offset indent -compact
1216 One-line indented display.
1238 block.
1254 is the full four-digit year.
1259 .Bl -dash -offset 3n -compact
1291 One-line indented literal display.
1292 This is formatted using a constant-width font
1301 .Ic \&Bd Fl literal ,
1304 .It Ic \&Do Ar block
1305 Begin a block enclosed by double quotes.
1309 .Bd -literal -offset indent -compact
1322 double-quotes.
1325 .Bd -literal -offset indent -compact
1343 .Bl -tag -width section -offset 2n
1409 for special-purpose constants,
1474 .Bd -literal -compact -offset indent
1578 blocks when documenting multi-line function prototypes.
1618 Command-line flag or option.
1619 Used when listing arguments to command-line utilities.
1620 For each argument, prints an ASCII hyphen-minus character
1621 .Sq \- ,
1623 If no arguments are provided, a hyphen-minus is printed followed by a space.
1624 If the argument is a macro, a hyphen-minus is prefixed
1631 .Dl ".Nm locate.updatedb Op Fl \e-fcodes Ns = Ns Ar dbfile"
1635 For GNU-style long options, escaping the additional hyphen-minus is not
1658 .Bd -literal -offset indent
1673 Begin a function block.
1674 This is a multi-line version of
1678 .Bd -ragged -offset indent
1716 .Bd -literal -offset indent -compact
1765 .Ic \&Bd Fl literal
1832 The line arguments correspond to the list's left-hand side; body
1847 block macro or by literal tab characters.
1849 Using literal tabs is strongly discouraged because they are very
1854 before and after the literal tab character.
1868 Note that quoted strings may span tab-delimited cells on an
1897 .Bd -literal -offset indent -compact
1906 Unquoted in-line literal display, always set in a constant-width font.
1918 For longer literal displays, use
1921 .Ic \&Bd Fl literal Pq multi-line
1991 .Sx Block full-implicit
1995 .Sx In-line
1999 .Bd -literal -offset indent
2016 Closes the scope of any preceding in-line macro.
2027 .Bd -literal -offset indent
2078 Close multi-line
2081 .It Ic \&Oo Ar block
2082 Multi-line version of
2086 .Bd -literal -offset indent -compact
2201 .It Ic \&Po Ar block
2202 Multi-line version of
2232 Normal in-line literal display, always set in constant-width font and
2234 This can be used for complete command invocations and for multi-word
2240 .Fl literal ,
2243 .It Ic \&Qo Ar block
2244 Multi-line version of
2250 double-quotes.
2262 block.
2268 block.
2270 The block macro may only contain
2289 .Bd -literal -offset indent -compact
2294 \&.%I Addison-Wesley
2302 block is used within a SEE ALSO section, a vertical space is asserted
2303 before the rendered output, else the block continues on the current
2308 on success and \-1 on error, with the
2324 Close single-quoted context opened by
2362 .It Ic \&So Ar block
2363 Multi-line version of
2369 single-quotes.
2406 .Bl -tag -width 1n
2409 .Bl -tag -width "-p1003.1g-2000" -compact
2410 .It \-ansiC
2411 .St -ansiC
2412 .It \-ansiC-89
2413 .St -ansiC-89
2414 .It \-isoC
2415 .St -isoC
2416 .It \-isoC-90
2417 .St -isoC-90
2421 .It \-isoC-amd1
2422 .St -isoC-amd1
2424 .It \-isoC-tcor1
2425 .St -isoC-tcor1
2427 .It \-isoC-tcor2
2428 .St -isoC-tcor2
2430 .It \-isoC-99
2431 .St -isoC-99
2435 .It \-isoC-2011
2436 .St -isoC-2011
2440 .It \-isoC-2023
2441 .St -isoC-2023
2447 .Bl -tag -width "-p1003.1g-2000" -compact
2448 .It \-p1003.1-88
2449 .St -p1003.1-88
2450 .It \-p1003.1
2451 .St -p1003.1
2455 .It \-p1003.1-90
2456 .St -p1003.1-90
2457 .It \-iso9945-1-90
2458 .St -iso9945-1-90
2462 .It \-p1003.1b-93
2463 .St -p1003.1b-93
2464 .It \-p1003.1b
2465 .St -p1003.1b
2467 Real-time extensions.
2469 .It \-p1003.1c-95
2470 .St -p1003.1c-95
2474 .It \-p1003.1i-95
2475 .St -p1003.1i-95
2479 .It \-p1003.1-96
2480 .St -p1003.1-96
2481 .It \-iso9945-1-96
2482 .St -iso9945-1-96
2484 Includes POSIX.1-1990, 1b, 1c, and 1i.
2488 .Bl -tag -width "-p1003.1g-2000" -compact
2489 .It \-xpg3
2490 .St -xpg3
2494 .It \-p1003.2
2495 .St -p1003.2
2496 .It \-p1003.2-92
2497 .St -p1003.2-92
2498 .It \-iso9945-2-93
2499 .St -iso9945-2-93
2503 .It \-p1003.2a-92
2504 .St -p1003.2a-92
2508 .It \-xpg4
2509 .St -xpg4
2515 .Bl -tag -width "-p1003.1g-2000" -compact
2516 .It \-susv1
2517 .St -susv1
2518 .It \-xpg4.2
2519 .St -xpg4.2
2525 .It \-xcurses4.2
2526 .St -xcurses4.2
2528 .It \-p1003.1g-2000
2529 .St -p1003.1g-2000
2533 .It \-svid4
2534 .St -svid4 ,
2540 .Bl -tag -width "-p1003.1g-2000" -compact
2541 .It \-susv2
2542 .St -susv2
2549 .It \-xbd5
2550 .St -xbd5
2552 .It \-xsh5
2553 .St -xsh5
2555 .It \-xcu5
2556 .St -xcu5
2558 .It \-xns5
2559 .St -xns5
2560 .It \-xns5.2
2561 .St -xns5.2
2565 .Bl -tag -width "-p1003.1-2001" -compact
2566 .It \-p1003.1-2001
2567 .St -p1003.1-2001
2568 .It \-susv3
2569 .St -susv3
2571 This standard is based on C99, SUSv2, POSIX.1-1996, 1d, and 1j.
2575 .It \-p1003.1-2004
2576 .St -p1003.1-2004
2582 .Bl -tag -width "-p1003.1g-2000" -compact
2583 .It \-p1003.1-2008
2584 .St -p1003.1-2008
2585 .It \-susv4
2586 .St -susv4
2593 .Bl -tag -width "-p1003.1g-2000" -compact
2594 .It \-p1003.1-2024
2595 .St -p1003.1-2024
2603 .Bl -tag -width "-p1003.1g-2000" -compact
2604 .It \-ieee754
2605 .St -ieee754
2607 Floating-point arithmetic.
2609 .It \-iso8601
2610 .St -iso8601
2614 .It \-iso8802-3
2615 .St -iso8802-3
2619 .It \-ieee1275-94
2620 .St -ieee1275-94
2647 .Bd -literal -compact -offset indent
2651 appears in the owner permissions, set-user-ID mode is set.
2717 using it as a presentation-level macro to request a small caps font.
2749 .Sx Block partial-implicit
2753 .Sx In-line
2777 .It Ic \&Xo Ar block
2780 macro or the body of a partial-implicit block macro
2782 This macro originally existed to work around the 9-argument limit
2788 .Pq Qq cross-reference .
2804 .Sq \-arg
2822 escape it by prepending a zero-width space,
2845 .Ss Block full-explicit
2846 Multi-line scope closed by an explicit closing macro.
2853 .Bd -literal -offset indent
2854 \&.Yo \(lB\-arg \(lBparm...\(rB\(rB \(lBhead...\(rB
2858 .Bl -column "MacroX" "CallableX" "ParsedX" "closed by XXX" -offset indent
2869 .Ss Block full-implicit
2870 Multi-line scope closed by end-of-file or implicitly by another macro.
2886 .Bd -literal -offset indent
2887 \&.Yo \(lB\-arg \(lBparm...\(rB\(rB \(lBhead... \(lBTa head...\(rB\(rB
2890 .Bl -column "MacroX" "CallableX" "ParsedX" "closed by XXXXXXXXXXX" -offset indent
2902 .Sx Block full-implicit
2907 .Sx In-line .
2908 .Ss Block partial-explicit
2909 Like block full-explicit, but also with single-line scope.
2917 .Bd -literal -offset indent
2918 \&.Yo \(lB\-arg \(lBparm...\(rB\(rB \(lBhead...\(rB
2922 \&.Yo \(lB\-arg \(lBparm...\(rB\(rB \(lBhead...\(rB \
2925 .Bl -column "MacroX" "CallableX" "ParsedX" "closed by XXXX" -offset indent
2952 .Ss Block partial-implicit
2953 Like block full-implicit, but with single-line scope closed by the
2955 .Bd -literal -offset indent
2956 \&.Yo \(lB\-arg \(lBval...\(rB\(rB \(lBbody...\(rB \(lBres...\(rB
2958 .Bl -column "MacroX" "CallableX" "ParsedX" -offset indent
2978 .Sx Block partial-implicit
2983 .Sx In-line .
2984 .Ss Special block macro
2994 .Bl -column "MacroX" "CallableX" "ParsedX" "closed by XXXX" -offset indent
2998 .Ss In-line
3001 In-line macros have only text children.
3005 .Bd -literal -offset indent
3006 \&.Yo \(lB\-arg \(lBval...\(rB\(rB \(lBargs...\(rB \(lBres...\(rB
3008 \&.Yo \(lB\-arg \(lBval...\(rB\(rB \(lBargs...\(rB Yc...
3010 \&.Yo \(lB\-arg \(lBval...\(rB\(rB arg0 arg1 argN
3012 .Bl -column "MacroX" "CallableX" "ParsedX" "Arguments" -offset indent
3094 a zero-width space
3115 .Bl -tag -width Ds -offset indent -compact
3124 .Bl -tag -width Ds -offset indent -compact
3149 Many in-line macros interrupt their scope when they encounter
3163 .Bl -tag -width Ds -offset indent -compact
3174 Appending a zero-width space
3205 .Bl -dash -compact
3220 escapes behave irregularly when specified within line-macro scopes.
3228 .Bl -dash -compact
3240 .Fl literal
3241 does not use a literal font, but is an alias for
3250 Groff does not implement centered and flush-right rendering either,
3264 provides a few tutorial-style pages for beginners, an extensive style
3279 in groff-1.17.