documentation - full text search useful?

[Wilhelm Sanke]

On Sun, 1 Jun 2003  Marian Petrides <mpetrides at earthlink.net> (and
Bernard)  wrote:

I, for one, would appreciate the ability to keyword search the dox.
One of helpful thing that the printed dox (for 1.1 anyway) lack is an
index--and keyword searchability would help in this regard--although I
personally still prefer to work on my computer, while referring to
printed dox.

Marian
On Sunday, June 1, 2003, at 07:46 AM,
revolution at knowledgeworks.plus.com wrote:

(snip)
> As an example of what this would achieve: I exported the entire
> documentation set to my hard disk, and searched for the word 'memory'
> (just a word chosen at randdom).  I found 110 hits, but browsing
> through the documentation I could only find two or three.  Admittedly,

> some of my hits will be cross-references, but still I think this would

> provide quite an exhaustive way for people to be able to trawl through

> the documentation.
>
> Regards,
> Bernard

Have a look at the stack "Topsearch" stack under "user contributions" on
the Revolution site. "Topsearch" has an extra button that allows a quick
search for any string in all the cards of the Transcript Dictionary

There will be a new version of this stack out by the middle of this
week.

Here is the text approximate text of the information field for the new
version:

"This stack searches all visible and hidden fields on all cards of the
current topstack. The search routine uses the "lineOffset" function to
search for *any* searchstring, which means it does not explicitly search
for words or items. The searchstring "layer" would also display all
lines that contain "player", so if you are searching only for "layer"
press the spacebar once before typing "layer" into the dialog.

The results are listed with the searchstring colorized and the addresses
of the found fields.
Clicking at the address brings up the card of the topstack with the
found fields.

The clicked address line is then colorized green and a button "show full
text of field" appears.This button allows to open a field at the bottom
of the stack that displays the complete formatted text of the selected
field  - again with all instances of the searchstring colorized. This
may be especially helpful also when dealing with hidden fields.

If you have several stacks open, this search stack recognizes which of
these stacks is the topstack when you perform a search. As the
searchstring is stored in the dialog, you can quickly search several
stacks for the same string when you make them the respective topstack by
clicking at a stack.

A special button allows searches of the "Transcript Dictionary" in the
Revolution environment."

Regards,
Wilhelm Sanke