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 ) id 1pIwx4-0001iP-Q9 for pgsql-hackers@arkaria.postgresql.org; Fri, 20 Jan 2023 19:21:27 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1pIwx3-0002rb-Lf for pgsql-hackers@arkaria.postgresql.org; Fri, 20 Jan 2023 19:21:25 +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 ) id 1pIwx3-0002rK-9M for pgsql-hackers@lists.postgresql.org; Fri, 20 Jan 2023 19:21:25 +0000 Received: from out2-smtp.messagingengine.com ([66.111.4.26]) by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1pIwwz-00063q-TN for pgsql-hackers@lists.postgresql.org; Fri, 20 Jan 2023 19:21:24 +0000 Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.nyi.internal (Postfix) with ESMTP id D99BC5C0129; Fri, 20 Jan 2023 14:21:19 -0500 (EST) Received: from mailfrontend1 ([10.202.2.162]) by compute1.internal (MEProxy); Fri, 20 Jan 2023 14:21:19 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:date:date:feedback-id:feedback-id:from:from :in-reply-to:in-reply-to:message-id:mime-version:reply-to:sender :subject:subject:to:to:x-me-proxy:x-me-proxy:x-me-sender :x-me-sender:x-sasl-enc; s=fm3; t=1674242479; x=1674328879; bh=y HmVtPXOOIHy79XR4x4qw3Ywmh0AHU6D80T5ukPl8MU=; b=gG6zP9zfpiUdMv6a6 JJtF8b62A9ZkrBopD5pZS0H86nzOAWnZY29jReYoLxhO3CST3CLnnwL7TpGWpWal 6z0eTt26Him8Sdpqk/R4cnjmOMIxpsHPSwjgSmkwVqW8hTC0dVItlN4GOrnFh9Mf SLIZrONr8Q8yyK/QBz0fVTf52IMzmFnjWx2PugkvQTJk6ouPd15irlA1hbQRM1vM FdO+cbo04Iy1bTxgCA0eCyMEyT1n3PgBfR79yyS70pngTFL61EFm3D5pf3y7vyg0 5vbKMQyZZ+d0QVMt2QfpslgUXobQB96YE1VNfa0Jz7n+DbrPOsiScyYR2KgQej/i KEp+g== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvhedrudduvddguddviecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmd enucfjughrpeffhffvvefukfggtggugfgjsehmkeerredttdejnecuhfhrohhmpeetlhhv rghrohcujfgvrhhrvghrrgcuoegrlhhvhhgvrhhrvgesrghlvhhhrdhnohdqihhprdhorh hgqeenucggtffrrghtthgvrhhnpeduleekkefgtddttedtkefguddvieffleetgeejiefh teehkeevfeettdduvdfhueenucffohhmrghinhepvghnthgvrhhprhhishgvuggsrdgtoh hmnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomheprghl vhhhvghrrhgvsegrlhhvhhdrnhhoqdhiphdrohhrgh X-ME-Proxy: Feedback-ID: ia2694551:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Fri, 20 Jan 2023 14:21:19 -0500 (EST) Received: by perhan.alvh.no-ip.org (Postfix, from userid 1000) id 7934B98; Fri, 20 Jan 2023 20:12:38 +0100 (CET) Date: Fri, 20 Jan 2023 20:12:38 +0100 From: Alvaro Herrera To: "Karl O. Pinc" Cc: PostgreSQL Hackers Subject: Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences Message-ID: <20230120191238.ds5l4ehuxve4zn42@alvherre.pgsql> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="si72awv6d6krch47" Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20230120191203.7nyqjbw3qe7xx4ru@alvherre.pgsql> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk --si72awv6d6krch47 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit Ah, I wanted to attach the two remaining patches and forgot. Here they are. -- Álvaro Herrera Breisgau, Deutschland — https://www.EnterpriseDB.com/ --si72awv6d6krch47 Content-Type: text/x-diff; charset=us-ascii Content-Disposition: attachment; filename="v7-0001-Install-trusted-and-obsolete-markers-in-section-t.patch" From ba972984da37b5a315bd7a4face064d24ca41436 Mon Sep 17 00:00:00 2001 From: Alvaro Herrera Date: Fri, 20 Jan 2023 12:32:22 +0100 Subject: [PATCH v7 1/2] Install [trusted] and [obsolete] markers in section title I'm not sure about this part. --- doc/src/sgml/btree-gin.sgml | 2 +- doc/src/sgml/btree-gist.sgml | 2 +- doc/src/sgml/citext.sgml | 2 +- doc/src/sgml/cube.sgml | 2 +- doc/src/sgml/dict-int.sgml | 2 +- doc/src/sgml/fuzzystrmatch.sgml | 2 +- doc/src/sgml/hstore.sgml | 2 +- doc/src/sgml/intagg.sgml | 2 +- doc/src/sgml/intarray.sgml | 2 +- doc/src/sgml/isn.sgml | 2 +- doc/src/sgml/lo.sgml | 2 +- doc/src/sgml/ltree.sgml | 2 +- doc/src/sgml/pgcrypto.sgml | 2 +- doc/src/sgml/pgtrgm.sgml | 2 +- doc/src/sgml/seg.sgml | 2 +- doc/src/sgml/tablefunc.sgml | 2 +- doc/src/sgml/tcn.sgml | 2 +- doc/src/sgml/tsm-system-rows.sgml | 2 +- doc/src/sgml/tsm-system-time.sgml | 2 +- doc/src/sgml/unaccent.sgml | 2 +- doc/src/sgml/uuid-ossp.sgml | 2 +- doc/src/sgml/xml2.sgml | 2 +- 22 files changed, 22 insertions(+), 22 deletions(-) diff --git a/doc/src/sgml/btree-gin.sgml b/doc/src/sgml/btree-gin.sgml index 46117209ce..db96f02ba9 100644 --- a/doc/src/sgml/btree-gin.sgml +++ b/doc/src/sgml/btree-gin.sgml @@ -1,7 +1,7 @@ - btree_gin — GIN operator classes with B-tree behavior + btree_gin — GIN operator classes with B-tree behavior [trusted] btree_gin diff --git a/doc/src/sgml/btree-gist.sgml b/doc/src/sgml/btree-gist.sgml index 31e7c78aae..be14779a92 100644 --- a/doc/src/sgml/btree-gist.sgml +++ b/doc/src/sgml/btree-gist.sgml @@ -1,7 +1,7 @@ - btree_gist — GiST operator classes with B-tree behavior + btree_gist — GiST operator classes with B-tree behavior [trusted] btree_gist diff --git a/doc/src/sgml/citext.sgml b/doc/src/sgml/citext.sgml index 8322885661..ff8a98c21b 100644 --- a/doc/src/sgml/citext.sgml +++ b/doc/src/sgml/citext.sgml @@ -1,7 +1,7 @@ - citext — a case-insensitive character string type + citext — a case-insensitive character string type [trusted] citext diff --git a/doc/src/sgml/cube.sgml b/doc/src/sgml/cube.sgml index 0fb7080748..1998e6d81a 100644 --- a/doc/src/sgml/cube.sgml +++ b/doc/src/sgml/cube.sgml @@ -1,7 +1,7 @@ - cube — a multi-dimensional cube data type + cube — a multi-dimensional cube data type [trusted] cube (extension) diff --git a/doc/src/sgml/dict-int.sgml b/doc/src/sgml/dict-int.sgml index 8dd07b9bc1..293ba83ce6 100644 --- a/doc/src/sgml/dict-int.sgml +++ b/doc/src/sgml/dict-int.sgml @@ -2,7 +2,7 @@ dict_int — - example full-text search dictionary for integers + example full-text search dictionary for integers [trusted] dict_int diff --git a/doc/src/sgml/fuzzystrmatch.sgml b/doc/src/sgml/fuzzystrmatch.sgml index 1a5ebbb22f..bf1caab54d 100644 --- a/doc/src/sgml/fuzzystrmatch.sgml +++ b/doc/src/sgml/fuzzystrmatch.sgml @@ -1,7 +1,7 @@ - fuzzystrmatch — determine string similarities and distance + fuzzystrmatch — determine string similarities and distance [trusted] fuzzystrmatch diff --git a/doc/src/sgml/hstore.sgml b/doc/src/sgml/hstore.sgml index 7d93e49e91..b75c63f348 100644 --- a/doc/src/sgml/hstore.sgml +++ b/doc/src/sgml/hstore.sgml @@ -1,7 +1,7 @@ - hstore — hstore key/value datatype + hstore — hstore key/value datatype [trusted] hstore diff --git a/doc/src/sgml/intagg.sgml b/doc/src/sgml/intagg.sgml index 44a766eb4b..ce7b929a34 100644 --- a/doc/src/sgml/intagg.sgml +++ b/doc/src/sgml/intagg.sgml @@ -1,7 +1,7 @@ - intagg — integer aggregator and enumerator + intagg — integer aggregator and enumerator [obsolete] intagg diff --git a/doc/src/sgml/intarray.sgml b/doc/src/sgml/intarray.sgml index c72d49b01d..9194e94c28 100644 --- a/doc/src/sgml/intarray.sgml +++ b/doc/src/sgml/intarray.sgml @@ -1,7 +1,7 @@ - intarray — manipulate arrays of integers + intarray — manipulate arrays of integers [trusted] intarray diff --git a/doc/src/sgml/isn.sgml b/doc/src/sgml/isn.sgml index ea2aabc87d..a609969af9 100644 --- a/doc/src/sgml/isn.sgml +++ b/doc/src/sgml/isn.sgml @@ -1,7 +1,7 @@ - isn — data types for international standard numbers (ISBN, EAN, UPC, etc.) + isn — data types for international standard numbers (ISBN, EAN, UPC, etc.) [trusted] isn diff --git a/doc/src/sgml/lo.sgml b/doc/src/sgml/lo.sgml index 6d9bcebd42..511e576cac 100644 --- a/doc/src/sgml/lo.sgml +++ b/doc/src/sgml/lo.sgml @@ -1,7 +1,7 @@ - lo — manage large objects + lo — manage large objects [trusted] lo diff --git a/doc/src/sgml/ltree.sgml b/doc/src/sgml/ltree.sgml index bb66e33944..25d98e3f7d 100644 --- a/doc/src/sgml/ltree.sgml +++ b/doc/src/sgml/ltree.sgml @@ -1,7 +1,7 @@ - ltree — hierarchical tree-like data type + ltree — hierarchical tree-like data type [trusted] ltree diff --git a/doc/src/sgml/pgcrypto.sgml b/doc/src/sgml/pgcrypto.sgml index 2e29f1d6f7..2231a65dde 100644 --- a/doc/src/sgml/pgcrypto.sgml +++ b/doc/src/sgml/pgcrypto.sgml @@ -1,7 +1,7 @@ - pgcrypto — cryptographic functions + pgcrypto — cryptographic functions [trusted] pgcrypto diff --git a/doc/src/sgml/pgtrgm.sgml b/doc/src/sgml/pgtrgm.sgml index 07bfcac931..1497172762 100644 --- a/doc/src/sgml/pgtrgm.sgml +++ b/doc/src/sgml/pgtrgm.sgml @@ -2,7 +2,7 @@ pg_trgm — - support for similarity of text using trigram matching + support for similarity of text using trigram matching [trusted] pg_trgm diff --git a/doc/src/sgml/seg.sgml b/doc/src/sgml/seg.sgml index dc66e24f2f..4656dff681 100644 --- a/doc/src/sgml/seg.sgml +++ b/doc/src/sgml/seg.sgml @@ -1,7 +1,7 @@ - seg — a datatype for line segments or floating point intervals + seg — a datatype for line segments or floating point intervals [trusted] seg diff --git a/doc/src/sgml/tablefunc.sgml b/doc/src/sgml/tablefunc.sgml index e10fe7009d..79f721886a 100644 --- a/doc/src/sgml/tablefunc.sgml +++ b/doc/src/sgml/tablefunc.sgml @@ -1,7 +1,7 @@ - tablefunc — functions that return tables (<function>crosstab</function> and others) + tablefunc — functions that return tables (<function>crosstab</function> and others) [trusted] tablefunc diff --git a/doc/src/sgml/tcn.sgml b/doc/src/sgml/tcn.sgml index 32a1025cc6..a848e622e1 100644 --- a/doc/src/sgml/tcn.sgml +++ b/doc/src/sgml/tcn.sgml @@ -1,7 +1,7 @@ - tcn — a trigger function to notify listeners of changes to table content + tcn — a trigger function to notify listeners of changes to table content [trusted] tcn diff --git a/doc/src/sgml/tsm-system-rows.sgml b/doc/src/sgml/tsm-system-rows.sgml index e3fb4d15dd..c36e0c7662 100644 --- a/doc/src/sgml/tsm-system-rows.sgml +++ b/doc/src/sgml/tsm-system-rows.sgml @@ -2,7 +2,7 @@ tsm_system_rows — - the <literal>SYSTEM_ROWS</literal> sampling method for <literal>TABLESAMPLE</literal> + the SYSTEM_ROWS sampling method for TABLESAMPLE [trusted] tsm_system_rows diff --git a/doc/src/sgml/tsm-system-time.sgml b/doc/src/sgml/tsm-system-time.sgml index 05c6be0cac..10fd27abb6 100644 --- a/doc/src/sgml/tsm-system-time.sgml +++ b/doc/src/sgml/tsm-system-time.sgml @@ -2,7 +2,7 @@ tsm_system_time — - the <literal>SYSTEM_TIME</literal> sampling method for <literal>TABLESAMPLE</literal> + the SYSTEM_TIME sampling method for TABLESAMPLE [trusted] tsm_system_time diff --git a/doc/src/sgml/unaccent.sgml b/doc/src/sgml/unaccent.sgml index f3ddc64bbc..7b02b66530 100644 --- a/doc/src/sgml/unaccent.sgml +++ b/doc/src/sgml/unaccent.sgml @@ -1,7 +1,7 @@ - unaccent — a text search dictionary which removes diacritics + unaccent — a text search dictionary which removes diacritics [trusted] unaccent diff --git a/doc/src/sgml/uuid-ossp.sgml b/doc/src/sgml/uuid-ossp.sgml index 6f851ac85f..43b49e2b5a 100644 --- a/doc/src/sgml/uuid-ossp.sgml +++ b/doc/src/sgml/uuid-ossp.sgml @@ -1,7 +1,7 @@ - uuid-ossp — a UUID generator + uuid-ossp — a UUID generator [trusted] uuid-ossp diff --git a/doc/src/sgml/xml2.sgml b/doc/src/sgml/xml2.sgml index 9fd613f967..2bd4a3fd3a 100644 --- a/doc/src/sgml/xml2.sgml +++ b/doc/src/sgml/xml2.sgml @@ -1,7 +1,7 @@ - xml2 — XPath querying and XSLT functionality + xml2 — XPath querying and XSLT functionality [obsolete] xml2 -- 2.30.2 --si72awv6d6krch47 Content-Type: text/x-diff; charset=us-ascii Content-Disposition: attachment; filename="v7-0002-Install-pagebreaks-between-contrib-section.patch" From bf3030e34bb630014b8de24aea46e0b14d275ee3 Mon Sep 17 00:00:00 2001 From: Alvaro Herrera Date: Fri, 20 Jan 2023 11:55:44 +0100 Subject: [PATCH v7 2/2] Install pagebreaks between contrib section This makes the PDF much more readable, but I don't like the mechanism used. --- doc/src/sgml/contrib.sgml | 50 ++++++++++++++++++++++++++++++++++ doc/src/sgml/stylesheet-fo.xsl | 6 ++++ 2 files changed, 56 insertions(+) diff --git a/doc/src/sgml/contrib.sgml b/doc/src/sgml/contrib.sgml index 12c79b798b..bb823bebc1 100644 --- a/doc/src/sgml/contrib.sgml +++ b/doc/src/sgml/contrib.sgml @@ -100,55 +100,105 @@ CREATE EXTENSION extension_name; component for details. + &adminpack; + &amcheck; + &auth-delay; + &auto-explain; + &basebackup-to-shell; + &basic-archive; + &bloom; + &btree-gin; + &btree-gist; + &citext; + &cube; + &dblink; + &dict-int; + &dict-xsyn; + &earthdistance; + &file-fdw; + &fuzzystrmatch; + &hstore; + &intagg; + &intarray; + &isn; + &lo; + <ree; + &oldsnapshot; + &pageinspect; + &passwordcheck; + &pgbuffercache; + &pgcrypto; + &pgfreespacemap; + &pgprewarm; + &pgrowlocks; + &pgstatstatements; + &pgstattuple; + &pgsurgery; + &pgtrgm; + &pgvisibility; + &pgwalinspect; + &postgres-fdw; + &seg; + &sepgsql; + &contrib-spi; + &sslinfo; + &tablefunc; + &tcn; + &test-decoding; + &tsm-system-rows; + &tsm-system-time; + &unaccent; + &uuid-ossp; + &xml2; diff --git a/doc/src/sgml/stylesheet-fo.xsl b/doc/src/sgml/stylesheet-fo.xsl index 0c4dff92c4..9dde0a89dd 100644 --- a/doc/src/sgml/stylesheet-fo.xsl +++ b/doc/src/sgml/stylesheet-fo.xsl @@ -132,4 +132,10 @@ + + + + + -- 2.30.2 --si72awv6d6krch47--