[Tcl-bugs] [ tcl-Bugs-1526581 ] Documentation of [expr]: fix all braceless examples

[SourceForge.net <no...@so...>]

Bugs item #1526581, was opened at 2006-07-21 18:06
Message generated for change (Comment added) made by tallniel
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=110894&aid=1526581&group_id=10894

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
>Category: 75. Tutorial
Group: current: 8.4.13
Status: Open
Resolution: None
Priority: 5
Submitted By: Andreas Leitgeb (avl42)
>Assigned to: Donal K. Fellows (dkf)
Summary: Documentation of [expr]: fix all braceless examples

Initial Comment:
Fix all examples for expr that idly do not use
braces, by enclosing the arguments in a pair of
braces.

For those examples that only work unbraced
(e.g. subexpression or operator in variable)
combine braced parts with unbraced parts, and
mention their exceptional nature.

Make it absolutely clear that one should
always think "braces" first.  Make it clear
that passing unknown arguments to expr outside
of braces is just as dangerous as passing them
to eval.


----------------------------------------------------------------------

>Comment By: Neil Madden (tallniel)
Date: 2006-07-22 15:38

Message:
Logged In: YES 
user_id=102050

I've fixed the tutorial so that all uses of expr/if/etc are
properly braced, and added a warning box to the expr page
explaining why you should always brace expressions. There
are a couple of places in the tutorial that specifically
show what happens when you don't brace expressions, so I
have left those as they are.

I only have responsibility for the tutorial, so I am
reassigning this bug to dkf in case he wishes to check the
man-pages too. :)

----------------------------------------------------------------------

Comment By: Andreas Leitgeb (avl42)
Date: 2006-07-21 18:46

Message:
Logged In: YES 
user_id=830354

PS:

"documentation" primarily means 
man-pages, help-pages, what is shipped
with tcl-core.  Of course it can be widened
to any bit of documentation that is within
any maintainer's reach, but that's probably
too much for one bug-report :-)

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=110894&aid=1526581&group_id=10894