• Tom Lane's avatar
    Doc: fix "Unresolved ID reference" warnings, clean up man page cross-refs. · 60c90c16
    Tom Lane authored
    Use xreflabel attributes instead of endterm attributes to control the
    appearance of links to subsections of SQL command reference pages.
    This is simpler, it matches what we do elsewhere (e.g. for GUC variables),
    and it doesn't draw "Unresolved ID reference" warnings from the PDF
    toolchain.
    
    Fix some places where the text was absolutely dependent on an <xref>
    rendering exactly so, by using a <link> around the required text
    instead.  At least one of those spots had already been turned into
    bad grammar by subsequent changes, and the whole idea is just too
    fragile for my taste.  <xref> does NOT have fixed output, don't write
    as if it does.
    
    Consistently include a page-level link in cross-man-page references,
    because otherwise they are useless/nonsensical in man-page output.
    Likewise, be consistent about mentioning "below" or "above" in same-page
    references; we were doing that in about 90% of the cases, but now it's
    100%.
    
    Also get rid of another nonfunctional-in-PDF idea, of making
    cross-references to functions by sticking ID tags on <row> constructs.
    We can put the IDs on <indexterm>s instead --- which is probably not any
    more sensible in abstract terms, but it works where the other doesn't.
    (There is talk of attaching cross-reference IDs to most or all of
    the docs' function descriptions, but for now I just fixed the two
    that exist.)
    
    Discussion: https://postgr.es/m/14480.1589154358@sss.pgh.pa.us
    60c90c16
execute.sgml 3.23 KB