Define entry points within an SFK script, or define locations to jump to with sfk label.
sfk label name [options] +...sfk ... +label name +...
define a label at the beginning or within an sfk script.
a label is a user-defined name that can be jumped to
by the sfk script command.
prefix option-prefix=s set user-defined input parameter name prefix.
by default, parameters passed into sfk scripts are called $1 to $9,
or %1 to %9. with -prefix, you can define your own parameter names,
e.g. if you rewrite the sfk label line like this:
sfk label begin -prefix=$parm
then the input parameters are renamed to $parm1, $parm2, ...
accepting no other names. or simply say
sfk label begin -prefix=%
to accept ONLY %1 to %9 but NOT $1 to $9, to get around conflicts
with script commands using expressions like "$10.10col1".
global options
these options after "label" are global and therefore
valid for all following commands. Use them only
at the first label in a script for clarity.
-var enable use of variables like #(name)
-qtrim automatic reformatting of quoted multi line
parameters depending on target command.
this is default since SFK 1.8.0.
e.g. +echo will keep line ends and some leading
spaces to apply auto indentation, while +xed
will strip all leading spaces and line ends.
see "sfk script" for details.
-qraw do not reformat quoted multi line parameters.
this was default with sfk up to 1.7.7.
since sfk 1.8.0 some old scripts may need:
sfk label labelname -qraw
or via environment variable:
set SFK_CONFIG=qraw-keepdata use old sfk 1.9.2 data passing.
for details see: sfk help chain
for further options see: sfk help opt
options must be given after the label name.
if -prefix is used it must be the first option.
examplessfk batch mytest.bat
creates a windows batch file mytest.bat
with an embedded sfk command script.
sfk batch mytest.sh
creates a linux batch file mytest
with an embedded sfk command script.
see alsosfk script how to run sfk scripts.
sfk if about conditional execution.
sfk goto jump to a local label.
sfk setglobalopt change global options.