partial documentation builds

Here is a tip for building the documentation faster during development.
With the new toolchain, you can build only a part of the documentation,
like this:

make html XSLTPROCFLAGS='--stringparam rootid pageinspect'

where "pageinspect" is some XML id (see the top of pageinspect.sgml in
this example). This will build only that part of the documentation,
which is much faster than the full build, but still in the proper
context so that links and section numbering work correctly.

Here is an example of integrating this into an editor:

(defun top-level-id ()
"Return top-level XML/SGML id"
(save-excursion
(goto-char (point-min))
(if (re-search-forward "^<[a-z0-9]+ id=\"\\([a-z-]+\\)\"")
(match-string 1))))

(defun compile-html-of-this ()
(interactive)
(let ((id (top-level-id)))
(when id
(compile (format "make html XSLTPROCFLAGS='--stringparam rootid
%s'" id)))))

(defun browse-html-of-this ()
(interactive)
(let ((id (top-level-id)))
(when id
(browse-url-of-file (concat (file-name-directory buffer-file-name)
"html/" id ".html")))))

--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services