pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Jonathan S. Katz <jkatz@postgresql.org>
To: Bruce Momjian <bruce@momjian.us>
Cc: Brb815@g.harvard.edu
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Include rust as an externally maintained procedural language
Date: Mon, 21 Aug 2023 23:35:15 -0400
Message-ID: <a22266a0-5067-a7cf-92b8-8b25aae48284@postgresql.org> (raw)
In-Reply-To: <ZNe3IFHZ3Udj8/Uz@momjian.us>
References: <169177958824.635.11087800083040275266@wrigleys.postgresql.org>
	<2e5ca697-a6a8-7d9a-0a2b-9c69dc3d59b4@postgresql.org>
	<ZNe3IFHZ3Udj8/Uz@momjian.us>

On 8/12/23 12:45 PM, Bruce Momjian wrote:
> On Fri, Aug 11, 2023 at 05:05:48PM -0400, Jonathan Katz wrote:
>> On 8/11/23 2:46 PM, PG Doc comments form wrote:

>>> Considering the increasing support and stability for PL/Rust, it should be
>>> referenced within Postgresql's docs [1].
>>
>> There's an up-to-date list of the different PL's in on this page in the
>> wiki:
>>
>> https://wiki.postgresql.org/wiki/PL_Matrix
>>
>> Similar to this thread[1], I wonder if we just link to the wiki from the
>> documentation, given it will be easier to maintain the list from there.
> 
> Makes sense.

Please see attached patch that does exactly this. It follows similar 
semantics as [1].

Thanks,

Jonathan

[1] 
https://www.postgresql.org/message-id/flat/169165415312.635.10247434927885764880%40wrigleys.postgres...


diff --git a/doc/src/sgml/external-projects.sgml b/doc/src/sgml/external-projects.sgml
index 2d0fd723b2..57b47f7a75 100644
--- a/doc/src/sgml/external-projects.sgml
+++ b/doc/src/sgml/external-projects.sgml
@@ -170,58 +170,18 @@
   <para>
    In addition, there are a number of procedural languages that are developed
    and maintained outside the core <productname>PostgreSQL</productname>
-   distribution. <xref linkend="pl-language-table"/> lists some of these
-   packages. Note that some of these projects might not be released under the same
-   license as <productname>PostgreSQL</productname>. For more information on each
-   procedural language, including licensing information, refer to its website
+   distribution. A list of
+   <ulink url="https://wiki.postgresql.org/wiki/PL_Matrix">procedural languages</ulink>
+   is maintained on the PostgreSQL wiki. Note that some of these projects are
+   not released under the same license as <productname>PostgreSQL</productname>.
+   For more information on each procedural language, including licensing
+   information, refer to its website
    and documentation.
   </para>
 
-  <table id="pl-language-table">
-   <title>Externally Maintained Procedural Languages</title>
-
-   <tgroup cols="3">
-    <thead>
-     <row>
-      <entry>Name</entry>
-      <entry>Language</entry>
-      <entry>Website</entry>
-     </row>
-    </thead>
-
-    <tbody>
-     <row>
-      <entry>PL/Java</entry>
-      <entry>Java</entry>
-      <entry><ulink url="https://tada.github.io/pljava/"></ulink></entry;
-     </row>
-
-     <row>
-      <entry>PL/Lua</entry>
-      <entry>Lua</entry>
-      <entry><ulink url="https://github.com/pllua/pllua-ng"></ulink></entry;
-     </row>
-
-     <row>
-      <entry>PL/R</entry>
-      <entry>R</entry>
-      <entry><ulink url="https://github.com/postgres-plr/plr"></ulink></entry;
-     </row>
-
-     <row>
-      <entry>PL/sh</entry>
-      <entry>Unix shell</entry>
-      <entry><ulink url="https://github.com/petere/plsh"></ulink></entry;
-     </row>
-
-     <row>
-      <entry>PL/v8</entry>
-      <entry>JavaScript</entry>
-      <entry><ulink url="https://github.com/plv8/plv8"></ulink></entry;
-     </row>
-    </tbody>
-   </tgroup>
-  </table>
+  <para>
+   <ulink url="https://wiki.postgresql.org/wiki/PL_Matrix"></ulink;
+  </para>
  </sect1>
 
  <sect1 id="external-extensions">


