2005-08-05 Frank Ch. Eigler <fche@elastic.org>

	PR translator/1175
	* translate.cxx (*): Added unlikely() markers to most emitted error
	checks.
	(mapvar::get,set): Handle NULL<->"" impedance mismatch.
	(itervar::get_key): Ditto.  Use base index=1 for keys.
	* testsuite/buildok/one.stp: Extend.  And it runs with -p5 too.
	* stap.1: Document use of ";" statament as mechanism for grammar
	ambiguity resolution.
	* stp_check.in: Set $prefix.
	* systemtap.spec.in: Prereq kernel-devel, kernel-debuginfo,
	and not tcl.
	* tapsets.cxx: Make slightly less verbose.
	* translate.cxx

1 files changed, 13 insertions, 12 deletions

diff --git a/stap.1 b/stap.1
index b436976e..230f7a9b 100644
--- a/stap.1
+++ b/stap.1
@@ -7,21 +7,21 @@ stap \- systemtap script translator/driver
 .br
 .B stap
 [
-.IR OPTIONS
+.I OPTIONS
 ]
 .I FILENAME
 .br
 .B stap
 [
-.IR OPTIONS
+.I OPTIONS
 ]
-.BI \-
+.B \-
 .br
 .B stap
 [
 .I OPTIONS
 ]
-.BI \-e " SCRIPT "
+.BI \-e " SCRIPT"
 
 .SH DESCRIPTION
 
@@ -64,24 +64,24 @@ kernel object.
 Guru mode.  Enables parsing of unsafe expert-level constructs like
 embedded C.
 .TP
-.BI \-p NUM
+.BI \-p " NUM"
 Stop after pass NUM.  The passes are numbered 1-5: parse, elaborate,
 translate, compile, run.  See the
 .B PROCESSING
 section for details.
 .TP
-.BI \-I DIR
+.BI \-I " DIR"
 Add the given directory to the tapset search directory.  See the
 description of pass 2 for details.
 .TP
-.BI \-R DIR
+.BI \-R " DIR"
 Look for the systemtap runtime sources in the given directory.
 .TP
-.BI \-m MODULE
+.BI \-m " MODULE"
 Use the given name for the generated kernel object module, instead
 of a unique randomized name.
 .TP
-.BI \-o FILE
+.BI \-o " FILE"
 Send standard output to named file.
 
 .SH SCRIPT LANGUAGE
@@ -151,12 +151,13 @@ Execute the string- or integer-valued expression and throw away
 the value.
 .TP
 .BR { " STMT1 STMT2 ... " }
-Execute each statement in sequence in this block.  Note that no
-separators or terminators are necessary between statements.
+Execute each statement in sequence in this block.  Note that 
+separators or terminators are generally not necessary between statements.
 .TP
 .BR ;
 Null statement, do nothing.  It is useful as an optional separator between
-statements to improve the display of syntax-error reports.
+statements to improve syntax-error detection and to handle certain
+grammar ambiguities.
 .TP
 .BR if " (EXP) STMT1 [ " else " STMT2 ]"
 Compare integer-valued EXP to zero.  Execute the first (non-zero)