Because new keywords have been added since the original manuals were written, some of the examples may not work any
longer,such as this:
(in the files known to me as userguide.ps or admin.html)
> This query lists all binary operators.
>
> SELECT o.oprname AS binary_op,
> left.typname AS left_opr,
> right.typname AS right_opr,
> result.typname AS return_type
> FROM pg_operator o, pg_type left, pg_type right, pg_type result
> WHERE o.oprkind = 'b' -- binary
> and o.oprleft = left.oid
> and o.oprright = right.oid
> and o.oprresult = result.oid
> ORDER BY left_opr, right_opr;
It works after replacing 'left' with 'l' and right with 'r'.
Since you are moving your docs to SGML, I would propose using a special data element (tag), or processing instruction,
forexamples. It can be used by an application to extract all example code and verify it together with the regression
tests.That will encourage documentation maintainers to keep examples consistent with the changes in the backend.
--Gene