> On Dec 25, 2025, at 17:07, Chao Li <[email protected]> wrote:
>
> Hi Hackers,
>
> This patch is derived from [1]. While reviewing that thread, I noticed that
> when the documentation refers to .h and .cfiles in the PostgreSQL source
> tree, it uses a mix of full source-tree paths and short relative paths. This
> inconsistency can be confusing for future documentation authors, who may be
> unsure which form to use.
>
> This patch aims to make the usage consistent. When the documentation
> explicitly refers to a file’s location in the source tree (for example, “in
> the file …”, "see the file ..."), it uses the full path. When the
> documentation refers to a header in the context of inclusion, it uses the
> short relative path, matching the form used in #include <header> directives.
>
> [1]
> https://postgr.es/m/cahgqgweyyuzz0ljbv_fmcdwu3wgmu0ncot+jjiozpa8dg6e...@mail.gmail.com
>
> Best regards,
> --
> Chao Li (Evan)
> HighGo Software Co., Ltd.
> https://www.highgo.com/
>
>
> <v1-0001-Docs-make-documentation-source-file-references-co.patch>
Added to CF for tracking: https://commitfest.postgresql.org/patch/6380/
Best regards,
--
Chao Li (Evan)
HighGo Software Co., Ltd.
https://www.highgo.com/
