bugGNU roff - Bugs: bug #64315, [mm] document `LT SB` indentation...

 
 

bug #64315: [mm] document `LT SB` indentation difference from DWB 3.3 mm

Submitter:  G. Branden Robinson <gbranden>
Submitted:  Sun 18 Jun 2023 02:27:43 AM UTC
   
 
Category:  Macro package mm Severity:  2 - Minor
Item Group:  Documentation Status:  Fixed
Privacy:  Public Assigned to:  gbranden
Open/Closed:  Closed Planned Release:  1.24.0
* Mandatory Fields

Add a New Comment Rich Markup
   

Thu 17 Aug 2023 12:48:47 PM UTC, comment #2: 


commit b8d906c229e368ebe9951da1b50e7236c54ac758
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Thu Aug 17 06:31:25 2023 -0500

    [mm]: Fix Savannah #64315 (documentation).

    * contrib/mm/groff_mm.7.man: Document difference from DWB mm in
      paragraph indentation for semi-blocked letter style.  Correct
      mischaracterization of it in `LT` macro descriptions.

    Fixes <https://savannah.gnu.org/bugs/?64315>.


G. Branden Robinson <gbranden>
Group administrator
Thu 17 Aug 2023 11:24:23 AM UTC, comment #1: 

I got this pretty wrong.

  • groff mm really does use a paragraph indentation of "5", not just for semi-blocked letters, but all letters, where first-line indentations are used at all.


  • The `Pi` register is dimensionless but always interpreted in units of ens.  I misinterpreted the package's source code.


  • This difference between DWB mm and groff mm could be documented, but isn't as such.  If you know the DWB 3.3 manual really well, and read the "Internals" section of groff_mm(7), you could figure it out.


We could be less coy, and that is all that I aim to do now with this ticket.

G. Branden Robinson <gbranden>
Group administrator
Sun 18 Jun 2023 02:27:43 AM UTC, original submission:  

This feature is a mess.

  • The DWB 3.3 mm manual says that paragraphs of semi-blocked letters (`.LT SB`) get a first-line indentation of 3 ens.
  • groff_mm(7) says they get 5 ens.
  • groff mm's actual implementation uses 5 ems (twice as much as documented).


Finally, I wonder why in the hell it didn't occur to anyone to just use the amount stored in the `Pi` register, so the user could configure it.

G. Branden Robinson <gbranden>
Group administrator

 

(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 gbranden (Submitted the item)
  •  

    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.

     

    Follow 9 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2023-08-17 gbranden StatusIn Progress Fixed
        Open/ClosedOpen Closed
        Planned ReleaseNone 1.24.0
    2023-08-17 gbranden Summary[mm] semi-blocked letter style uses wrong, hard-coded paragraph indentation [mm] document `LT SB` indentation difference from DWB 3.3 mm
    2023-08-17 gbranden Severity3 - Normal 2 - Minor
        Item GroupFeature change Documentation
        StatusNone In Progress
        Assigned toNone gbranden
    2023-06-22 gbranden Summary[mm]: semi-blocked letter style uses wrong, hard-coded paragraph indentation [mm] semi-blocked letter style uses wrong, hard-coded paragraph indentation

    Back to the top

    Powered by Savane 3.13-4b48.
    Corresponding source code