RE: Psql meta-command conninfo+

Maiquel Grassi <grassi@hotmail.com.br>

From: Maiquel Grassi <grassi@hotmail.com.br>
To: "Imseih (AWS), Sami" <simseih@amazon.com>, Alvaro Herrera <alvherre@alvh.no-ip.org>
Cc: Nathan Bossart <nathandbossart@gmail.com>, Jim Jones <jim.jones@uni-muenster.de>, Pavel Luzanov <p.luzanov@postgrespro.ru>, Erik Wienhold <ewie@ewie.name>, "pgsql-hackers@postgresql.org" <pgsql-hackers@postgresql.org>
Date: 2024-04-04T14:34:20Z
Lists: pgsql-hackers

Attachments

Building the docs fail for v26. The error is:



ref/psql-ref.sgml:1042: element member: validity error : Element term is not declared in member list of possible children

         </member>

                  ^



I am able to build up to v24 before the <para> was replaced with <listitem><member>



I tested building with a modified structure as below; the <listitem> is a <para>

that has a <simplelist> within it.  Each field is a simple list member and

the the name of the fields should be <literal>.



      <varlistentry id="app-psql-meta-command-conninfo">

       <term><literal>\conninfo[+]</literal></term>

       <listitem>

       <para>

        Outputs a string displaying information about the current

        database connection. When <literal>+</literal> is appended,

        more details about the connection are displayed in table

        format:

       <simplelist>

       <member><literal>Database:</literal>The database name of the connection.</member>

       <member><literal>Authenticated User:</literal>The authenticated database user of the connection.</member>

       <member><literal>Current User:</literal>The user name of the current execution context;

          see the <function>current_user()</function> function in

          <xref linkend="functions-info-session-table"/> for more details.</member>

       </simplelist>

       </para>

       </listitem>

      </varlistentry>

---//---

Hi Sami!
(v27)
I made the adjustment in the documentation.
Thank you for the time dedicated to this feature.
Regards,
Maiquel Grassi.

Commits

  1. psql: Change new \conninfo to use SSL instead of TLS

  2. Change \conninfo to use tabular format

  3. Update extension lookup routines to use the syscache

  4. Improve COPY TO performance when server and client encodings match

  5. doc: Remove superfluous bracket in synopsis

  6. Remove psql support for server versions preceding 9.2.