diff --git a/twander.1 b/twander.1 index b09ae72..dd21556 100644 --- a/twander.1 +++ b/twander.1 @@ -626,12 +626,12 @@ .IP \(bu 4 While it is true that variables must be defined before they -are referenced, \'twander\' only checks this when a reference -to a variable actually appears - i.e., inside of some command -definition. Bear in mind that User-Defined Variables are simply +are referenced, \'twander\' only checks this when +.B commands are defined. +This is because User-Defined Variables are simply string replacement instructions and do not actually cause a -nested variable to be referenced. This creates an interesting -situtation. You edit your configuration file and add this: +nested variable to be dereferenced. This creates an interesting +situation. You edit your configuration file and add: .nf foo = [BAD-VBL] @@ -837,8 +837,8 @@ .IP \(bu 4 .B [PROMPT:Prompt-String] -[PROMPT:...} allows you to insert an interactive prompt for the user -anywhere you'd like in a command definition. The user is prompted +[PROMPT:...] allows you to insert an interactive prompt for the user +anywhere you'd like in a Command String. The user is prompted with the "Prompt String" and this variable is replaced with their response. If they respond with nothing, it is interpreted as an abort, and the command execution is terminated. This makes commands @@ -854,11 +854,11 @@ # Unix Version -c UnixCP [UnixCopy] [DSELECTIONS] [PROMPT:Please Enter Destination] +c UnixCP [UnixCopy] [DSELECTIONS] [PROMPT:Enter Destination] # Win32 Version -C Win32CP [UnixCopy] [DSELECTIONS] [PROMPT:Please Enter Destination] +C Win32CP [UnixCopy] [DSELECTIONS] [PROMPT:Enter Destination] .fi @@ -871,9 +871,9 @@ ("/" or "\\"). .IP \(bu 4 -User-Defined and Environment Variables are resolved (substituted) +User-Defined and Environment Variables are processed at the time the configuration file is read by \'twander\'. That -is, they are resolved +is, they are handled .B once at load time. @@ -887,7 +887,20 @@ so that any builtin substitions of, say, file names with spaces in them, will be properly recognized by your commands. You can suppress the addition of double-quotes by using the -t command line -option when starting \'twander\' +option when starting \'twander\'. + +.IP \(bu 4 +Any of the variable types may appear multiple times in the +same Command String. For example, suppose you want to +define a generic Unix copy command: + +.nf +g gencopy cp -R [PROMPT:Enter Source] [PROMPT:Enter Destination] +.fi + +When the user presses "g" (or clicks on "gencopy" on the Command +Menu), they will be presented with two prompts, one after the other, +and then the command will run.