Best Objectech Shareware Selections

home *** CD-ROM | disk | FTP | other *** search

/ Best Objectech Shareware Selections / UNTITLED.iso / boss / word / misc / 013 / readme.dts < prev next >

Wrap

Text File | 1992-05-24 | 19.3 KB | 440 lines

May 25, 1992 d t S e a r c h 1.12 How to install dtSearch: * If you have the registered version, please follow the directions in the manual. * If you have the shareware version, there may be included an "INSTALL.EXE" file. This just creates a directory to hold the dtSearch program files and executes the self- extracting archive file DTSRCH.EXE. If you have INSTALL.EXE, you can use it to install dtSearch. If not, just unpack the files into a directory on your hard disk. dtSearch includes the following files: File Name Purpose of File: ------------ --------------------------------------------------- DTSEARCH.DOC Printable copy of the dtSearch manual DTSEARCH.EXE The dtSearch program DTSEARCH.HLP The hypertext help database for dtSearch DTSEARCH.MNU A menu data file for dtSearch DTS_SAFE.MNU An alternative menu data file for dtSearch DTSEARCH.NOI List of "noise" words for dtSearch DTSEARCH.REG A screen data file for dtSearch (registered version only) DTSEARCH.SCR A screen data file for dtSearch ORDER.DTS Registration information and order form README.DTS Important last-minute information SITELICE.DTS Site license information and agreement UPGRADE.DTS Version history and upgrade information VENDOR.DTS Information and restrictions for disk vendors, distributors, BBS sysops, user groups, etc. - 2 - Upgrade Information From version 1.0: Document indexes and setup files created with dtSearch 1.0 will not work properly with version 1.12. Although version 1.12 can read indexes created with version 1.0, using version 1.12 to search for documents in an index created with version 1.0 may result in incorrect words being highlighted as "hits" when documents are retrieved. Therefore, if you are upgrading from version 1.0, you should delete all of the version 1.0 files and indexes and reindex your documents. From version 1.1 or version 1.11: Version 1.12 is compatible with versions 1.1 or 1.11. You can upgrade to version 1.12 by simply installing the files from this version into your DTSEARCH directory. Do not delete the existing dtSearch files. If you are a registered user of an earlier version of dtSearch, you do not have to register version 1.12. You can simply install the shareware version of dtSearch 1.12 in your DTSEARCH directory. The only difference between the shareware version of dtSearch and the registered version is the DTSEARCH.REG file, which suppresses the registration reminder screen. The DTSEARCH.REG file included in your registered dtSearch package will work with version 1.12. Therefore, all you have to do to upgrade is to install the new version of dtSearch in your DTSEARCH directory. Some very minor changes in the way dtSearch counts words in documents were made in version 1.12. If you notice that dtSearch is highlighting the wrong words as hits when it displays a retrieved document, you should delete your existing indexes and reindex your documents with version 1.12. Most users should not need to do this. - 3 - dtSearch 1.12 Supplemental Documentation May 25, 1992 A. Tips for faster indexing * Give dtSearch as much conventional memory as you can. dtSearch is designed to be able to run with very little memory available -- as little as 384k. However, it runs most efficiently with plenty of memory. * Use a hard disk cache, such as Central Point Software's PC-CACHE or Microsoft's SMARTDRV.SYS. A hard disk cache is a program that makes your hard disk seem faster by storing recently-used data in memory so it can be accessed again quickly. dtSearch runs much faster with a hard disk cache. B. DESQview Support Use the following DESQview parameters to run dtSearch in a DESQview window: Memory Size (in K): 384 Options: Writes text directly to screen.........: [N] Displays graphics information..........: [N] Virtualize text/graphics (Y,N,T).......: [Y] Uses serial ports (Y,N,1,2)............: [N] Requires floppy diskette...............: [N] C. Limited Access Menu dtSearch 1.12 includes an alternative menu file DTS_SAFE.MNU, which only allows users to perform indexed searches and view the results of searches. The purpose of the limited access menu is to provide a way for network administrators and bulletin-board operators to give their users simplified and limited access to document indexes. To run dtSearch using this menu, enter the command: DTSEARCH /MENU DTS_SAFE.MNU This menu will allow users to: (1) perform indexed searches; (2) view results of prior searches; (3) create search reports; (4) select index libraries; and (5) print the contents of a window. Indexing features, the notepad editor, directory browsing, and unindexed searches are unavailable to a user running dtSearch with this menu. - 4 - D. The NOT and NOT W/N search connectors (NOTE: This section supplements Chapter 6 of the User's Manual, which describes search requests.) You can use NOT in front of any search expression to reverse its meaning. This allows you to exclude documents from a search. For example, apple sauce AND NOT pear would retrieve documents containing the phrase "apple sauce" and not containing the word "pear". Alternatively, you could search for NOT pear and retrieve all documents that did not contain the word "pear". Other examples: apple OR NOT pear Retrieve documents that either (1) contain the word "apple," or (2) do not contain the word "pear". NOT (apple w/5 pear) Retrieve documents that do not contain the word "apple" within 5 words of the word "pear". Note the use of parenthesis to make the request unambiguous. The NOT W/ ("not within") operator allows you to search for a word or phrase not in association with another word or phrase. For example, apple NOT W/20 pear would search for instances of the phrase "apple" more than 20 words away from the word "pear". It will also retrieve files containing "apple" with no instances of "pear". Unlike the W/ operator, NOT W/ is not symmetrical. That is, "apple NOT W/20 pear" is not the same as "pear NOT w/20 apple". In the "apple NOT W/20 pear" request, dtSearch searches for the word "apple" and excludes cases where "apple" is too close to the word "pear". In the "pear NOT W/20 apple" request, dtSearch searches for the word "pear" and excludes cases where "pear" is too close to "apple". - 5 - E. Binary files When dtSearch builds an index of a group of files, it automatically detects and skips "binary" files such as executable programs and data files that do not contain text. If a file uses a word processor format that dtSearch does not recognize, dtSearch may classify it as "binary." If dtSearch finds any binary files during an indexing job, dtSearch will display a message at the end of the job indicating the number of binary files. The file INDEXLOG.TXT will list the files. INDEXLOG.TXT is re-written each time an index is updated, so binary files from previous indexing jobs will not be listed. If you are using batch mode indexing, the .LOG file created from your script will list the binary files. You can tell dtSearch not to skip binary files by setting the "Index binary files" option in the Options menu to "Yes." F. New Error Messages "Error reading WordPerfect file" WordPerfect files occasionally become corrupted due to disk problems or WordPerfect bugs. Prior versions of dtSearch would sometimes crash if a corrupted WordPerfect file was encountered while searching or indexing. In this version, dtSearch checks for corruption in a WordPerfect file and will display this message if it finds erroneous data. Here are some steps you can take to repair a corrupt WordPerfect file (make a backup copy of the original file first!). (1) Retrieve the file into WordPerfect, scroll to the end of the file, and save the document. Often, WordPerfect will detect and remove the corrupt data. However, you may also lose some text. (2) Try one of the programs that claim to be able to repair damaged WordPerfect files. One such program is WPMD, which is shareware. (3) Get the most recent maintenance release of WordPerfect from WordPerfect Corp. and try step (1). "Warning: document contains more than 64,000 words" dtSearch can handle documents up to 64,000 words long (about 300 double-spaced pages). If a document is longer than that, dtSearch will stop searching or indexing after the 64,000th word and display this message. To suppress this message, set the "Warning for too-long documents" option in the Options menu to "No." - 6 - G. Batch Mode Indexing Batch mode indexing allows you to create, update, and compress a document index by running dtSearch from a batch file. (For information about creating batch files, see your DOS manual.) Batch mode indexing can be useful if, for example, you want to perform a complex and time-consuming series of tasks every night to update your indexes. 1. Overview To set up a batch indexing job, first create a "script" that lists the tasks that you want dtSearch to perform. A script is a text file that lists a series of indexing commands that dtSearch will carry out. The easiest way to create a script is to use the "Create Batch Script" option in the Index menu. When you select this option, a dialog box will appear that is almost identical to the "Update Index" dialog box. At the top of the box will be a line where you can specify the name of the script you want to create. Fill out the rest of the box exactly as you would if you were updating an index. If you want to create a new index for your batch job, use the "Create Index" section of the dialog box. See the manual section on Indexing Documents for more information about the options in the Create Batch Script dialog box. When you are done setting up the indexing job, select the "Create Script" button at the bottom of the dialog box to create the batch script. dtSearch will then store all of the information you have provided (the index to update, the directories to index, etc.) in a script file that you can run later. To run the script that you created, exit dtSearch and type the following at the DOS prompt: DTSEARCH /SCRIPT MYSCRIPT.JOB where "MYSCRIPT.JOB" is the name of your script. dtSearch will then perform the indexing task you specified. dtSearch will record any errors encountered during the job in a file called MYSCRIPT.LOG. Errors will not be displayed on the screen, since dtSearch assumes that batch jobs will run without someone watching them. After a batch indexing job, you should check the log file to see if any errors occured. This is all that you need to know to set up basic batch indexing tasks. The rest of this section provides information for more advanced use of batch mode indexing. - 7 - 2. Script files A script file is any text file that dtSearch can read. You can create a script using the "Create Batch Script" option in the Index menu, or you can create a script by hand. Before you try to write your own scripts, you may want to create an example using the "Create Batch Script" function so you can see what a batch script looks like. A script can be ASCII text or it can be in one of the word processor formats that dtSearch recognizes, such as WordPerfect or WordStar. The first line of a script must consist of the words DTSEARCH SCRIPT. A script consists of a series of "SET" statements that specify the documents to be indexed and the index to use, and commands such as "ADD" and "COMPRESS". dtSearch ignores any line beginning with a *, so you can include comments in a script. Here is an example: DTSEARCH SCRIPT * Add documents from C:\DOCS SET INDEXNAME = MyIndex SET DOCPATH = C:\DOCS SET FILTER = *.DOC *.TXT *.WPF ADD COMPRESS This script would index documents in the directory C:\DOCS, storing information about the documents in the index called "MyIndex", and would compress the index. To run this script, put it in the file UPDATE.JOB and execute the command: DTSEARCH /SCRIPT UPDATE.JOB dtSearch will then execute the script, logging any error messages to the file UPDATE.LOG. 3. Creating an index To create an index, set up a script like this: SET INDEXNAME = MyIndex SET INDEXPATH = C:\DOCINDEX CREATE The two SET statements tell the program what you want to call the index and the directory you want to put it into. The "CREATE" statement tells dtSearch to create the index in the specified directory. - 8 - WARNING: Please be careful when using CREATE. If you create an index that already exists, dtSearch will delete the old index and create a new, empty index in its place. In interactive mode, you will get a warning message before this happens, but in batch mode dtSearch simply assumes that you really want to create a new index. 4. Adding documents to an index To add documents to an index, use "SET DOCPATH =" to tell dtSearch the directory in which the documents are located and "SET FILTER =" to specify the file name filters. Then use the "ADD" command to add the documents to the index. If you want to index documents in several directories, use multiple "SET DOCPATH =" statements separated by "ADD" commands. Example: SET INDEXNAME = MyIndex SET DOCPATH = C:\DOCS SET FILTER = *.DOC *.TXT *.WPF ADD SET DOCPATH = C:\DOCS2 ADD SET DOCPATH = C:\DOCS3 ADD This would add documents from C:\DOCS, C:\DOCS2, and C:\DOCS3 to the index "MyIndex". The CREATE function needs to know both the name and the directory for an index, and so both the SET INDEXNAME and the SET INDEXPATH must be present to create an index. The ADD function just needs to know which index you want to add documents to, so you can use either the name (SET INDEXNAME) or the path (SET INDEXPATH) to specify the index. 5. Reindexing changed documents The REINDEX command in a script will cause dtSearch to reindex any documents in an index that have been modified since the index was last updated. This is the batch mode equivalent to the "Reindex changed documents" menu option. Example: SET INDEXNAME = MyIndex REINDEX - 9 - 6. Compressing an index To compress an index, use SET INDEXNAME or SET INDEXPATH to specify the index to compress and then use the COMPRESS command. Example: SET INDEXNAME = MyIndex COMPRESS 7. Complex scripts A script can do more than one indexing task. For example, this script would create the index MyIndex, add documents to it, compress it, and then create a second index: SET INDEXNAME = MyIndex SET INDEXPATH = c:\myindex CREATE SET DOCPATH = c:\docs SET FILTER = *.doc *.wpf *.txt ADD COMPRESS SET INDEXNAME = MyIndex II SET INDEXPATH = c:\myindex2 CREATE Note that you do not need to specify the index name again after the CREATE command. dtSearch will remember the values given for the previous command until you change them.