Re: DOCS - System Applications 'datadir' parameter

Andreas Karlsson <andreas@proxel.se>

From: Andreas Karlsson <andreas@proxel.se>
To: Peter Smith <smithpb2250@gmail.com>, PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Date: 2026-02-18T21:29:14Z
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




Commits

  1. doc: make "datadir" argument specification more specific