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

4 .\" Copyright (c) 2010-2017 Ingo Schwarze <schwarze@openbsd.org>
109 .Bl -enum
154 Any third-party program using them typically requires adjustments after every
186 .Bl -ohang
207 .Bl -ohang
209 Obtain a text-only representation of a
223 .Bl -tag -offset 5n -width inttype
313 Return a file descriptor open for reading or -1 on failure.
353 .Bl -ohang
377 Strings may be extracted from mdoc and man meta-data, or from text
379 These strings have special non-printing formatting cues embedded in the
384 human-readable text.
385 In general, strings may be assumed to consist of 7-bit ASCII characters.
387 The following non-printing characters may be embedded in text strings:
388 .Bl -tag -width Ds
390 A non-breaking space character.
394 A breakable zero-width space.
401 To construct human-readable text, these should be intercepted with
426 fields) and some type-specific data.
429 where capitalised non-terminals represent nodes.
431 .Bl -tag -width "ELEMENTXX" -compact
433 \(<- mnode+
435 \(<- ELEMENT | TEXT | BLOCK
436 .It BLOCK
437 \(<- HEAD BODY
439 \(<- mnode*
441 \(<- mnode*
443 \(<- ELEMENT | TEXT*
445 \(<- [[:ascii:]]*
449 next-line scope as documented in
456 .Qq In-line
464 nodes with block, head, body, element, root and text types as declared
480 fields) and some type-specific data, in particular, for nodes generated
486 where capitalised non-terminals represent nodes.
488 .Bl -tag -width "ELEMENTXX" -compact
490 \(<- mnode+
492 \(<- BLOCK | ELEMENT | TEXT
493 .It BLOCK
494 \(<- HEAD [TEXT] (BODY [TEXT])+ [TAIL [TEXT]]
496 \(<- TEXT*
498 \(<- mnode*
500 \(<- mnode* [ENDBODY mnode*]
502 \(<- mnode*
504 \(<- [[:ascii:]]*
508 the BLOCK production: these refer to punctuation marks.
509 Furthermore, although a TEXT node will generally have a non-zero-length
511 .Sq \&.Bd \-literal ,
512 an empty line will produce a zero-length string.
514 .Sq \&Bl \-column ,
519 syntax tree accommodates for broken block structures as well.
521 with a given block before the physical end of that block.
522 It has a non-null
528 as the BLOCK it is ending, and has a
530 field pointing to that BLOCK's BODY node.
534 An ENDBODY node is generated when a block ends while one of its child
536 .Bd -literal -offset indent
543 This example results in the following block structure:
544 .Bd -literal -offset indent
545 BLOCK Ao
549         BLOCK Bo, pending -> Ao
554                 ENDBODY Ao, pending -> Ao
561 block extends from TEXT ao to TEXT ac,
564 block extends from TEXT bo to TEXT bc.
571 Support for badly-nested blocks is only provided for backward
575 Using badly-nested blocks is
579 front-end to
582 Furthermore, behaviour when encountering badly-nested blocks is not
584 levels of badly-nested blocks.
601 .An -nosplit