From: Bruce Momjian <bruce@momjian.us>
To: Philip Semanchuk <philip@americanefficient.com>
Cc: Ben Hancock <lists@benghancock.com>
Cc: PostgreSQL-General <pgsql-general@lists.postgresql.org>
Subject: Re: Local postgres manual
Date: Fri, 3 Nov 2023 09:45:52 -0400
Message-ID: <ZUT5kPLotZCs6IuZ@momjian.us> (raw)
In-Reply-To: <9A7961AB-A40A-4E06-9F9F-A2D96BBDE5D3@americanefficient.com>
References: <c1e0067d-ab06-2bde-2ea9-9ace478a1191@benghancock.com>
<9A7961AB-A40A-4E06-9F9F-A2D96BBDE5D3@americanefficient.com>
On Fri, Nov 3, 2023 at 09:39:46AM -0400, Philip Semanchuk wrote:
>
>
> > On Nov 3, 2023, at 9:18 AM, Ben Hancock <lists@benghancock.com> wrote:
> >
> > Hi all:
> >
> > Does Postgres come with a local, full version of the manual installed
> > by default anywhere (i.e. akin to what is available on the website, but
> > in man, info, or plain-text format)? When I invoke `man postgres`, I do
> > get a very useful - but limited - manual page, which has references to chapters. For example:
> >
> > OPTIONS
> > postgres accepts the following command-line arguments. For a
> > detailed discussion of the options consult Chapter 20. ...
> >
> > Of course, I can pull up a browser and find the manual, or consult a
> > local PDF if I have a graphical display. But sometimes it may be convenient to view the the manual for the version of Postgres that is on the system, right there. Does one exist?
>
> In addition to Bruce Momjian’s suggestion, I’ll add that you can make an HTML version of the manual from the source code. This is what I use and it works great for me.
Yes, we can do HTML too as a single file, postgres.html. What I don't
see is man page output for anything but the references pages, and as
separate files. It might be possible to convert the HTML to man format
using something like html2man.
--
Bruce Momjian <bruce@momjian.us> https://momjian.us
EDB https://enterprisedb.com
Only you can decide what is important to you.
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients from your mail client; the link fills in
the headers below: reply via email
Some clients, webmail especially, drop In-Reply-To and References from
a link, and the reply then starts a new thread: use the mbox below.
To: pgsql-general@postgresql.org
Cc: bruce@momjian.us, philip@americanefficient.com, lists@benghancock.com
Subject: Re: Local postgres manual
In-Reply-To: <ZUT5kPLotZCs6IuZ@momjian.us>
References: <c1e0067d-ab06-2bde-2ea9-9ace478a1191@benghancock.com> <9A7961AB-A40A-4E06-9F9F-A2D96BBDE5D3@americanefficient.com> <ZUT5kPLotZCs6IuZ@momjian.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox