From 3f99432cc11977a4345c881bed3aa60a1a614238 Mon Sep 17 00:00:00 2001 From: fche Date: Wed, 8 Aug 2007 03:36:25 +0000 Subject: 2007-08-07 Frank Ch. Eigler 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 PR 4846 * parseko/preprocess13.stp, parseok/nineteen.stp, semok/twentyfive.stp: New tests. --- stap.1.in | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) (limited to 'stap.1.in') 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 ... $ -for casting as a numeric literal and +for insertion unquoted, .B @1 ... @ -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 -- cgit