Re: Official Windows Installer and Documentation

On Wed, Jul 27, 2022 at 09:28:51PM -0700, David G. Johnston wrote:
> On Wed, Jul 27, 2022 at 8:22 PM Tom Lane <tgl@sss.pgh.pa.us> wrote:
> 
>     I wrote:
>     > If EDB isn't adequately filling in the documentation for the behavior
>     > of their packaging, that's on them.
> 
>     Having now looked more closely at the pg_upgrade documentation,
>     I don't think this is exactly EDB's fault; it's text that should
>     never have been there to begin with.  ISTM we need to simply rip out
>     lines 431..448 of pgupgrade.sgml, that is all the Windows-specific
>     text starting with
> 
>          For Windows users, you must be logged into an administrative account,
>     and
> 
>     That has got nothing to recommend it: we do not generally provide
>     platform-specific details in these man pages, and to the extent it
>     provides details, those details are likely to be wrong.
> 
> 
> I mean, we do provide platform-specific details/examples, it's just that
> platform is a source installed Linux platform (though pathless)
> 
> Does the avoidance of dealing with other platforms also apply to NET STOP or do
> you find that an acceptable variance?  Or are you suggesting that basically all
> O/S commands should be zapped?  If not, then rewriting 442 to 446 to just be
> the command seems worthwhile.  I'd say pg_upgrade warrants an examples section
> like pg_basebackup has (though obviously pg_upgrade is procedural).

I have developed the attached patch to remove RUNAS and SET PATH,
neither of which appear anywhere else in our docs.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.