> On 27 Sep 2023, at 15:18, Peter Eisentraut <pe...@eisentraut.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



Reply via email to