Make targets of doc links used by phpPgAdmin static

Started by Karl O. Pincover 12 years ago8 messages
#1Karl O. Pinc
kop@meme.com
1 attachment(s)

Hi,

Attached is a documentation patch against head which makes
static the targets of the on-line PG html documentation that
are referenced by the phpPgAdmin help system.

Apply with "patch -p1" at the top of the pg code tree.

The phpPgAdmin project is a web interface into PG. It
contains help links which reference the PG on-line docs. At
present, each time there's a new PG release many of the
internal ids within PGs html doc pages change, and the
phpPgAdmin code must track such changes. This
patch makes static those ids referenced by phpPgAdmin.

Of course phpPgAdmin will always need to adjust to changes
in the PG docs but this patch will eliminate periodic
annoying scutwork.

Regards,

Karl <kop@meme.com>
Free Software: "You don't pay back, you pay forward."
-- Robert A. Heinlein

Attachments:

ppa_id_v1.patchtext/x-patch; charset=us-ascii; name=ppa_id_v1.patchDownload
diff --git a/doc/src/sgml/ddl.sgml b/doc/src/sgml/ddl.sgml
index e9135bf..bae2e97 100644
--- a/doc/src/sgml/ddl.sgml
+++ b/doc/src/sgml/ddl.sgml
@@ -258,7 +258,7 @@ CREATE TABLE products (
    even if the value came from the default value definition.
   </para>
 
-  <sect2>
+  <sect2 id="ddl-constraints-check-constraints">
    <title>Check Constraints</title>
 
    <indexterm>
@@ -482,7 +482,7 @@ CREATE TABLE products (
    </tip>
   </sect2>
 
-  <sect2>
+  <sect2 id="ddl-constraints-unique-constraints">
    <title>Unique Constraints</title>
 
    <indexterm>
@@ -569,7 +569,7 @@ CREATE TABLE products (
    </para>
   </sect2>
 
-  <sect2>
+  <sect2 id="ddl-constraints-primary-keys">
    <title>Primary Keys</title>
 
    <indexterm>
@@ -1168,7 +1168,7 @@ CREATE TABLE circles (
    here.
   </para>
 
-  <sect2>
+  <sect2 id="ddl-alter-adding-a-column">
    <title>Adding a Column</title>
 
    <indexterm>
@@ -1212,7 +1212,7 @@ ALTER TABLE products ADD COLUMN description text CHECK (description &lt;&gt; '')
   </tip>
   </sect2>
 
-  <sect2>
+  <sect2 id="ddl-alter-removing-a-column">
    <title>Removing a Column</title>
 
    <indexterm>
@@ -1239,7 +1239,7 @@ ALTER TABLE products DROP COLUMN description CASCADE;
    </para>
   </sect2>
 
-  <sect2>
+  <sect2 id="ddl-alter-adding-a-constraint">
    <title>Adding a Constraint</title>
 
    <indexterm>
@@ -1267,7 +1267,7 @@ ALTER TABLE products ALTER COLUMN product_no SET NOT NULL;
    </para>
   </sect2>
 
-  <sect2>
+  <sect2 id="ddl-alter-removing-a-constraint">
    <title>Removing a Constraint</title>
 
    <indexterm>
diff --git a/doc/src/sgml/extend.sgml b/doc/src/sgml/extend.sgml
index bc1cd59..60fa1a8 100644
--- a/doc/src/sgml/extend.sgml
+++ b/doc/src/sgml/extend.sgml
@@ -145,7 +145,7 @@
     </para>
    </sect2>
 
-   <sect2>
+   <sect2 id="extend-type-system-domains">
     <title>Domains</title>
 
     <para>

#2Peter Eisentraut
peter_e@gmx.net
In reply to: Karl O. Pinc (#1)
Re: Make targets of doc links used by phpPgAdmin static

On Tue, 2013-05-07 at 00:32 -0500, Karl O. Pinc wrote:

Attached is a documentation patch against head which makes
static the targets of the on-line PG html documentation that
are referenced by the phpPgAdmin help system.e

done

--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers

#3Alvaro Herrera
alvherre@2ndquadrant.com
In reply to: Peter Eisentraut (#2)
Re: Make targets of doc links used by phpPgAdmin static

Peter Eisentraut wrote:

On Tue, 2013-05-07 at 00:32 -0500, Karl O. Pinc wrote:

Attached is a documentation patch against head which makes
static the targets of the on-line PG html documentation that
are referenced by the phpPgAdmin help system.e

done

I wonder about backpatching this to 9.2 ?

--
Álvaro Herrera http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Training & Services

--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers

#4Peter Eisentraut
peter_e@gmx.net
In reply to: Alvaro Herrera (#3)
Re: Make targets of doc links used by phpPgAdmin static

On Tue, 2013-05-07 at 23:18 -0400, Alvaro Herrera wrote:

Peter Eisentraut wrote:

On Tue, 2013-05-07 at 00:32 -0500, Karl O. Pinc wrote:

Attached is a documentation patch against head which makes
static the targets of the on-line PG html documentation that
are referenced by the phpPgAdmin help system.e

done

I wonder about backpatching this to 9.2 ?

done

--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers

#5Karl O. Pinc
kop@meme.com
In reply to: Peter Eisentraut (#4)
Re: Make targets of doc links used by phpPgAdmin static

On 06/04/2013 10:16:20 PM, Peter Eisentraut wrote:

On Tue, 2013-05-07 at 23:18 -0400, Alvaro Herrera wrote:

Peter Eisentraut wrote:

On Tue, 2013-05-07 at 00:32 -0500, Karl O. Pinc wrote:

Attached is a documentation patch against head which makes
static the targets of the on-line PG html documentation that
are referenced by the phpPgAdmin help system.e

done

I wonder about backpatching this to 9.2 ?

done

Will this be in the next point release? Or just when
will it go live?

This is not a huge problem but it does break some
existing links into the 9.2 PG docs.

Regards,

Karl <kop@meme.com>
Free Software: "You don't pay back, you pay forward."
-- Robert A. Heinlein

--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers

#6Peter Eisentraut
peter_e@gmx.net
In reply to: Karl O. Pinc (#5)
Re: Make targets of doc links used by phpPgAdmin static

On Tue, 2013-06-04 at 22:27 -0500, Karl O. Pinc wrote:

On 06/04/2013 10:16:20 PM, Peter Eisentraut wrote:

On Tue, 2013-05-07 at 23:18 -0400, Alvaro Herrera wrote:

Peter Eisentraut wrote:

On Tue, 2013-05-07 at 00:32 -0500, Karl O. Pinc wrote:

Attached is a documentation patch against head which makes
static the targets of the on-line PG html documentation that
are referenced by the phpPgAdmin help system.e

done

I wonder about backpatching this to 9.2 ?

done

Will this be in the next point release? Or just when
will it go live?

I don't know when it goes to the web site, but it will be in the next
point release.

This is not a huge problem but it does break some
existing links into the 9.2 PG docs.

Well, if it doesn't help you, I can back it out again.

--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers

#7Magnus Hagander
magnus@hagander.net
In reply to: Peter Eisentraut (#6)
Re: Make targets of doc links used by phpPgAdmin static

On Jun 6, 2013 4:14 AM, "Peter Eisentraut" <peter_e@gmx.net> wrote:

On Tue, 2013-06-04 at 22:27 -0500, Karl O. Pinc wrote:

On 06/04/2013 10:16:20 PM, Peter Eisentraut wrote:

On Tue, 2013-05-07 at 23:18 -0400, Alvaro Herrera wrote:

Peter Eisentraut wrote:

On Tue, 2013-05-07 at 00:32 -0500, Karl O. Pinc wrote:

Attached is a documentation patch against head which makes
static the targets of the on-line PG html documentation that
are referenced by the phpPgAdmin help system.e

done

I wonder about backpatching this to 9.2 ?

done

Will this be in the next point release? Or just when
will it go live?

I don't know when it goes to the web site, but it will be in the next
point release.

Website doc updates for back branches are loaded at the same time as the
release is pushed. The "developer docs" are loaded every few hours from
git, but release docs are only loaded on release day.

/Magnus

#8Karl O. Pinc
kop@meme.com
In reply to: Peter Eisentraut (#6)
Re: Make targets of doc links used by phpPgAdmin static

On 06/05/2013 09:13:45 PM, Peter Eisentraut wrote:

On Tue, 2013-06-04 at 22:27 -0500, Karl O. Pinc wrote:

On 06/04/2013 10:16:20 PM, Peter Eisentraut wrote:

On Tue, 2013-05-07 at 23:18 -0400, Alvaro Herrera wrote:

Peter Eisentraut wrote:

On Tue, 2013-05-07 at 00:32 -0500, Karl O. Pinc wrote:

Attached is a documentation patch against head which makes
static the targets of the on-line PG html documentation

that

are referenced by the phpPgAdmin help system.e

done

I wonder about backpatching this to 9.2 ?

done

Will this be in the next point release? Or just when
will it go live?

I don't know when it goes to the web site, but it will be in the next
point release.

Ok. Thanks.

This is not a huge problem but it does break some
existing links into the 9.2 PG docs.

Well, if it doesn't help you, I can back it out again.

It doesn't make me miserable and it sounds like
other people want it. In theory the automatically
generated anchors could change and break things
anyway. I'm happy to let somebody
else decide what to do.

Karl <kop@meme.com>
Free Software: "You don't pay back, you pay forward."
-- Robert A. Heinlein

--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers