Re: Hyperlinks for source file references

> On 27 Sep 2023, at 15:18, Peter Eisentraut <peter(at)eisentraut(dot)org> wrote:
>
> On 25.09.23 13:09, Daniel Gustafsson wrote:
>> Commit b73c3a11963 introduced <ulink url=xyz><filename>xyz</filename><ulink>
>> hyperlinks for files in the postgres source tree by linking to the gitweb
>> interface at git.postgresql.org. This, IMO, makes the content referred to more
>> accessible, and is especially interesting for README files. The links in
>> question can be found here:
>> https://www.postgresql.org/docs/devel/tableam.html
>> Right now we have ~85 references to source files using <filename /> in the
>> docs, should we convert them to hyperlinks like the ones in the Table AM docs?
>> I would be happy to make a patch that implements this, but I wanted to check
>> here before making the effort to make sure it's not immediately nayed.
>
> A slightly fancier variant that avoids having to hardcode the git web URL pattern in a bunch of places:
>
> You mark it up like
>
> <ulink url="file://src/include/access/tableam.h" type="pgsrc"/>
>
> and then write a bit of XSL to process that into whatever form you want.

Ah yes, thats a neater version. Since noone objected to the idea I will go
hack up an attempt at this to share.

--
Daniel Gustafsson