<html> <head> <!-- This file has been generated by unroff 1.0, 03/11/09 12:56:17. --> <!-- Do not edit! --> <STYLE TYPE="text/css"> <!-- A:link{text-decoration:none} A:visited{text-decoration:none} A:active{text-decoration:none} OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; } H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; } H2 { font-size: large; font-family: arial,helvetica,sans-serif; } H3 { font-size: medium; font-family: arial,helvetica,sans-serif; } H4 { font-size: small; font-family: arial,helvetica,sans-serif; } --> </STYLE> <title>ploticus: general interpreter settings</title> <body bgcolor=D0D0EE vlink=0000FF> <br> <br> <center> <table cellpadding=2 bgcolor=FFFFFF width=550><tr> <td> <table cellpadding=2 width=550><tr> <td><br><h2>general interpreter settings</h2></td> <td align=right> <small> <a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br> Version 2.41 Mar2009 <td></tr></table> </td></tr> <td> <br> <br> <title>Manual page for general_interpreter_settings(PL)</title> </head> <body> <h2>General interpreter settings</h2> The <tt>#mode</tt> directive can be used to make general settings that affect how the QUISP template interpreter behaves.<tt> </tt> <br><br><br> <h2>#mode</h2> Set various operational modes.<tt> </tt> <p> Usage: <tt>#mode </tt><i>attribute</i> <i>value</i> <p> <i>attribute</i> may be one of the following: <p> <b>allowinlinecodes</b> <dl> <dt><dd><p> If <i>value</i> is <tt>yes</tt>, evaluate <a href="inlinecodes.html"> inline codes </a> found in script content. These are formatting codes particular to this software, that are useful in certain specialized formatting operations.<tt> </tt> Example: <tt>allowinlinecodes yes</tt> <br><br> </dl> <p> <b>error_mode</b> <dl> <dt><dd><p> Default is <tt>stderr</tt>, so that error messages are written to standard error.<tt> </tt> This may be set to <tt>stdout</tt> for error messages to be written to standard output.<tt> </tt> <br><br> </dl> <p> <b>dot_in_varnames</b> <dl> <dt><dd><p> Specifies whether variable names may contain periods (.).<tt> </tt> Default is <tt>yes</tt>, which is convenient with SQL applications since join results are named using a period.<tt> </tt> <br> Example: <tt>#mode dot_in_varnames no</tt> <br><br> </dl> <p> <b>evalvars</b> <dl> <dt><dd><p> Default is <tt>yes</tt>. Use <tt>no</tt> to turn off evaluation of variables.<tt> </tt> <br> Example: <tt>#mode evalvars no</tt> <br><br> </dl> <p> <b>nullrep</b> <dl> <dt><dd><p> This determines how NULL database fields will be represented.<tt> </tt> Allowable values are <tt>blank</tt>, <tt>null</tt>, <tt>nbsp</tt>, and <tt>noconvert</tt>.<tt> </tt> The default is <tt>blank</tt> which causes NULLs to be converted to zero length strings.<tt> </tt> Use <tt>nbsp</tt> to convert NULLs to the HTML non-breaking space character <tt>&nbsp;</tt> This should be invoked before result rows are fetched.<tt> </tt> Conversion occurs after the row is retrieved from the database.<tt> </tt> <pre> </pre> Example: <tt>#mode nullrep nbsp</tt> <br><br> </dl> <p> <b>shellmetachars</b> <dl> <dt><dd><p> 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 <a href="shell.html"> #shell man page </a> ). There should be no embedded whitespace.<tt> </tt> This can also be set in the <a href="config.html"> project config file </a> <br> Default set of shell metacharacters is: <tt>"'`$\;</tt> <br> Example: <tt>#mode shellmetachars "'`</tt> </dl> <p> <b>suppressdll</b> <dl> <dt><dd><p> <i>value</i> should be <tt>yes</tt> to suppress data-less lines, and <tt>no</tt> to show data-less lines. Default is <tt>no</tt>. A data-less line is a line having one or more variables, all of which evaluate to a zero-length value.<tt> </tt> Suppressing data-less lines is sometimes useful, for example, when displaying multi-line entities such as postal addresses.<tt> </tt> <br><br><br> </dl> <h2>Database mode settings</h2> See also the <a href="../../sqlman/html/shsql_handbook.html"> shsql </a> SQLMODE command, which can be used to make certain database-specific settings.<tt> </tt> <br><br><br> <br> <br> </td></tr> <td align=right> <a href="../doc/welcome.html"> <img src="../doc/ploticus.gif" border=0></a><br><small>data display engine <br> <a href="../doc/Copyright.html">Copyright Steve Grubb</a> <br> <br> <center> <img src="../gallery/all.gif"> </center> </td></tr> </table> <br> <center> <table><tr><td> Ploticus is hosted at http://ploticus.sourceforge.net</td><td> </td><td> <a href="http://sourceforge.net/projects/ploticus"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=38453&type=12" width="120" height="30" border="0" alt="Get ploticus data display engine at SourceForge.net. Fast, secure and Free Open Source software downloads" /></a> </td></tr></table> </center> <p><hr> Markup created by <em>unroff</em> 1.0, <tt> </tt> <tt> </tt>March 11, 2009. </body> </html>