rspec/rules/S1637/plsql/rule.adoc

From the Oracle docs:

____
Do not put a single-line comment in a PL/SQL block that will be processed dynamically by an Oracle Precompiler program. The Oracle Precompiler program ignores end-of-line characters, which means that a single-line comment will end at the end of the block.
____

== Noncompliant Code Example

----
DECLARE
  howmany     NUMBER;
  num_tables  NUMBER;
BEGIN
  -- Begin processing
  SELECT COUNT(*) INTO howmany
    FROM USER_OBJECTS
      WHERE OBJECT_TYPE = 'TABLE'; -- Check number of tables
   num_tables := howmany;          -- Compute some other value
END;
/
----

== Compliant Solution

----
DECLARE
  howmany     NUMBER;
  num_tables  NUMBER;
BEGIN
  /* Begin processing */
  SELECT COUNT(*) INTO howmany
    FROM USER_OBJECTS
      WHERE OBJECT_TYPE = 'TABLE'; 
   num_tables := howmany;
END;
/
----