Bug 29657

Summary: NICE_HEADERS conflicts with authorgroup generation
Product: Documentation Reporter: Peter Johnson <freebsd>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Peter Johnson 2001-08-13 03:50:01 UTC 
When NICE_HEADERS=1 is used in combination with a chapter that has a 
chapterinfo section (which triggers the authorgroup stuff), the author
information is placed with parts overlapping the NICE_HEADERS line.  The
problem appears to be caused by no spacing after the NICE_HEADERS rule
output.

Fix: I fixed it by adding a space-after: parameter to the NICE_HEADERS make
rule, as the patch below does.  There's probably a better way to do
this, and this may have unintended side-effects (I haven't tested it
very much).  Plus, I'm not exactly sure what HSIZE # I should use, I
chose 1 arbitrarily.
How-To-Repeat: Combine NICE_HEADERS=1, print output, and a chapter with a chapterinfo
section.
Comment 1 Murray Stokely freebsd_committer freebsd_triage 2001-09-02 22:04:50 UTC 
State Changed
From-To: open->closed

When I added the NICE_HEADERS knob it was under the assumption that 
if the user cares about the output enough to use it, they will almost 
certainly turn off the display of inline author attributions as well. 
In the NICE_HEADERS case I expect that the document preparer will 
collate all of the attributions into an appendix in the back, since 
this has a much more formal look that NICE_HEADERS also tries to 
provide. 

However, I've added variables for the spacebefore and spaceafter of 
the rule that is generated with NICE_HEADERS.  The default spaceafter 
is still 0pt, but you can easily change this in your stylesheet layer 
on top of freebsd.dsl, by editing freebsd.dsl directly, and maybe even 
through a command line option to jade. 

Thanks!