HELP issue: ON command

May 20, 2008
3,515
4
Elkridge, MD, USA
Several minor issues were created when ON was expanded from its two original modes (BREAK, ERROR[MSG]). Below I refer to each section of the HELP page which has a subtitle as a "subtopic".

1/ "Usage" subtopic
Needs to be expanded to indicate that each mode creates an independent watch.

2/ Cancellation
This issue should now be its own subtopic. It is currently addressed in the Scope subtopic, but only for the above listed original modes. Presumably each mode behaves like the original ones: to cancel ON for that mode for the remainder of the batch file one inserts the command "ON mode" into the batch file. It is not clear whether or not canceling ON ERRORMSG also cancels ON ERROR and vice versa. Alternately, like the DO command, cancellation forms should be in the

3/ All mouse button modes
Unclear whether or not these are focus-dependent, i.e., if the relevant mouse button is activated when another window has focus, will the command in the ON be executed?

4/ "ON ERRORLEVEL" subtopic
The default test for ERRORLEVEL in conditional expressions is GE. Is this command different, defaulting to EQ as the text states, or is that an error, the actual default is GE, and the example's implication that one must specify EQ explicitly if that is desired correct?

5/ "Format" subtopic
5.1/ "ON DBLCLICK [test command]" is presumably wrong, the word "test" should not be present.
5.2/ test field should be described, or at least referred to here to be consistent with other commands in HELP

6/ "Activation of ON CONDITION"
It is unclear whether or not multiple ON CONDITION watches with different conditions can be activated at the same time, or only a single condition can be monitored.
--
Steve
 
4/ "ON ERRORLEVEL" subtopic
The default test for ERRORLEVEL in conditional expressions is GE. Is this command different, defaulting to EQ as the text states, or is that an error, the actual default is GE, and the example's implication that one must specify EQ explicitly if that is desired correct?
See http://jpsoft.com/forums/showthread.php?t=2671

I think the Help should also explain that various internal commands will trigger ON ERRORLEVEL, even when they aren't producing an error.
 

rconn

Administrator
Staff member
May 14, 2008
12,344
149
3/ All mouse button modes
Unclear whether or not these are focus-dependent, i.e., if the relevant mouse button is activated when another window has focus, will the command in the ON be executed?

Not unless Windows process security has utterly failed.

4/ "ON ERRORLEVEL" subtopic
The default test for ERRORLEVEL in conditional expressions is GE. Is this command different, defaulting to EQ as the text states, or is that an error, the actual default is GE, and the example's implication that one must specify EQ explicitly if that is desired correct?

The documentation is correct. (It's worked that way for 20 years.)

6/ "Activation of ON CONDITION"
It is unclear whether or not multiple ON CONDITION watches with different conditions can be activated at the same time, or only a single condition can be monitored.

Only one, like the others.
 
Similar threads
Thread starter Title Forum Replies Date
Alpengreis Documentation Minor issue in help file for view /E Support 1
A Documentation [Help file] OPTION "//" synopsis formatting issue Support 0
Chen Touboul Overtyping issue - i press the Insert key, help till press enter for new line in TCC Support 2
H Very odd issue with Help in 12.10.67 Support 3
C Add link to ewriter help to program group... Support 3
samintz How to? Search for %(command) in Help? Support 1
Joe Caverly Favorites in eWriter Help Support 6
Joe Caverly Quick Search in eWriter Help Support 1
vefatica Online help? Support 2
fishman@panix.com HELP!! I just updated to Version 28 and as usual I cannot make extended directory search work. Support 2
JohnQSmith New online help file wrong logo Support 7
Jay Sage Documentation Function @DRIVE Missing in Help Lists Support 0
Charles Dye More help nits Support 0
D Documentation Typo in COPY help Support 0
FreezerBurnt Help making a CMD and TCC compatible batch file Support 7
Joe Caverly Documentation COMMANDS in Version 27 help Support 8
K_Meinhard How to? Help window position Support 7
U Command help on file names Support 5
D Documentation Help "Startup" page does not describe global lists Support 0
vefatica Help disappears? Support 6
rchapmanitt Help Purchasing Support 2
Charles Dye Documentation Help nits: @ZIPFILECRC Support 0
C version help Support 3
C Documentation Help Nit. REN / RENAME Support 0
Dmitry L. Kobyakov Documentation Error in the Help: the WINDOW command Support 0
vefatica Help for @PID Support 2
vefatica Need help with XML Support 3
R Documentation Advanced Directives Help Support 0
R Documentation Help Nit with SETP Support 0
R wmic command help Support 9
R Documentation Help Nit > bdebugger View Menu Support 0
R Documentation A couple of Help nits Support 0
R Documentation Help typo Support 1
MikeBaas How to? I need help with RD Support 5
R Documentation v25 Help Comments Support 1
Joe Caverly DIRectory Colorization in v25 Help File Support 0
vefatica Help nit Support 0
D error in help documentation? Support 0
Joe Caverly _EXPANSION in help file Support 0
K_Meinhard Help file error Support 1
Joe Caverly JOBMONITOR in Help File Support 1
D The local HELP viewer... Support 0
C Documentation Help nix ZIP /M Support 0
Joe Caverly v24 Help File - DATEMONITOR Support 1
Joe Caverly 7zip command links to zip help Support 0
K_Meinhard Help problems Support 3
Charles Dye Documentation Help Nits Forever: Checksum functions Support 0
Joe Caverly SAVECONSOLE in Help File Support 0
Joe Caverly CMDebug v23 Help: /FEEDBACK /UPDATE Support 0
Joe Caverly CMDebug v23 Help: Link to MOUNTVHD goes to MOUNTISO in UNMOUNTVHD Support 0

Similar threads