txlyre
/
avram


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111
							<html lang="en">
<head>
<title>Parameter Mode Options - avram - a virtual machine code interpreter</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="avram - a virtual machine code interpreter">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="User-Manual.html#User-Manual" title="User Manual">
<link rel="prev" href="Filter-Mode-Options.html#Filter-Mode-Options" title="Filter Mode Options">
<link rel="next" href="Command-Line-Syntax.html#Command-Line-Syntax" title="Command Line Syntax">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
  pre.display { font-family:inherit }
  pre.format  { font-family:inherit }
  pre.smalldisplay { font-family:inherit; font-size:smaller }
  pre.smallformat  { font-family:inherit; font-size:smaller }
  pre.smallexample { font-size:smaller }
  pre.smalllisp    { font-size:smaller }
  span.sc    { font-variant:small-caps }
  span.roman { font-family:serif; font-weight:normal; } 
  span.sansserif { font-family:sans-serif; font-weight:normal; } 
--></style>
</head>
<body>
<div class="node">
<a name="Parameter-Mode-Options"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Command-Line-Syntax.html#Command-Line-Syntax">Command Line Syntax</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Filter-Mode-Options.html#Filter-Mode-Options">Filter Mode Options</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="User-Manual.html#User-Manual">User Manual</a>
<hr>
</div>

<h3 class="section">1.4 Parameter Mode Options</h3>

<p><a name="index-parameter-mode-30"></a>The parameter mode options are listed below. Except as otherwise
noted, any combination of parameter mode options may be selected
together, and except as noted, the settings of these options can be
varied without breaking the application.

     <dl>
<dt><code>-q, --quiet</code><dd><a name="index-g_t_0040code_007bquiet_007d-command-line-option-31"></a><code>avram</code> normally informs the user when writing an output file with
a short message to standard output. This option suppresses such
messages. This option is compatible with any application and any other
parameter mode option except <samp><span class="option">-a</span></samp>. 
<br><dt><code>-a, --ask-to-overwrite</code><dd><a name="index-g_t_0040code_007bask_002dto_002doverwrite_007d-command-line-option-32"></a>Selecting this option will cause <code>avram</code> to ask permission
interactively before overwriting an existing file, and to refrain from
overwriting it without permission, in which case the contents that
were to be written will be lost. This option overrides <samp><span class="option">-q</span></samp> and is
compatible with any other parameter mode option or application. 
<br><dt><code>-.EXT</code><dd><a name="index-g_t_0040code_007bEXT_007d-command-line-option-33"></a><a name="index-default-file-extensions-34"></a><a name="index-extensions-35"></a><a name="index-file-name-extensions-36"></a><a name="index-file-name-suffixes-37"></a>An option beginning with a dash followed by a period specifies a
default extension for input file names. If <code>avram</code> doesn't find a
file named on the command line, and the filename doesn't already
contain a period, <code>avram</code> will try to find a file having a similar
name but with the default extension appended. The default extension given
by this option takes precedence over the hard coded default extensions
of <kbd>.fun</kbd> and <kbd>.avm</kbd>. At most one default extension can be supplied. This
option is compatible with any other parameter mode option and
compatible with any application. 
<br><dt><code>-d, --default-to-stdin</code><dd><a name="index-g_t_0040code_007bdefault_002dto_002dstdin_007d-command-line-option-38"></a><a name="index-standard-input-39"></a>If no filename parameter appears on the command line (other than the
name of the virtual code file), this option directs <code>avram</code> to read
the contents of standard input as if it were specified as a command line
parameter. (Standard input can also be specified explicitly as a
dash. See <a href="Command-Line-Syntax.html#Command-Line-Syntax">Command Line Syntax</a>.) This option is compatible with any
application and any other parameter mode option except <samp><span class="option">-m</span></samp>. 
<br><dt><code>-m, --map-to-each-file</code><dd><a name="index-g_t_0040code_007bmap_002dto_002deach_002dfile_007d-command-line-option-40"></a>Normally <code>avram</code> loads the entire contents of all files named on
the command line into memory so as to evaluate the virtual machine
code application on all of them together. This option can be used to
save memory in the case of applications that operate on multiple files
independently. It causes <code>avram</code> to load only one file at a time
and to perform the relevant evaluation and output before loading the
next one. Application specific options and standard input (if
specified) are read only once and reused. This option is incompatible
with <samp><span class="option">-d</span></samp>, and not necessarily compatible with all applications,
although some may work both with and without it. 
<br><dt><code>-i, --interactive</code><dd><a name="index-g_t_0040code_007binteractive_007d-command-line-option-41"></a><a name="index-interactive-applications-42"></a>This option is used in the case of applications that interact with
other programs through shell commands. An application that is meant to
be invoked in this way requires this option and will not work without
it, nor will applications that are not of this type work with it. This
option is implied by <samp><span class="option">-t</span></samp> and <samp><span class="option">-s</span></samp>, and is compatible with any
other parameter mode option. 
<br><dt><code>-s, --step</code><dd><a name="index-g_t_0040code_007bstep_007d-command-line-option-43"></a>This option is used in the case of applications that interact with
other programs through shell commands, similarly to <samp><span class="option">-i</span></samp>, and
can substitute for it (see above). The option has the additional
effect of causing shell commands issued by <code>avram</code> on behalf of
the application to be written with their results to standard output,
and to cause <code>avram</code> to pause after displaying each shell command
until a key is pressed.  This capability may be useful for debugging
or auditing purposes but does not otherwise alter the effects of the
application.  This option is compatible with any other parameter mode
option. 
<br><dt><code>-t, --trace</code><dd><a name="index-g_t_0040code_007btrace_007d-command-line-option-44"></a>This option is used in the case of applications that interact with
other programs through shell commands, but only by way of the
<code>interact</code> combinator, for which it provides developers a means
of low level debugging, particularly deadlock detection. When this
option is selected, a verbose trace of all characters exchanged
between the functional transducer and the external application are
written to standard output, along with some additional control flow
diagnostics. This option is compatible with any other parameter mode
option. 
<br><dt><code>-p, --parameterized</code><dd><a name="index-g_t_0040code_007bparameterized_007d-command-line-option-45"></a>Normally <code>avram</code> tries to guess whether to operate in filter mode
or parameter mode based on the options used and the parameters. If
there are no parameters and no options, it will default to filter
mode, and try to read standard input. However, if this option is
selected, it will use parameter mode (and therefore not try to read
standard input unless required). 
</dl>

   </body></html>