Re: Hyperlinks for source file references

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Hyperlinks for source file references
Date: 2023-09-25 12:27:48
Message-ID: B46D8481-78BF-4002-A822-5C0C878E77A8@yesql.se
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> On 25 Sep 2023, at 14:22, Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org> wrote:
>
> On 2023-Sep-25, Daniel Gustafsson wrote:
>
>> This does of course present a question for the backbranches, pointing to the
>> HEAD version in the docs for a previous major release isn't entirely accurate.
>> On the other hand, we already do that today in the above tableam page so if we
>> don't like that we might as well sort out now what to do about that.
>
> I think you can just change the ;hb=HEAD parameter in the URL to the
> current branch.
>
> https://git.postgresql.org/gitweb/?p=postgresql.git;a=blob;f=src/include/access/tableam.h;hb=REL_12_STABLE
> https://git.postgresql.org/gitweb/?p=postgresql.git;a=blob;f=src/include/access/tableam.h;hb=master
>
> It should be easy to add a line to version.sgml that expands to the
> current branch.

That's a good idea, it would remove any backpatching issues since all links
would be hb=&gitbranch;

--
Daniel Gustafsson

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Erki Eessaar 2023-09-26 09:33:46 JSON type unsupported
Previous Message Alvaro Herrera 2023-09-25 12:22:47 Re: Hyperlinks for source file references