From nobody@FreeBSD.org  Sun Aug 12 19:45:12 2001
Return-Path: <nobody@FreeBSD.org>
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id B08F037B405
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 12 Aug 2001 19:45:12 -0700 (PDT)
	(envelope-from nobody@FreeBSD.org)
Received: (from nobody@localhost)
	by freefall.freebsd.org (8.11.4/8.11.4) id f7D2jCX63749;
	Sun, 12 Aug 2001 19:45:12 -0700 (PDT)
	(envelope-from nobody)
Message-Id: <200108130245.f7D2jCX63749@freefall.freebsd.org>
Date: Sun, 12 Aug 2001 19:45:12 -0700 (PDT)
From: Peter Johnson <freebsd@bilogic.org>
To: freebsd-gnats-submit@FreeBSD.org
Subject: NICE_HEADERS conflicts with authorgroup generation
X-Send-Pr-Version: www-1.0

>Number:         29657
>Category:       docs
>Synopsis:       NICE_HEADERS conflicts with authorgroup generation
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Aug 12 19:50:01 PDT 2001
>Closed-Date:    Sun Sep 2 14:04:50 PDT 2001
>Last-Modified:  Sun Sep 02 14:05:21 PDT 2001
>Originator:     Peter Johnson
>Release:        4.3-STABLE
>Organization:
>Environment:
FreeBSD matrix.bilogic.org 4.3-STABLE FreeBSD 4.3-STABLE #6: Sun Jul  1 20:41:50 CDT 2001     peter@matrix.bilogic.org:/usr/obj/usr/src/sys/WORKSTATION  i386

>Description:
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.
>How-To-Repeat:
Combine NICE_HEADERS=1, print output, and a chapter with a chapterinfo
section.
>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.
--- doc/en_US.ISO8859-1/share/sgml/freebsd.dsl	Sun Aug 12 21:11:05 2001
+++ doc/en_US.ISO8859-1/share/sgml/freebsd.dsl.patched	Sun Aug 12 21:42:34 2001
@@ -160,6 +160,7 @@
 	  length: 475pt
 	  display-alignment: 'start
 	  space-before: (* (HSIZE 5) %head-before-factor%)
+	  space-after: (* (HSIZE 1) %head-after-factor%)
 	  line-thickness: 0.5pt)))))
 
       (element authorgroup
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: murray 
State-Changed-When: Sun Sep 2 14:04:50 PDT 2001 
State-Changed-Why:  
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! 


http://www.FreeBSD.org/cgi/query-pr.cgi?pr=29657 
>Unformatted:
