You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@madlib.apache.org by ok...@apache.org on 2017/10/10 19:05:52 UTC

[2/3] madlib git commit: Docs: Reference "current" PostgreSQL docs instead of EOL versions (MADLIB-1153).

Docs: Reference "current" PostgreSQL docs instead of EOL versions (MADLIB-1153).

o Add note informing user that the links may need to be adjusted based
  on their database platform version.

o This applies to Pivot, Path and Sessionize documentation.

Closes #189


Project: http://git-wip-us.apache.org/repos/asf/madlib/repo
Commit: http://git-wip-us.apache.org/repos/asf/madlib/commit/5da60863
Tree: http://git-wip-us.apache.org/repos/asf/madlib/tree/5da60863
Diff: http://git-wip-us.apache.org/repos/asf/madlib/diff/5da60863

Branch: refs/heads/master
Commit: 5da6086341090a2f16cc8723556dfa30922aa25f
Parents: 96c81d0
Author: Ed Espino <ee...@pivotal.io>
Authored: Thu Oct 5 14:38:06 2017 -0700
Committer: Orhan Kislal <ok...@pivotal.io>
Committed: Tue Oct 10 11:56:50 2017 -0700

----------------------------------------------------------------------
 src/ports/postgres/modules/utilities/path.sql_in     | 15 ++++++++++++---
 src/ports/postgres/modules/utilities/pivot.sql_in    | 15 ++++++++++++---
 .../postgres/modules/utilities/sessionize.sql_in     | 11 ++++++++++-
 3 files changed, 34 insertions(+), 7 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/madlib/blob/5da60863/src/ports/postgres/modules/utilities/path.sql_in
----------------------------------------------------------------------
diff --git a/src/ports/postgres/modules/utilities/path.sql_in b/src/ports/postgres/modules/utilities/path.sql_in
index f97c6a0..d98b500 100644
--- a/src/ports/postgres/modules/utilities/path.sql_in
+++ b/src/ports/postgres/modules/utilities/path.sql_in
@@ -508,17 +508,26 @@ Pattern match
 @anchor literature
 @par Literature
 
+NOTE: The following links refer to documentation resources for the
+current PostgreSQL database version. Depending upon your database
+platform version, you may need to change "current" references in the
+links to your database version.
+
+If your database platform uses the Greenplum Database (or related
+variants), please check with the project community and/or your
+database vendor to identify the PostgreSQL version it is based on.
+
 [1]  PostgreSQL basic statements/assignment operator,
-http://www.postgresql.org/docs/8.2/static/plpgsql-statements.html
+http://www.postgresql.org/docs/current/static/plpgsql-statements.html
 
 [2]  PostgreSQL pattern matching,
 http://www.postgresql.org/docs/current/static/functions-matching.html
 
 [3]  PostgreSQL aggregate functions,
-http://www.postgresql.org/docs/8.2/static/tutorial-agg.html
+http://www.postgresql.org/docs/current/static/tutorial-agg.html
 
 [4]  PostgreSQL window functions,
-http://www.postgresql.org/docs/8.4/static/tutorial-window.html
+http://www.postgresql.org/docs/current/static/tutorial-window.html
 
 */
 -------------------------------------------------------------------------

http://git-wip-us.apache.org/repos/asf/madlib/blob/5da60863/src/ports/postgres/modules/utilities/pivot.sql_in
----------------------------------------------------------------------
diff --git a/src/ports/postgres/modules/utilities/pivot.sql_in b/src/ports/postgres/modules/utilities/pivot.sql_in
index 4d239de..0c8989a 100644
--- a/src/ports/postgres/modules/utilities/pivot.sql_in
+++ b/src/ports/postgres/modules/utilities/pivot.sql_in
@@ -674,12 +674,21 @@ __p_13__ | 111
 @anchor literature
 @literature
 
+NOTE: The following links refer to documentation resources for the
+current PostgreSQL database version. Depending upon your database
+platform version, you may need to change "current" references in the
+links to your database version.
+
+If your database platform uses the Greenplum Database (or related
+variants), please check with the project community and/or your
+database vendor to identify the PostgreSQL version it is based on.
+
 @anchor svm-lit-1
-[1] https://www.postgresql.org/docs/8.2/static/functions-aggregate.html
+[1] https://www.postgresql.org/docs/current/static/functions-aggregate.html
 
-[2] https://www.postgresql.org/docs/8.2/static/sql-createaggregate.html
+[2] https://www.postgresql.org/docs/current/static/sql-createaggregate.html
 
-[3] https://www.postgresql.org/docs/8.2/static/xaggr.html
+[3] https://www.postgresql.org/docs/current/static/xaggr.html
 */
 
 -------------------------------------------------------------------------

http://git-wip-us.apache.org/repos/asf/madlib/blob/5da60863/src/ports/postgres/modules/utilities/sessionize.sql_in
----------------------------------------------------------------------
diff --git a/src/ports/postgres/modules/utilities/sessionize.sql_in b/src/ports/postgres/modules/utilities/sessionize.sql_in
index 63e4042..c66b417 100644
--- a/src/ports/postgres/modules/utilities/sessionize.sql_in
+++ b/src/ports/postgres/modules/utilities/sessionize.sql_in
@@ -229,11 +229,20 @@ Result showing 2 users and 3 total sessions across the group:
 @anchor literature
 @par Literature
 
+NOTE: The following PostgreSQL link refers to documentation resources
+for the current PostgreSQL database version. Depending upon your
+database platform version, you may need to change "current" reference
+in the link to your database version.
+
+If your database platform uses the Greenplum Database (or related
+variants), please check with the project community and/or your
+database vendor to identify the PostgreSQL version it is based on.
+
 [1] Sesssions in web analytics
 https://en.wikipedia.org/wiki/Session_(web_analytics)
 
 [2] PostgreSQL date/time types
-https://www.postgresql.org/docs/8.4/static/datatype-datetime.html
+https://www.postgresql.org/docs/current/static/datatype-datetime.html
 
 */
 -------------------------------------------------------------------------