annotate docs/source/limitations.rst @ 287:3ce9a48aa3fc

added refresh.bash script for docs
author catherine@dellzilla
date Fri, 20 Mar 2009 13:16:26 -0400
parents f0f293d83337
children e7578e7ff9dd
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
287
3ce9a48aa3fc added refresh.bash script for docs
catherine@dellzilla
parents: 247
diff changeset
5 Bug reports and feature requests are welcome at
3ce9a48aa3fc added refresh.bash script for docs
catherine@dellzilla
parents: 247
diff changeset
6 `the project's bug tracker on Assembla <http://trac-hg.assembla.com/sqlpython/report>`_.
3ce9a48aa3fc added refresh.bash script for docs
catherine@dellzilla
parents: 247
diff changeset
7
247
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
8 Slow parsing
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
9 ------------
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
10
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
11 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
12 the command is finished yet. This pause is unnoticable at first, but gradually becomes noticable,
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
13 then annoying, then crippling when very long commands are entered.
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
14
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
15 This problem can be worked around by bracketing long, individual commands in REMARK BEGIN
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
16 and REMARK END statements. When SQLPython finds a REMARK BEGIN, it stops parsing after each
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
17 line and assumes that everything entered until REMARK END is a single statement.
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
18
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
19 PL/SQL
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
20 ------
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
21
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
22 SQLPython interprets short anonymous PL/SQL blocks correctly, as well as one-line PL/SQL
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
23 commands preceded with `exec`. For longer blocks, however, it gets confused about where
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
24 the statement begins and ends.
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
25
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
26 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
27 REMARK END statement.
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
28
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
29 Unsupported commands
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
30 --------------------
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
31
287
3ce9a48aa3fc added refresh.bash script for docs
catherine@dellzilla
parents: 247
diff changeset
32 * PASSWORD
247
f0f293d83337 begin docs
catherine@dellzilla
parents:
diff changeset
33
287
3ce9a48aa3fc added refresh.bash script for docs
catherine@dellzilla
parents: 247
diff changeset
34 * SET FEEDBACK OFF
3ce9a48aa3fc added refresh.bash script for docs
catherine@dellzilla
parents: 247
diff changeset
35