rfe9802 - Test new dynamic indexing code

As part of the RFE for testing dynamic indexing, the events test
now by default creates only an optimal set of indices to satisfy
the query requirements.

If one wants to use the full set of indices, pass the -i argument
on the command line.

-i, --indexfull       Create the full set of indices [default=optimal
                      indices]

Tests added for:     None
make test-suite run? no - but ran the events test both w and w/o -i

Change-Id: Ic03f5e254cc73a359a809abcd5cd09efb04224ab
Reviewed-on: https://gerrit.franz.com:9080/721
Reviewed-by: Kevin Layer <layer@franz.com>
Tested-by: Kevin Layer <layer@franz.com>
bug19750 bug19553 Small changes to python tutorial

Some very small changes to the python sesame tutorial.

No change notes.

Change-Id: I19cd9a41ef1ae3ab09dbc387869d36d48096e0fa
Reviewed-on: https://gerrit.franz.com:9080/855
Reviewed-by: Kevin Layer <layer@franz.com>
Tested-by: Kevin Layer <layer@franz.com>
[rfe10093] add profiling to Python events test

Added a -f/--profile option which accepts option strings "off",
"time", or "space" to the python events test. It defaults to "off".

It profiles one of each type of process (1 loader in each loading phase,
1 SPARQL and 1 PROLOG querier, and 1 Deleter), and the flat and call
graph output goes to the agraph.log.

This change requires the rfe10093 change in the agraph repository
as well, which adds (require :prof) to the agraph executable.

Tests added for:     None
make test-suite run? python events test run

Change-Id: I273df2dc941b73ce84ab137d5b4266c231cf992c
Reviewed-on: https://gerrit.franz.com:9080/778
Reviewed-by: Kevin Layer <layer@franz.com>
Tested-by: Kevin Layer <layer@franz.com>
rfe10077  Document index management in tutorials (python)

Changes to three files to add user-selected triple indices
to the python API documentation.

Tested: https://internal.franz.com/people/bruce/ag41docs/python-tutorial/python-API-40.html
Tested: https://internal.franz.com/people/bruce/ag41docs/python-tutorial/python-tutorial-40.html#Creating%20a%20Repository
Tested: Python examples run without error.

<release-note>
Rfe10077 - Add user-selected triple indices to tutorials.

The Python, Java, and Jena tutorials have an augmented
example1() showing how to add and remove triple indices
for greater efficiency.
</release-note>

Change-Id: Ia7bb51d5a78ea8e0f1c1d5d3d142b885a50e899e
Reviewed-on: https://gerrit.franz.com:9080/881
Tested-by: Kevin Layer <layer@franz.com>
Reviewed-by: Kevin Layer <layer@franz.com>
bug19698 - add "SPARQL"->QueryLanguage.SPARQL map prepare*Query

Moved the call to map the strings "SPARQL" and "PROLOG"
to their equivalent QueryLanguage.* instances up a class so the
prepareTupleQuery, prepareBooleanQuery, and prepareGraphQuery
functions all do the conversion.

Tests added for:     changed some QueryLanguage uses to strings
make test-suite run? make python-prepush - yes

<release-note>
bug19698: Changes to prepareGraphQuery and prepareBooleanQuery

prepareGraphQuery and prepareBooleanQuery now also accept the
string "SPARQL" or "PROLOG" as a query language parameter.
Previously, only prepareTupleQuery allowed the string values
as a convenience in place of the QueryLanguage.SPARQL or
QueryLanguage.PROLOG objects.
</release-note>

Change-Id: Ie13b46f9201427d3229dad66ccf9928241cb62fa
Reviewed-on: https://gerrit.franz.com:9080/780
Reviewed-by: John O'Rourke <john.orourke@franz.com>
Reviewed-by: Ahmon Dancy <dancy@franz.com>
Tested-by: Kevin Layer <layer@franz.com>
bug19610 - Obsolete getStatements() comments in repositoryconnection.py

Removed obsolete comments from repositoryconnection.py and
repository.py. Pointed the user to the documentation locations
both on the web and the local installation instead. Moved some
comments into docstrings for functions.

Tests added for:     None
make test-suite run? yes - nosetests were run

Change-Id: I8243f676a0fafc6759a0bf11ae16b3783c49f0cd
Reviewed-on: https://gerrit.franz.com:9080/889
Reviewed-by: Kevin Layer <layer@franz.com>
Tested-by: Kevin Layer <layer@franz.com>