#set TITLE = "general interpreter settings"
#include top

.SH General interpreter settings
The \fC#mode\fR directive can be used to make general
settings that affect how the QUISP template interpreter behaves.

#include space

.SH #mode
Set various operational modes.
.LP
Usage: \fC#mode  \fIattribute\fR  \fIvalue\fR

.LP
\fIattribute\fR may be one of the following:

// .IP
// \fBallowinlinecodes\fR
// .IP
// If \fIvalue\fR is \fCyes\fR, evaluate 
// #set FILE = inlinecodes.html
// #set TAG = "inline codes
// #include link
// found in script content.
// Example: \fCallowinlinecodes yes\fR

#include space2
.LP
\fBerror_mode\fR
.IP
Default is \fCstderr\fR, so that error messages are written to standard error.
This may be set to \fCstdout\fR for error messages to be written to standard output.

#include space2
.LP
\fBdot_in_varnames\fR
.IP
Specifies whether variable names may contain periods (.).
Default is \fCyes\fR, which is convenient with SQL applications since join
results are named using a period.
.br
Example: \fC#mode  dot_in_varnames  no\fR

#include space2
.LP
\fBevalvars\fR 
.IP
Default is \fCyes\fR.  Use \fCno\fR to turn off evaluation of variables.
.br
Example: \fC#mode  evalvars  no\fR

// .LP
// \fBlistsep\fR
// .IP
// \fIvalue\fR should be the separator character used for
// #set FILE = commalist.html
// #set TAG = commalists
// #include link
// \0.  The default, of course, is comma, but any non-whitespace
// character may be used for situations where comma is not feasible.
// Example: \fClistsep ~\fR 

#include space2
.LP
\fBnullrep\fR
.IP
This determines how NULL database fields will be represented.
Allowable values are \fCblank\fR, \fCnull\fR, \fCnbsp\fR, and \fCnoconvert\fR.
The default is \fCblank\fR which causes NULLs to be converted to zero length strings.
Use \fCnbsp\fR to convert NULLs to the HTML non-breaking space character \fC&nbsp;\fR
This should be invoked before result rows are fetched.
Conversion occurs after the row is retrieved from the database.
.nf
#mode nullrep blank      ""   (the default)
#mode nullrep null       null
#mode nullrep nbsp       &nbsp;
#mode nullrep noconvert
.fi
Example: \fC#mode  nullrep  nbsp\fR

#include space2

.LP
\fBshellmetachars\fR
.IP
This specifies the set of characters that are to be screened out of
variables that are present when building a shell command
(see the opening paragraphs of the
#set FILE = "shell.html"
#set TAG = "#shell man page"
#include link
).  There should be no embedded whitespace.
This can also be set in the
#set FILE = "config.html"
#set TAG = "project config file"
#include link
.br
Default set of shell metacharacters is: \fC"'`$\\;\fR
.br
Example: \fC#mode shellmetachars "'`\fR


// .LP
// \fBsuppressdll\fR
// .IP
// \fIvalue\fR should be \fCyes\fR to suppress data-less lines, and \fCno\fR
// to show data-less lines.  Default is \fCno\fR.  
// A data-less line is a line
// having one or more variables, all of which evaluate to a zero-length value.
// Suppressing data-less lines is sometimes useful, for example, when displaying
// multi-line entities such as postal addresses.

#include space

.SH Database mode settings
See also the 
#set FILE = "../../sqlman/html/shsql_handbook.html"
#set TAG = "shsql"
#include link
SQLMODE command, which can be used to make certain database-specific settings.



#include space 

#include bottom
