doc: Put callouts in SQL comments
authorPeter Eisentraut
Fri, 3 Mar 2017 20:03:03 +0000 (15:03 -0500)
committerPeter Eisentraut
Fri, 3 Mar 2017 20:03:03 +0000 (15:03 -0500)
This makes copy-and-pasting the SQL code easier.

From: Thomas Munro 

doc/src/sgml/plpgsql.sgml
doc/src/sgml/query.sgml

index d3272e12096e6c0c7825e255ceda8b0e4c45b0a7..d356deb9f57acac3e1868c1d5869744e8fc9eaad 100644 (file)
@@ -5328,14 +5328,14 @@ SELECT * FROM cs_parse_url('http://foobar.com/query.cgi?baz');
 
 CREATE OR REPLACE PROCEDURE cs_create_job(v_job_id IN INTEGER) IS
     a_running_job_count INTEGER;
-    PRAGMA AUTONOMOUS_TRANSACTION;
+    PRAGMA AUTONOMOUS_TRANSACTION; -- 
 BEGIN
-    LOCK TABLE cs_jobs IN EXCLUSIVE MODE;
+    LOCK TABLE cs_jobs IN EXCLUSIVE MODE; -- 
 
     SELECT count(*) INTO a_running_job_count FROM cs_jobs WHERE end_stamp IS NULL;
 
     IF a_running_job_count > 0 THEN
-        COMMIT; -- free lock
+        COMMIT; -- free lock 
         raise_application_error(-20000,
                  'Unable to create a new job: a job is currently running.');
     END IF;
@@ -5402,7 +5402,7 @@ BEGIN
     SELECT count(*) INTO a_running_job_count FROM cs_jobs WHERE end_stamp IS NULL;
 
     IF a_running_job_count > 0 THEN
-        RAISE EXCEPTION 'Unable to create a new job: a job is currently running';
+        RAISE EXCEPTION 'Unable to create a new job: a job is currently running'; -- 
     END IF;
 
     DELETE FROM cs_active_job;
@@ -5411,7 +5411,7 @@ BEGIN
     BEGIN
         INSERT INTO cs_jobs (job_id, start_stamp) VALUES (v_job_id, now());
     EXCEPTION
-        WHEN unique_violation THEN 
+        WHEN unique_violation THEN -- 
             -- don't worry if it already exists
     END;
 END;
index f4fbf11a8d1259d96304d8e5ce418d0f2350ca1c..98434925df32447b710334b7cbf036c0dfd343d6 100644 (file)
@@ -754,7 +754,7 @@ SELECT city, max(temp_lo)
 
 SELECT city, max(temp_lo)
     FROM weather
-    WHERE city LIKE 'S%'
+    WHERE city LIKE 'S%'            -- 
     GROUP BY city
     HAVING max(temp_lo) < 40;