bugGNU roff - Bugs: bug #64087, more explicitly document...

 
 

bug #64087: more explicitly document transition onto first page

Submitter:  Dave <barx>
Submitted:  Fri 21 Apr 2023 08:34:32 PM UTC
   
 
Category:  Core Severity:  2 - Minor
Item Group:  Documentation Status:  None
Privacy:  Public Assigned to:  None
Open/Closed:  Open Planned Release:  None
* Mandatory Fields

Post a Comment

Add a New Comment Rich Markup
   

Discussion

Fri 21 Apr 2023 08:34:32 PM UTC, original submission:  

Bug #63777 documented this for most cases real users will care about, but Branden brought up a situation Obfuscated Coders may need to know about (see comment 3 over there).  The rest of this is his words, lightly redacted to remove an Heirloom troff oddity that has no bearing here:

A horizontal motion of zero length ... is output, and I would expect it to cause a page transition if one is in the twilight zone.  And it does.


$ cat ATTIC/h.roff
.tm 1: nl=\n(nlu
\h'0'
.tm 2: nl=\n(nlu
.pl \n(nlu
$ nroff ATTIC/h.roff >/dev/null # groff 1.22.4
1: nl=-1u
2: nl=0u

I think the manual, as it gets on toward the end of the formatter reference (currently, chapter 5), needs to start discussing the distinction between formatter instructions that change the environment, those that produce output, and those that do neither (register, string, macro definitions and manipulation).

Eventually this background will better prepare the advanced groff reader to grapple with the internal "node" concept.

Dave <barx>
Group Member

 

Attached Files

This item currently has no attached files.

(Note: upload size limit is set to 4.0MiB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

 

Dependencies

This item does not depend on any other items.

No items depend on this one.

 

Mail Notification Carbon-Copy List

Carbon-Copy List
  • -email is unavailable- added by barx (Submitted the item)
  •  

    Votes

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only logged-in users can vote.

     

    Please enter the title of George Orwell's famous dystopian book (it's a date):

    History

    No changes have been made to this item

    Back to the top

    Powered by Savane 3.16-a7ba.
    Corresponding source code