SafeChars plugin

May 20, 2008
3,515
4
Elkridge, MD, USA
Charles:
I'd like to suggest improvements in the dynamic help.
1/ Replace "Press a key:" with "Press any key to exit." If the text is from
Rex, need to ask him to make the change.
2/ Add summary documentation, invoked by any one of the following commands:
HELP SAFE
HELP SAFECHAR
HELP SAFECHARS
HELP @SAFE
HELP @SAFECHAR
HELP @SAFECHARS
The summary should enumerate the available features by category. If the
underlying display engine permits it, "clicking" on any feature should bring
up its help. It should also include the translation table.
3/ Add to @SAFEEXP and @SAFEENV help that @SAFEEXP is the one to be used for
array elements, not @SAFEENV.
Is there a simple way to switch back to the original ("unsafe") version
of the string, without preserving both the original and its safe version?
BTW, I use the 2010-06-28 version. The associated HTML file display
width does not scale when the Firefox window is made narrower. Even when
opened when Firefox is already open, it only displays the left part of the
text, WITHOUT horizontal scroll bar. I also recommend returning to the
traditional indented paragraphs, because they require less white space to
separate paragraphs (instead of a full line only the indentation), and they
more clearly indicate when non-paragraph material (e.g., a table or source
code) is included whether the previous paragraphs is continued or a new
paragraph starts. Another of my pet peeves is referring to a "quotation
mark" as a "double quote". A real "double quote" is when I quote something
that already includes a quotation, and is something like this: "He said -
and I quote - 'That is nonsense!'". We should not propagate the
misinformation of the sixties!
--
Steve
 

Charles Dye

Super Moderator
Staff member
May 20, 2008
4,461
88
Albuquerque, NM
prospero.unm.edu
Charles:
I'd like to suggest improvements in the dynamic help.
1/ Replace "Press a key:" with "Press any key to exit." If the text is from
Rex, need to ask him to make the change.

Trivial enough....

2/ Add summary documentation, invoked by any one of the following commands:
HELP SAFE
HELP SAFECHAR
HELP SAFECHARS
HELP @SAFE
HELP @SAFECHAR
HELP @SAFECHARS
The word after HELP is passed to the plugin which offers a matching command/function/variable. Since this plugin doesn't have any commands or functions by those names, I'd never see the text. (Short of ugliness like hooking the HELP command; bleah.)

But I think what you're really asking for is a proper .CHM help file, instead of the ASCII silliness in the current plugin. Time consuming but not difficult, since the docs are already in HTML; maybe.

3/ Add to @SAFEEXP and @SAFEENV help that @SAFEEXP is the one to be used for array elements, not @SAFEENV.
Right enough.

Is there a simple way to switch back to the original ("unsafe") version
of the string, without preserving both the original and its safe version?
Redirected ECHO, with UnicodeOutput off? (What else could you do with it?)

BTW, I use the 2010-06-28 version. The associated HTML file display
width does not scale when the Firefox window is made narrower. Even when opened when Firefox is already open, it only displays the left part of the text, WITHOUT horizontal scroll bar.
Hold down the Control key while turning the scroll wheel on the mouse. (I spent hours adding that feature to my doc file; hope you enjoy it.)

Another of my pet peeves is referring to a "quotation
mark" as a "double quote". A real "double quote" is when I quote something that already includes a quotation, and is something like this: "He said - and I quote - 'That is nonsense!'". We should not propagate the
misinformation of the sixties!
The double quote being the part enclosed in single quotation marks; the part only in double quotation marks is a single quote. I get you. But the usage in my docs matches Rex's in the Take Command documentation; see HELP QUOTING for example. Sometimes overmuch accuracy gets in the way of understanding....
 
Similar threads
Thread starter Title Forum Replies Date
M How to? Use SafeChars plugin... Plugins 2
dcantor Error in SAFECHARS plugin v 1.9.0 Plugins 2
M SafeChars plugin misbehaving... Plugins 3
dcantor Suggestion for SafeChars plugin Plugins 7
M Charles, I just installed the "new" SafeChars plugin, ... Plugins 5
M A problem with the SafeChars Plugin... Plugins 30
M A (presumbly pretty simple) SafeChars plugin request... Plugins 2
M A "SafeChars" plugin request... Plugins 2
Charles Dye New plugin: SafeChars Plugins 15
thedave SafeChars: Escaped version of @unsafe Plugins 7
S How to? SafeChars.dll question Plugins 4
Stefano Piccardi SafeChars thank you Plugins 2
Joe Caverly 64-bit Plugin development using PureBasic Plugins 15
R New Plugin Plugins 0
Alpengreis elevated plugin questions Plugins 3
fpefpe utf-8 support in sdk/plugin api Plugins 4
S How to? Can @DU function in 4Utils64 plugin somehow cater for dirs with spaces? Plugins 3
vefatica Plugin access to arrays? Plugins 4
vefatica How big is a plugin's parameter buffer? Plugins 5
C @knownpath plugin Plugins 0
Charles Dye Updated OSD plugin Plugins 0
Joe Caverly C# plugin framework for JPSoft's TCC Plugins 0
dcantor Help for newest version of TEXTUTILS plugin Plugins 10
dcantor UISTUFF plugin missing help topic Plugins 12
dcantor Request for documentation for ISO8601 plugin Plugins 4
vefatica Possible with a plugin? Plugins 6
dcantor Inconsistency between textutils plugin and wrap utility Plugins 2
M (Stupid?) Problem with 64-bit 4Utils plugin... Plugins 3
H Latest ISO8601 plugin? Plugins 1
Charles Dye New plugin: QKeys Plugins 34
S Plugin to quickly locate all files hard linked together Plugins 5
S Documentation Plugin everything.dll Plugins 5
newbie How to? Multi-plugin installation errors, Re: FedUtils8 Plugins 7
vefatica Plugin -> thread -> Command() -> Ctrl-C? Plugins 20
Charles Dye A weirdoid plugin question Plugins 6
M A weird error re a plugin... Plugins 0
vefatica Plugin dilemma Plugins 2
fpefpe Documentation Plugin API/SDK Plugins 3
C Looking for Vince's old 4UTILS plugin for TCMD v8 Plugins 1
S DESKTOP plugin - anyone ? Plugins 0
C How to? a plugin to sort Outlook Express "rules" Plugins 0
M ISO Plugin: Yes, it's wonderful, but it could be yet more wonderful... Plugins 7
M The ISO plugin is wonderful, but it lacks a little something... Plugins 22
Charles Dye Beta plugin: HidePasswords Plugins 3
M ISO8601 Plugin not "reporting" errors to TCC... Plugins 4
Frank 4console plugin Plugins 4
S WAD ISO8601 Plugin Plugins 15
Joe Caverly Plugin and 64-bit TCC Plugins 3
C Problem with FixNames plugin Plugins 9
dcantor Suggestion and request for DBF plugin Plugins 6

Similar threads