bugGNU roff - Bugs: bug #66000, [mm] early .CS call makes top page...

 
 

bug #66000: [mm] early .CS call makes top page margin wrong thereafter

Submitter:  Dave <barx>
Submitted:  Wed 17 Jul 2024 03:59:59 PM UTC
   
 
Category:  Macro package mm Severity:  2 - Minor
Item Group:  Incorrect behaviour 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

Sat 27 Jul 2024 07:08:05 AM UTC, comment #4: 

original submission:

> * "Judging by the DWB 3.3 troff manual, this looks like the way the `SG` macro is supposed to work for memorandum type 0.  Memorandum type 4 should redefine it to be a no-op.  groff mm's implementation evidently doesn't."
> ** This looks like it was addressed by commit 774bac73c.


There were two parts to the fix.  The machinery, which you cited above, and the exercise thereof:


commit ad8cd89d4a9be3ca42b25399cff67ae2bb7aaf51
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Thu Jun 13 15:04:13 2024 -0500

    [mm]: Adjust memorandum type 4 cosmetics.

    * contrib/mm/mm/4.MT: Revise to more closely approximate DWB 3.3 troff
      output.  Initialize `let*sg-suppress-all` and `let*ns-suppress` true.

      (cov@print-title): Set document title closer to where DWB 3.3 puts it.
      Stop turning on fill mode unnecessarily.  It should already be on at
      the start of a document.  Save and restore adjustment mode instead of
      clobbering it.

      (cov@print-authors): Space by a full vee mode, before and after
      setting authors in nroff mode, since most nroff devices are incapable
      of the half-line motions used in troff mode.

      (cov@print-firm): Space by two vees before setting the document's
      affiliated firm name.

      (cov@print-abstract): Use mm macros instead of formatter requests to
      change fonts.


G. Branden Robinson <gbranden>
Group administrator
Fri 26 Jul 2024 04:07:29 AM UTC, comment #3: 

comment #1:

> I was planning to add an `AFX` macro to permit override of the formatting of the "affiliated firm" header.  Historical practice is crazily divergent, being an obvious site for the "Cornflower Blue Icon Effect".


This, while not quite the topic of this ticket, is done.


commit 54b2b3a8c7871ba36f0fa07118fa7a328c7b8e35
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sun Jul 21 12:36:00 2024 -0500

    [mm]: Recognize an `AFX` hook macro.

    * contrib/mm/mm/0.MT:
    * contrib/mm/mm/4.MT:
    * contrib/mm/mm/ms.cov: Call `AFX` hook macro if defined, instead of
      default formatting of affiliated firm.
    * contrib/mm/groff_mm.7.man (Macros) <AFX>: Document facility.


G. Branden Robinson <gbranden>
Group administrator
Wed 17 Jul 2024 05:33:50 PM UTC, comment #2: 

comment #1:

> Base-10, represent!


1493021!   [converted from base 36]

(Who's that across the room yelling "NERDS!"?)

Dave <barx>
Group Member
Wed 17 Jul 2024 04:22:02 PM UTC, comment #1: 

Thanks, Dave.  And congratulations on the nice round ticket number.  Base-10, represent!

The margin issue bears investigating.

I was planning to add an `AFX` macro to permit override of the formatting of the "affiliated firm" header.  Historical practice is crazily divergent, being an obvious site for the "Cornflower Blue Icon Effect".

G. Branden Robinson <gbranden>
Group administrator
Wed 17 Jul 2024 03:59:59 PM UTC, original submission:  

A post to the email list in early March (http://lists.gnu. ... -03/msg00001.html) identified some bugs and possible bugs in -mm.  This macro package has seen a huge number of changes since then, so it's hard to identify what might have already been addressed.  But here's my stab at it.

  • "Judging by the DWB 3.3 troff manual, this looks like the way the `SG` macro is supposed to work for memorandum type 0.  Memorandum type 4 should redefine it to be a no-op.  groff mm's implementation evidently doesn't."


  • "moving the `CS` macro call earlier, right after `MT`, did not produce the results I expected; the abstract did not appear on the cover page.  However, checking it against Heirloom and that formatter's ancestor DWB 3.3 troff, I see that that appears to be consistent with historical practice.  (It still may be a bug, however.)"
    • This seems to be an open question.


  • "Another problem I get when relocating the `CS` call early in the document is that the top page margin is wrong thereafter.  DWB and Heirloom don't mess that up so it looks like a groff mm bug to me."
    • If this has been done, I can't identify it: No contrib/mm/m.tmac commit messages of 2024 mention either CS or margins.


  • "If I add an `AF` call to the document, I get appropriate results with groff mm but not DWB or Heirloom--they're 'stuck' with the default.  While a difference, I do not consider this a bug in groff mm.  It may be a difference worth noting in the groff_mm(7) man page, however."
    • Appears not to have been done: the entirety of the text about .AF in groff_mm(7) is, "Specify a memorandum's organizational affiliation.  At most one can be declared; org-name is used by memorandum types and available to cover sheets."  However, the "may" above implies "or may not," so this is also a potentially open question.


I've based this bug report's summary on the .CS issue that seems a clear and unresolved bug.  The two maybes above could potentially be swept up here also, or I can open separate reports for them if that seems warranted.  I'm adding the original reporter of these problems to the cc.

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 gbranden (Posted a comment)
  • -email is unavailable- added by barx (Submitted the item)
  • -email is unavailable- added by barx (Original reporter)
  •  

    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

    Follows 1 latest change.

    Date Changed by Updated Field Previous Value => Replaced by
    2024-07-17 barx Carbon-Copy- Added -email is unavailable-

    Back to the top

    Powered by Savane 3.16-a7ba.
    Corresponding source code