Date: Thu, 2 Aug 2001 18:48:38 -0700 (PDT) From: Peter Johnson <freebsd@bilogic.org> To: freebsd-gnats-submit@freebsd.org Subject: docs/29403: niceheaders problems with index, pdf bookmarks Message-ID: <200108030148.f731mck77350@freefall.freebsd.org>
index | next in thread | raw e-mail
>Number: 29403
>Category: docs
>Synopsis: niceheaders problems with index, pdf bookmarks
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Thu Aug 02 18:50:01 PDT 2001
>Closed-Date:
>Last-Modified:
>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:
The new niceheaders feature in doc/en_US.ISO8859-1/share/sgml/freebsd.dsl has a few minor problems: the new rule generation is incorrect for index generation (as the rule overwrites the second column of the first index page), and if you try to generate a PDF with bookmarks, an extra bookmark is added for every chapter, the index, and the glossary (the bookmark is blank for the index and glossary and "Chapter X" for chapters).
One caveat: I haven't tried reproducing these problems with the handbook, but I've noticed them in my own documentation project that I'm using the FreeBSD stylesheets for.
>How-To-Repeat:
1) Use NICE_HEADERS and GEN_INDEX together.
2) Generate PDF with bookmarks support.
>Fix:
apply the following patch to /doc/en_US.ISO8859-1/share/sgml/freebsd.dsl:
(the first section fixes the PDF bookmarks problem, the second fixes the niceheaders/index problem:
--- freebsd.dsl.orig Thu Aug 2 20:38:52 2001
+++ freebsd.dsl Thu Aug 2 20:33:48 2001
@@ -110,7 +110,7 @@
start-indent: 0pt
first-line-start-indent: 0pt
quadding: %component-title-quadding%
-; heading-level: (if %generate-heading-level% 1 0)
+ heading-level: (if %generate-heading-level% 1 0)
keep-with-next?: #t
(if (string=? (element-label) "")
@@ -154,13 +154,11 @@
(make sequence
(process-node-list subtitles))))
- (if (equal? (gi) (normalize "index"))
- (empty-sosofo)
- (make rule
- length: 475pt
- display-alignment: 'start
- space-before: (* (HSIZE 5) %head-before-factor%)
- line-thickness: 0.5pt)))))
+ (make rule
+ length: 475pt
+ display-alignment: 'start
+ space-before: (* (HSIZE 5) %head-before-factor%)
+ line-thickness: 0.5pt))))
(element authorgroup
(empty-sosofo))
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200108030148.f731mck77350>