Re: improve installation short version - Mailing list pgsql-hackers

From Tom Lane
Subject Re: improve installation short version
Date
Msg-id 191920.1622669808@sss.pgh.pa.us
Whole thread Raw
In response to Re: improve installation short version  (Andrew Dunstan <andrew@dunslane.net>)
Responses Re: improve installation short version
List pgsql-hackers
Andrew Dunstan <andrew@dunslane.net> writes:
> On 6/2/21 4:58 PM, Mark Dilger wrote:
>> Prior to where your patch makes changes, the docs say, "If you are building PostgreSQL for Microsoft Windows, read
thischapter if you intend to build with MinGW or Cygwin".  I think going on to tell the users to use `su` is a bit odd.
Does that exist in standard MinGW and Cygwin environments?  I thought "run as" was the Windows option for this. 

> Yes, good point. We should fix that. Yes, "runas" is a sort of su.
> There's no adduser either.

There's a whole lot of Unix systems that don't spell that command
as "adduser", either.  That whole recipe has to be understood as
a guide, not something you can blindly copy-and-paste.

Maybe what we really need is an initial disclaimer saying something
along the lines of "Here's approximately what you need to do; adapt
these commands per local requirements."

And then, perhaps, change the last line to "For more detail, see
the rest of this chapter".

            regards, tom lane



pgsql-hackers by date:

Previous
From: Andrew Dunstan
Date:
Subject: Re: improve installation short version
Next
From: Andrew Dunstan
Date:
Subject: Re: pgsql: Add regression test for recovery pause.