The Global Search command on the Help menu in PWB lets you search all open Help files for a string of text or a regular expression. All text in the Help files is searched, not just the topic names. A global search results in a list of topics, each of which contains text that matches the search string. QuickHelp can also perform global Help searches but does not offer regular-expression matching.
Searching all the Help can take a long time. Therefore, it is recommended that you use the Global Search command only after you have tried other methods of finding the information you need.
When you choose the Global Search command, PWB displays the Global Search dialog box where you can specify options for the search. Enter the string or pattern you want to locate in the Find Text box. If you want the search to be case sensitive, turn on the Match Case option. To match a regular expression rather than literal text, turn on the Regular Expression option.
Regular expressions allow you to specify general patterns of text or several alternative strings to match. The current regular-expression syntax is displayed in parentheses after the Regular Expression option. For more information about searching with regular expressions, see Chapter 5, “Advanced PWB Techniques,” and Appendix A.
When you choose OK, PWB starts searching for the specified string or regular expression. The search begins with the Help file that was opened most recently. Because the search can take a long time, it is recommended that you choose a likely category of Help from the global Contents screen before starting a global search.
When you start a global search, PWB displays a dialog box that shows the progress of the search. Choose the Stop Search button at any time to stop the search and view the partial results. When the search ends, PWB displays a list of matching topics.
When the search is finished, or when you halt the search by choosing Stop Search, PWB displays a list of the topics that contain text that matches the specified string. Each topic is represented by its title if it has one, followed by the name of the database that contains the topic, and sometimes followed by the topic name.
·To select a topic from the list:
Click the right mouse button on the line. -or-Press the UP ARROW and DOWN ARROW keys until the topic is highlighted, and then press ENTER or F1.
PWB displays the selected topic. If that topic does not supply the information that you need, go back to the list and select another topic.
·To go back to the list:
Choose Search Results from the Help menu. -or-Press ALT+F1 until the list is displayed.
By default, PWB performs a global search in all open databases. There are several ways to control which databases are searched:
Before the search, display Help from the database that is most likely to contain the information you want. When you run the search, choose Stop Search when the dialog box indicates that the first database has been searched.
Close some databases by using the Meta form of the SetHelp function.
Set the HELPFILES environment variable to the file or files to be searched by using the Environment Variables command on the Options menu. The list of files cannot exceed the MS-DOS limit of 128 characters.
Note that the changes you make to HELPFILES may be restored the next time you start PWB or use the project, depending on the settings of the Envcursave and Envprojsave switches.
Choose the Editor Settings command from the Options menu. Then select PWBHELP as the Switch Owner and Text as the switch type. Assign a value to the Helpfiles switch to open other Help files in addition to the ones listed in the HELPFILES environment variable.
To see a list of all open Help files and databases, execute the Arg ? SetHelp command. The default keystrokes for this are ALT+A, ?, SHIFT+CTRL+S. The resulting list of physical Help files and Help databases is displayed in the Help window.