Clarify what some historic terms in rewriteHandler.c mean.

Discussion: 20150827131352.GF2435@awork2.anarazel.de

diff --git a/src/backend/rewrite/rewriteHandler.c b/src/backend/rewrite/rewriteHandler.c
index 1734e48241ada102ac66cfd2788ffff0837dfcab..5cf9cc7bccc195c2b0b1a2fb81aee44047c52a5f 100644 (file)
--- a/src/backend/rewrite/rewriteHandler.c
+++ b/src/backend/rewrite/rewriteHandler.c
@@ -9,6 +9,13 @@
  * IDENTIFICATION
  *       src/backend/rewrite/rewriteHandler.c
  *
+ * NOTES
+ *       Some of the terms used in this file are of historic nature: "retrieve"
+ *       was the PostQUEL keyword for what today is SELECT. "RIR" stands for
+ *       "Retrieve-Instead-Retrieve", that is an ON SELECT DO INSTEAD SELECT rule
+ *       (which has to be unconditional and where only one rule can exist on each
+ *       relation).
+ *
  *-------------------------------------------------------------------------
  */
 #include "postgres.h"