doc: Clarify documentation page header customization code

The customization overrode the fast-forward code with its custom Up
link.  So this is no longer really the fast-forward feature, so we might
as well turn that off and override the non-ff template instead, thus
removing one mental indirection.

Fix the wrong column span declaration.

Clarify and update the documentation.

diff --git a/doc/src/sgml/stylesheet.dsl b/doc/src/sgml/stylesheet.dsl
index 29e885d1c8cec25d014d6ffb6e9e8d031b067ad0..b4c8f1fd5af9f9a74bb97f221d50f440861522b5 100644 (file)
--- a/doc/src/sgml/stylesheet.dsl
+++ b/doc/src/sgml/stylesheet.dsl
@@ -193,7 +193,6 @@
 (define %use-id-as-filename%    #t)
 (define %stylesheet%            (if website-stylesheet "http://www.postgresql.org/media/css/docs.css" "stylesheet.css"))
 (define %graphic-default-extension% "gif")
-(define %gentext-nav-use-ff%    #t)
 (define %body-attr%             '())
 (define ($generate-book-lot-list$) '())
 (define use-output-dir          #t)
@@ -283,14 +282,17 @@
         (empty-sosofo))))
 
 
-;; Customization of header, add title attributes (overrides
-;; dbcommon.dsl)
-(define (default-header-nav-tbl-ff elemnode prev next prevsib nextsib)
+;; Customization of header
+;; - make title a link to the home page
+;; - add tool tips to Prev/Next links
+;; - add Up link
+;; (overrides dbnavig.dsl)
+(define (default-header-nav-tbl-noff elemnode prev next prevsib nextsib)
   (let* ((r1? (nav-banner? elemnode))
          (r1-sosofo (make element gi: "TR"
                           (make element gi: "TH"
                                 attributes: (list
-                                             (list "COLSPAN" "5")
+                                             (list "COLSPAN" "4")
                                              (list "ALIGN" "center")
                                              (list "VALIGN" "bottom"))
                                 (make element gi: "A"