summaryrefslogtreecommitdiffstats
path: root/stap.1.in
diff options
context:
space:
mode:
authorfche <fche>2007-08-08 03:36:25 +0000
committerfche <fche>2007-08-08 03:36:25 +0000
commit3f99432cc11977a4345c881bed3aa60a1a614238 (patch)
tree70dc99d601a65cec051658402531ba39fa2b2dad /stap.1.in
parent98be953834c60aaa2ae7504890f1cf11815e558a (diff)
downloadsystemtap-steved-3f99432cc11977a4345c881bed3aa60a1a614238.tar.gz
systemtap-steved-3f99432cc11977a4345c881bed3aa60a1a614238.tar.xz
systemtap-steved-3f99432cc11977a4345c881bed3aa60a1a614238.zip
2007-08-07 Frank Ch. Eigler <fche@redhat.com>
PR 4846 * parse.cxx (input_put): New function, sort of like stdio ungetc. (input_get): Skip cursor position changing for input_put strings. (scan): Rework $.../@... substitution into character pasting. * parse.h: Corresponding changes. * util.h (lex_cast_qstring): Octal-quote unprintable characters. * stap.1.in, NEWS: Document new behaviour. 2007-08-07 Frank Ch. Eigler <fche@redhat.com> PR 4846 * parseko/preprocess13.stp, parseok/nineteen.stp, semok/twentyfive.stp: New tests.
Diffstat (limited to 'stap.1.in')
-rw-r--r--stap.1.in14
1 files changed, 7 insertions, 7 deletions
diff --git a/stap.1.in b/stap.1.in
index a35a6ca7..a68a030b 100644
--- a/stap.1.in
+++ b/stap.1.in
@@ -168,7 +168,7 @@ precedence.
Whitespace is ignored. Three forms of comments are supported:
.RS
.br
-.BR # " ... shell style, to the end of line"
+.BR # " ... shell style, to the end of line, except for $# and @#"
.br
.BR // " ... C++ style, to the end of line"
.br
@@ -182,17 +182,17 @@ Integers are 64-bit signed quantities, although the parser also accepts
(and wraps around) values above positive 2**63.
.PP
In addition, script arguments given at the end of the command line may
-be expanded as literals. Use
+be inserted. Use
.B $1 ... $<NN>
-for casting as a numeric literal and
+for insertion unquoted,
.B @1 ... @<NN>
-for casting as string literal. The number of arguments may be accessed
+for insertion as a string literal. The number of arguments may be accessed
through
.B $#
-(as a numeric literal) or through
+(as an unquoted number) or through
.B @#
-(as a string literal). These may be used in all contexts where literals
-are accepted, including preprocessing stage. Reference to an argument
+(as a quoted number). These may be used at any place a token may begin,
+including within the preprocessing stage. Reference to an argument
number beyond what was actually given is an error.
.SS PREPROCESSING