bugGNU troff - Bugs: bug #55060, me: behavior of .ll does not match...

 
 

bug #55060: me: behavior of .ll does not match documentation

Submitted by:  Dave <barx>
Submitted on:  Mon 19 Nov 2018 11:25:30 PM UTC  
 
Category:  Macro - others Severity:  3 - Normal
Item Group:  Incorrect behaviour Status:  None
Privacy:  Public Assigned to:  None
Open/Closed:  Open Planned Release:  None

Add a New Comment (Rich Markup)
   

You are not logged in

Please log in, so followups can be emailed to you.

 

Sun 25 Nov 2018 02:00:59 AM UTC, comment #2: 

> There is a translation error in the manual ("meref.me").


I don't know what this means.  I'm reading meref.me in its original language, English.  I have no evidence it has ever been translated out of and then back into English.  Do you mean "transcription error"?  If so, from what source was the passage in question transcribed, and what is the error that was introduced?

> Get the documentation for troff, "Troff User's Manual", on paper.


I have this document in PDF form.  What would a paper version reveal that I can't see on-screen?

It's also not clear what this manual has to do with the current bug report: the manual documents raw troff, and the bug I'm reporting concerns a macro package.  Can you be more specific about what you think I should be looking at in this manual?

> How does the macro ".ll" influence the line length
> in a new environment (it is issued outside it)?


It doesn't, which is what this bug is reporting.  But if you mean how could it, that's an interesting question that has been discussed on the mailing list, in the post I linked to directly below, and in other posts linked to from there.  Please see the email threads for a fuller answer, but briefly, note that (a) meref.me was originally written when only three environments were available in troff, and this part of meref.me is unchanged since at least 1988; (b) if we decide to change the code to match the documentation, this would almost certainly entail having -me define its own .ev macro (to replace the low-level groff request) that sets line length appropriately upon environment creation.

Dave <barx>
Tue 20 Nov 2018 11:05:26 PM UTC, comment #1: 

  There is a translation error in the manual ("meref.me").

  The file "e.tmac-e" shows:

.rn ll xl \" *** special line length (local)
.de ll \" *** line length (global to environments)

  Get the documentation for troff, "Troff User's Manual", on paper.
The path to the PostScript file is found under "CSTR #54" in the
manuals "groff(7)", "groff_diff(7)", and "groff_out(5)".

  How does the macro ".ll" influence the line length in a new
environment (it is issued outside it)?

Bjarni Ingi Gislason <bjarniig>
Mon 19 Nov 2018 11:25:30 PM UTC, original submission:  

doc/meref.me describes the macro .ll as "Set line length in all environments."  This is not what it does:

groff -me -a <<EOF
.ll 2i
The quick brown fox
jumped over a quick brown fox which
jumped over a quick brown fox which
.ev foo
jumped over a quick brown fox which
jumped over a quick brown fox which
jumped over a quick brown fox which
jumped over a quick brown fox which
.ev
jumped over a quick brown fox which...
EOF

This has been discussed a couple times over the years on the groff email list.  The last post on the topic was mine, which left unresolved questions:

http://lists.gnu.org/archive/html/groff/2013-09/msg00025.html

No clear solution has emerged from these discussions, and I have no further input; I'm just creating this bug report so the issue doesn't get forgotten.

Dave <barx>

 

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

Attach Files:
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

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

    Do you think this task is very important?
    If so, you can add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.

     

     

     

    No changes have been made to this item

    Back to the top


    Powered by Savane 3.5