[bug #64018] [man, mdoc] decide on a common base paragraph indentation

[G. Branden Robinson]

Update of bug #64018 (project groff):

                  Status:               Need Info => Confirmed              

    _______________________________________________________

Follow-up Comment #19:

Alex's case of cringe at my `is_family_valid` function has been raised on the
_groff_ development list.

https://lists.gnu.org/archive/html/groff/2023-08/msg00008.html
https://lists.gnu.org/archive/html/groff/2023-08/msg00009.html

It is off-topic for this ticket; let's please discuss `lengthof` elsewhere.

Let me update my intentions from comment #5 as follows.


This ticket contemplates two new registers for man(7), and restricted    
meaning for the `IN` register, first exposed/documented by Documenter's  
Workbench (DWB) 1.0 in 1984.                                             
                                                                         
* BP: base paragraph indentation configures how far the left margin of   
  a normal paragraph is inset from the page offset (which is 0 on        
  terminals) to which relative insets are added.  Default: 5n.           
  Currently, `IN` is used for this purpose as well as `RS`.              
                                                                         
* IN: the "standard indentation" would now configure only the default    
  indentation increment used for relative inset.  Default: 7n/7.2n (no   
  change).                                                               
                                                                         
* TS: the "tag spacing" configures the size the of the gap that is       
  required after a paragraph tag.  This amount is added to the width of  
  the diversion created by the `IP` and `TP` macros to format the tag.   
  If that amount is greater than the standard indentation, a break is    
  emitted and the remainder of the paragraph is formatted starting on a  
  new output line, indented by the `IN` increment.  Default: 2n.         
  Currently, a value of 1n is used for this purpose.  (In groff 1.23.0,  
  it's stored in the internal `an-tag-separation` register, but not      
  readily user-configurable.)                                            
                                                                         
For consistent rendering of mdoc(7) pages, these parameters (if set)     
would be honored by that macro package too, as `SN` and `IN` already     
are, where comparable macro semantics permit.




    _______________________________________________________

Reply to this item at:

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

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