Re: DOCS - System Applications 'datadir' parameter

From: Andreas Karlsson <andreas(at)proxel(dot)se>
To: Peter Smith <smithpb2250(at)gmail(dot)com>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: DOCS - System Applications 'datadir' parameter
Date: 2026-02-18 21:29:14
Message-ID: 34c6b2cc-ff39-4fc3-8cb7-f0e746b3941d@proxel.se
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On 2/18/26 8:27 AM, Peter Smith wrote:
> In most places, each of the Server Application documentation pages [1]
> refers to the directory where the database cluster lives as 'datadir'.
> However, a few places called it 'directory' instead.
>
> This patch changes the outliers also to 'datadir', making everything
> more consistent.

The change looks good!

But I wonder if there isn't an issue with our XML. If you look at
initdb.sgml you will se that there is a space before datadir, but if you
look at e.g. pg_checksums you will then notice a lack of space, both in
the source and the generated HTML, so the space in initdb.sgml was
clearly added for a reason. Do you understand our documentation pipeline
good enough to know why that space seems to be necessary?

https://www.postgresql.org/docs/current/app-pgchecksums.html

Andreas

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Andreas Karlsson 2026-02-18 21:32:29 Re: DOCS - Server Applications [option] should be [option...]
Previous Message Nathan Bossart 2026-02-18 21:26:14 Re: Speed up COPY FROM text/CSV parsing using SIMD