[bug #63777] explicitly document transition onto first page

[G. Branden Robinson]

Follow-up Comment #10, bug #63777 (project groff):

Okay, try this.  This does a better job, I think, of confronting the common
cases first and the long tail(s) later.


 @cindex @code{trf} request, causing implicit break
-A break updates the drawing position per the page offset, indentation,
-vertical spacing, and page length, interrupting filling.  Various ways
-of causing breaks were shown in @ref{Breaking}.  The @code{br} request
-likewise causes a break.  A break is implied by several other
-requests:@: @code{bp}, @code{ce}, @code{cf}, @code{fi}, @code{fl},
+When an output line is pending (see below), a break moves the drawing
+position to the beginning of the next text baseline, interrupting
+filling.  Various ways of causing breaks were shown in @ref{Breaking}.
+The @code{br} request likewise causes a break.  Several other requests
+imply breaks:@: @code{bp}, @code{ce}, @code{cf}, @code{fi}, @code{fl},
 @code{in}, @code{nf}, @code{rj}, @code{sp}, @code{ti}, and @code{trf}.
 If the no-break control character is used with any of these requests,
 GNU @code{troff} suppresses the break; instead the requested operation
 takes effect at the next break.  @samp{'br} does nothing.
 
 @Example
 .ll 55n
 This line is normally filled and adjusted.
 .br
 A line's alignment is decided
 'ce \" Center the next input line (no break).
 when it is output.
 This line returns to normal filling and adjustment.
     @result{} This line is normally filled and adjusted.
     @result{}    A line's alignment is decided when it is output.
     @result{} This line returns to normal filling and adjustment.
 @endExample
 
 @noindent
 @cindex pending output line
 @cindex partially collected line
 Output line properties like page offset, indentation, and adjustment are
 not determined until the line has been broken.  An output line is said
 to be @dfn{pending} if some input has been collected but an output line
 corresponding to it has not yet been written; such an output line is
 also termed @dfn{partially collected}.  If no output line is pending, it
 is as if a break has already happened; additional breaks, whether
-explicit or implicit, have no effect.
+explicit or implicit, have no effect.@footnote{If the vertical drawing
+position is negative---as it is when the formatter starts up---a break
+starts a new page (even if no output line is pending) unless an
+end-of-input macro is being interpreted.  @xref{End-of-input Traps}.}




    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?63777>

_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/