annotate docs/source/limitations.rst @ 247:f0f293d83337

begin docs
author catherine@dellzilla
date Wed, 04 Mar 2009 17:44:29 -0500
parents
children 3ce9a48aa3fc
rev   line source
247
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
1 ===========
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
2 Limitations
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
3 ===========
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
4
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
5 Slow parsing
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
6 ------------
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
7
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
8 After each line of text in a multi-line command is entered, SQLPython pauses to determine whether
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
9 the command is finished yet. This pause is unnoticable at first, but gradually becomes noticable,
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
10 then annoying, then crippling when very long commands are entered.
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
11
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
12 This problem can be worked around by bracketing long, individual commands in REMARK BEGIN
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
13 and REMARK END statements. When SQLPython finds a REMARK BEGIN, it stops parsing after each
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
14 line and assumes that everything entered until REMARK END is a single statement.
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
15
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
16 PL/SQL
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
17 ------
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
18
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
19 SQLPython interprets short anonymous PL/SQL blocks correctly, as well as one-line PL/SQL
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
20 commands preceded with `exec`. For longer blocks, however, it gets confused about where
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
21 the statement begins and ends.
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
22
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
23 To parse PL/SQL safely, enclose each free-standing PL/SQL block between a REMARK BEGIN and a
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
24 REMARK END statement.
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
25
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
26 Unsupported commands
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
27 --------------------
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
28
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
29 * DBMS_OUTPUT.PUT_LINE
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
30