Attachments:

  [text/plain] docs-pl-wiki.patch (2.3K, ../a22266a0-5067-a7cf-92b8-8b25aae48284@postgresql.org/2-docs-pl-wiki.patch)
  download | inline diff:
diff --git a/doc/src/sgml/external-projects.sgml b/doc/src/sgml/external-projects.sgml
index 2d0fd723b2..57b47f7a75 100644
--- a/doc/src/sgml/external-projects.sgml
+++ b/doc/src/sgml/external-projects.sgml
@@ -170,58 +170,18 @@
   <para>
    In addition, there are a number of procedural languages that are developed
    and maintained outside the core <productname>PostgreSQL</productname>
-   distribution. <xref linkend="pl-language-table"/> lists some of these
-   packages. Note that some of these projects might not be released under the same
-   license as <productname>PostgreSQL</productname>. For more information on each
-   procedural language, including licensing information, refer to its website
+   distribution. A list of
+   <ulink url="https://wiki.postgresql.org/wiki/PL_Matrix">procedural languages</ulink>
+   is maintained on the PostgreSQL wiki. Note that some of these projects are
+   not released under the same license as <productname>PostgreSQL</productname>.
+   For more information on each procedural language, including licensing
+   information, refer to its website
    and documentation.
   </para>
 
-  <table id="pl-language-table">
-   <title>Externally Maintained Procedural Languages</title>
-
-   <tgroup cols="3">
-    <thead>
-     <row>
-      <entry>Name</entry>
-      <entry>Language</entry>
-      <entry>Website</entry>
-     </row>
-    </thead>
-
-    <tbody>
-     <row>
-      <entry>PL/Java</entry>
-      <entry>Java</entry>
-      <entry><ulink url="https://tada.github.io/pljava/"></ulink></entry>
-     </row>
-
-     <row>
-      <entry>PL/Lua</entry>
-      <entry>Lua</entry>
-      <entry><ulink url="https://github.com/pllua/pllua-ng"></ulink></entry>
-     </row>
-
-     <row>
-      <entry>PL/R</entry>
-      <entry>R</entry>
-      <entry><ulink url="https://github.com/postgres-plr/plr"></ulink></entry>
-     </row>
-
-     <row>
-      <entry>PL/sh</entry>
-      <entry>Unix shell</entry>
-      <entry><ulink url="https://github.com/petere/plsh"></ulink></entry>
-     </row>
-
-     <row>
-      <entry>PL/v8</entry>
-      <entry>JavaScript</entry>
-      <entry><ulink url="https://github.com/plv8/plv8"></ulink></entry>
-     </row>
-    </tbody>
-   </tgroup>
-  </table>
+  <para>
+   <ulink url="https://wiki.postgresql.org/wiki/PL_Matrix"></ulink>
+  </para>
  </sect1>
 
  <sect1 id="external-extensions">


  [application/pgp-signature] OpenPGP_signature (839B, ../a22266a0-5067-a7cf-92b8-8b25aae48284@postgresql.org/3-OpenPGP_signature)
  download

view thread (6+ messages)  latest in thread

Message-ID: <a22266a0-5067-a7cf-92b8-8b25aae48284@postgresql.org>
Permalink:  ../a22266a0-5067-a7cf-92b8-8b25aae48284@postgresql.org/
Also on:    postgresql.org/message-id/a22266a0-5067-a7cf-92b8-8b25aae48284@postgresql.org

 ·  · 

reply

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 using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: jkatz@postgresql.org, bruce@momjian.us, Brb815@g.harvard.edu, pgsql-docs@lists.postgresql.org
  Subject: Re: Include rust as an externally maintained procedural language
  In-Reply-To: <a22266a0-5067-a7cf-92b8-8b25aae48284@postgresql.org>

* 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