Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps
 (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1mAh4V-00044o-7B
	for pgsql-docs@arkaria.postgresql.org; Mon, 02 Aug 2021 23:10:11 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1mAh4T-0007It-Dd
	for pgsql-docs@arkaria.postgresql.org; Mon, 02 Aug 2021 23:10:09 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <bruce@momjian.us>)
	id 1mAh4T-0007Il-7W
	for pgsql-docs@lists.postgresql.org; Mon, 02 Aug 2021 23:10:09 +0000
Received: from momjian.us ([72.94.173.45])
	by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <bruce@momjian.us>)
	id 1mAh4M-0004OJ-GP
	for pgsql-docs@lists.postgresql.org; Mon, 02 Aug 2021 23:10:08 +0000
Received: from bruce by momjian.us with local (Exim 4.92)
	(envelope-from <bruce@momjian.us>)
	id 1mAh4J-0008Lp-Ea; Mon, 02 Aug 2021 19:09:59 -0400
Date: Mon, 2 Aug 2021 19:09:59 -0400
From: Bruce Momjian <bruce@momjian.us>
To: "David G. Johnston" <david.g.johnston@gmail.com>
Cc: mali_86@outlook.com, Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: psql's commit df9f599b is not documented
Message-ID: <20210802230959.GA7858@momjian.us>
References: <162794046650.25749.16629649309696437240@wrigleys.postgresql.org>
 <CAKFQuwYddkFFAojWojCLjKb8Uq-BEXfX3O6fCPYOAB4SLtn20A@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: 
 <CAKFQuwYddkFFAojWojCLjKb8Uq-BEXfX3O6fCPYOAB4SLtn20A@mail.gmail.com>
User-Agent: Mutt/1.10.1 (2018-07-13)
List-Id: <pgsql-docs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-docs@lists.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-docs>
Archived-At: 
 <https://www.postgresql.org/message-id/20210802230959.GA7858%40momjian.us>
Precedence: bulk

On Mon, Aug  2, 2021 at 03:31:15PM -0700, David G. Johnston wrote:
> On Mon, Aug 2, 2021 at 2:58 PM PG Doc comments form <noreply@postgresql.org>
> wrote:
> 
>     quit and exit commands have been added to psql starting from psql 11
>     through
>     this commit df9f599b
>     https://git.postgresql.org/gitweb/?p=postgresql.git;a=commit;h=
>     df9f599bc6f14307252ac75ea1dc997310da5ba6
>     but it is not documented in psql documentation
> 
> 
> All documented commands begin with a backslash - and indeed \help and \quit are
> the official ways to get help and to quit psql.  While the others exist as a
> courtesy they are "unofficial" and thus we've chosen to not document them.

FYI, this was mentioned in the PG 11 release notes:

       <para>
        Allow <command>quit</command> and <command>exit</command> to
        exit <application>psql</application> when given with no prior input
        (Bruce Momjian)
       </para>

       <para>
        Also print hints about how to exit when <command>quit</command> and
        <command>exit</command> are used alone on a line while the input
        buffer is not empty.  Add a similar hint for <command>help</command>.
       </para>
      </listitem>

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

  If only the physical world exists, free will is an illusion.