/usr/share/doc/cl-sql/html/locally-enable-sql-reader-syntax.html is in cl-sql 6.4.1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>LOCALLY-ENABLE-SQL-READER-SYNTAX</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1" /><link rel="home" href="index.html" title="CLSQL Users' Guide" /><link rel="up" href="ref-syntax.html" title="The Symbolic SQL Syntax" /><link rel="prev" href="disable-sql-reader-syntax.html" title="DISABLE-SQL-READER-SYNTAX" /><link rel="next" href="locally-disable-sql-reader-syntax.html" title="LOCALLY-DISABLE-SQL-READER-SYNTAX" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">LOCALLY-ENABLE-SQL-READER-SYNTAX</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="disable-sql-reader-syntax.html">Prev</a> </td><th width="60%" align="center">The Symbolic SQL Syntax</th><td width="20%" align="right"> <a accesskey="n" href="locally-disable-sql-reader-syntax.html">Next</a></td></tr></table><hr /></div><div class="refentry" title="LOCALLY-ENABLE-SQL-READER-SYNTAX"><a id="locally-enable-sql-reader-syntax"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>LOCALLY-ENABLE-SQL-READER-SYNTAX — Locally enable square bracket reader syntax.<strong>Macro</strong></p></div><div class="refsect1" title="Syntax"><a id="idp10937712"></a><h2>Syntax</h2><pre class="synopsis">
<code class="function">locally-enable-sql-reader-syntax</code> => <span class="returnvalue"></span></pre></div><div class="refsect1" title="Arguments and Values"><a id="idp10940192"></a><h2>Arguments and Values</h2><p>None.</p></div><div class="refsect1" title="Description"><a id="idp10941536"></a><h2>Description</h2><p>Turns on the SQL reader syntax without changing the syntax
state such that <a class="link" href="restore-sql-reader-syntax-state.html" title="RESTORE-SQL-READER-SYNTAX-STATE">
<code class="function">restore-sql-reader-syntax-state</code></a> will
re-establish the current syntax state.
</p></div><div class="refsect1" title="Examples"><a id="idp10944208"></a><h2>Examples</h2><p>Intended to be used in a file for code which uses the
square bracket syntax without changing the global state.
</p><pre class="screen">
#.(locally-enable-sql-reader-syntax)
... CODE USING SYMBOLIC SQL SYNTAX ...
#.(restore-sql-reader-syntax-state)
</pre></div><div class="refsect1" title="Side Effects"><a id="idp10946528"></a><h2>Side Effects</h2><p>
Modifies the default readtable.
</p><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
<span class="application"><span class="emphasis"><em>CLSQL</em></span></span> tries to keep track of whether the syntax has already been enabled. This can be problematic if the syntax is somehow disabled externally to <span class="application"><span class="emphasis"><em>CLSQL</em></span></span> as future attempts to enable the syntax will do nothing--the system thinks it is already enabled. This may happen if there is an enable, but no disable, in a file that is processed with load or compile-file as the lisp implementation will restore the readtable on completion. Or, even if there is a disable but a compiler-error is encountered before running the disable. If you encounter this try running <a class="link" href="disable-sql-reader-syntax.html" title="DISABLE-SQL-READER-SYNTAX"><code class="function">disable-sql-reader-syntax</code></a> a couple times in the REPL.
</p><p>See <a class="link" href="file-enable-sql-reader-syntax.html" title="FILE-ENABLE-SQL-READER-SYNTAX"><code class="function">file-enable-sql-reader-syntax</code></a> for an alternative.</p></div></div><div class="refsect1" title="Affected by"><a id="idp10953712"></a><h2>Affected by</h2><p>None.</p></div><div class="refsect1" title="Exceptional Situations"><a id="idp10955056"></a><h2>Exceptional Situations</h2><p>
None.
</p></div><div class="refsect1" title="See Also"><a id="idp10956400"></a><h2>See Also</h2><table border="0" summary="Simple list" class="simplelist"><tr><td><a class="link" href="enable-sql-reader-syntax.html" title="ENABLE-SQL-READER-SYNTAX"><code class="function">enable-sql-reader-syntax</code></a></td></tr><tr><td><a class="link" href="disable-sql-reader-syntax.html" title="DISABLE-SQL-READER-SYNTAX"><code class="function">disable-sql-reader-syntax</code></a></td></tr><tr><td><a class="link" href="locally-disable-sql-reader-syntax.html" title="LOCALLY-DISABLE-SQL-READER-SYNTAX"><code class="function">locally-disable-sql-reader-syntax</code></a></td></tr><tr><td><a class="link" href="restore-sql-reader-syntax-state.html" title="RESTORE-SQL-READER-SYNTAX-STATE"><code class="function">restore-sql-reader-syntax-state</code></a></td></tr><tr><td><a class="link" href="file-enable-sql-reader-syntax.html" title="FILE-ENABLE-SQL-READER-SYNTAX"><code class="function">file-enable-sql-reader-syntax</code></a></td></tr></table></div><div class="refsect1" title="Notes"><a id="idp10964416"></a><h2>Notes</h2><p>
The symbolic SQL syntax is disabled by default.
</p><p>
<span class="application"><span class="emphasis"><em>CLSQL</em></span></span> differs from <span class="application">CommonSQL</span> in that
<code class="function">locally-enable-sql-reader-syntax</code> is
defined as a macro rather than a function.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="disable-sql-reader-syntax.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref-syntax.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="locally-disable-sql-reader-syntax.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">DISABLE-SQL-READER-SYNTAX </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> LOCALLY-DISABLE-SQL-READER-SYNTAX</td></tr></table></div></body></html>
|