D&Do v. 1.0 Prev Next Top
The D&Do behavior is specified by the following parameters: (all are Boolean, except the first one):
- BB:
Basic Behavior number, it contains a digit character that represents the behavior number as identified on the table under the Target Area section. Accepted digits are from 0 to 8. Any character outside the range, or the absence of this parameter, is interpreted as a value of 0 (invalid) for that parameter.
- DTMP:
Temporary file for drops (this is a commercial feature). If set to 1, build a temporary file that will contain the list of untagged drops (one line per drop). That file will be located in the tmp subdirectory with the same name as the related metascript but with the ".tmp" extension. That file name (with relative path) will be inserted into the argument list by replacing the *# character pattern of the related template. The program or script should interpret the argument as a file name. If set to 0, the untagged drops of the list will be provided to the program or script as being part of the command line. If, also, BB is 4, 6 or 7 (the list of untagged drops is provided; not one by one), such setting works correctly if the program or script expects a variable number of arguments as its last argument. Default value is 0.
- DKOTE:
Quote each untagged drop item. If set to 1 and if DTMP is set to 0, each untagged drop content is automatically put between double quotes before being part of the argument list, replacing the *# template variable. If set to 1 and if DTMP is set to 1, the temporary file name is put between quotes, replacing the *# template variable. If set to 0, the drop content is used as it is. Default value is 0.
- CKOTE:
Quote clipboard text content. If set to 1, the system clipboard content is automatically put between double quotes before being part of the argument list. If set to 0, the system clipboard content is used as it is. Default value is 0.
- SOUT:
Can access System output; also known as the print output or normal output. If set to 1, the normal program output is collected by D&Do. If set to 0, the normal program output is ignored. See Note below.
- OUTC:
Normal output to clipboard. If set to 1, the collected program output is put to the system clipboard. If set to 0, the system clipboard is left unmodified. Default value is 1. See Note below.
- DCLR:
Clear drops once D&Do has completed its task. If set to 1, the drop list is automatically cleared once the D&Do activity has completed. If set to 0, the list of drops is cleared only when the "Clear List" menu item has been selected or when the associated key has been typed (usually, the "x" key). Default value is 0. Note: If BB:2 or BB:8, ("Express" types basic behaviors), the drop list is automatically cleared once the D&Do activity has completed (with or without an error), whatever this setting.
- TOP:
Reserved word without an associated feature.
Note: Normally SOUT and OUTC have the same value. There are situations, however, where it is impractical to access the normal program output. You can write the program (or specify an argument list template) in such way that it outputs into a predefined temporary file. This file should have the same name as the related metascript but, with the ".out" extension instead. It should be placed in the tmp subdirectory. D&Do will attempt to read this file as if it was reading the normal program output and writes its content into the system clipboard. For that purpose, the parameters settings should be: SOUT:0, OUTC:1. The last possible combination (SOUT:1 and OUTC:0) might be useful for diagnostic purposes when D&Do is started from a DOS/Shell box, otherwise, that will just waste some processor resources.
Note: This temporary file creation and/or access is a commercial feature; it is not accessible in the freeware version of D&Do.
Here are a few examples of resolved argument list from the argument list template:
myscript.bas *0 *# -P
Take note that the *0 template variable is not put between double quotes.
First tagged drop: Hell
First untagged drop: is hot
Second untagged drop: has devils
The metascript name is: myMetascript
- With: DKOTE:0, DTMP:0, BB:6
The resolved argument list becomes:
myscript.bas Hell is hot has devils -P
- With DKOTE:1, DTMP:0, BB:6
The resolved argument list becomes:
myscript.bas Hell "is hot" "has devils" -P
- With DKOTE:1, DTMP:1, BB:6
The resolved argument list becomes:
myscript.bas Hell "tmp\myMetascript.tmp" -P
The output file contains the following lines:
is hot
has devils
- With DKOTE:1, DTMP:0, BB:7
It handles non tagged drops one by one. The resolved argument list for the first command is:
myscript.bas Hell "is hot" -P
then, for the second command, it is:
myscript.bas Hell "has devils" -P
Prev Next Top
Copyright (c) 2003 Marcel St-Amant