Make your own free website on Tripod.com
ReadMe

Releases

August 23, 2001
Made it possible for the user to control whether the applet requires every term to match before a document is considered to match -- that is, to do AND searches. Fixed a bug related to AND searches. Updated the documentation.

August 16, 2001
Updated and made more spiffy the documentation.

August 11, 2001
This release fixes a serious bug, introduced in the July 5, 2001 release, that caused the applet to not collect the leading context.

This release also includes support for "and" searches. If the match_all_terms is set to true, a document will not be considered to match unless every search term is found within that document.

July 5, 2001
This release gives SearchToHTML the capability of understanding Unix-style relative paths such as "../" (one directory up) or "/" (root) in the "files" parameter. Note that applets usually are put under extreme security restrictions. If you're running SearchToHTML locally, it's very likely that SearchToHTML will not be able to access any files not within the directory (or a subdirectory of that directory) containing the applet's .class files. One way to deal with the security restrictions is to put the applet's .class files as high in the directory hierarchy as possible.

This release also includes a fix to a serious (though apparently rarely encountered) bug in SearchDocument. Inexact searches with a leading context length of zero would not work. An uncaught IllegalArgumentException would be thrown. The code has been changed to avoid raising the exception.

June 14, 2001
The new files_file parameter allows you to have SearchToHTML download a list of files to search from a separate file. I hope you will only use this parameter as a last resort as by using it, you force the user to wait for another file to download.

May 6, 2001
All code related to filtering what terms a user may search for has been removed. The documentation has been updated. The files included in the SearchToHTML distribution have been rearranged. The files required to run the applet have been placed in the required directory; the applet's source files have been placed in the source directory. The example HTML files have been moved to the examples directory.

April 4, 2001
SearchToHTML now understands two new parameters: start_pattern and stop_pattern. Only the portion of a document after a match of start_pattern's value is searched. Only the portion of a document up to a match for stop_pattern's value is searched. If both stop_pattern and start_pattern are used, a match for stop_pattern will have no effect until after a match for start_pattern has been found.

March 24, 2001
Dramatic changes have been made to the internal structure of the applet. The applet should now handle be able to handle wide (many document) searches gracefully -- that is, without bogging down the user's Web browser. A bug in the way context was collected following a match in the title of a document has been fixed. The leadingcontextlength and trailingcontextlength parameters are now much more dependable. The UI now gives the user more feedback. During a search, the text field and the checkboxes are disabled, the mouse pointer is changed to a wait cursor, and the name of the document currently being searched is shown in the browser's status bar. The HDocSearcher class has been replaced with the SearchDocument class.

The following parameters have been added: send_context, send_titles, send_info, send_anchors, phrase_searches_only, disallowed_terms, blocked_search_message, close_button_label, and blocked_search_title. See the Parameters guide for more information.

The waitforall parameter has been disabled.

March 13, 2001
The documentation has been updated. A rarely used feature of SearchSieve has been removed to improve efficiency. The example file ex_startwords.html has been fixed -- it had not been updated since SiteSearcher was released. Sorry.

The format of the document information string has changed in the last few releases from what it was with the original release. Specifically, in older releases, the file size was always in terms of kilobytes. If a file happened to be less than 1024 bytes, its size was listed as zero. In newer releases, if a file's size is less than 1024 bytes, the size of the file is given in terms of bytes. The file size in kilobytes is suffixed with a "k." For byte sizes, the suffix is a "b."

Now, sanity checks have been added on the file information. If the found file size is less than or equal to zero, the file size is not added to the information string. If the year of the creation date is less than 1950, the creation date is not added to the string.

March 12, 2001
The March 12, 2001 release, version 2.2, adds one parameter, searchbox_size, which can be used to set the column width (character length) of the search box. Significant changes to the Java code have been made. HDocSearchers have been made responsible for keeping track of document information. The internals of several methods have been rearranged for hopefully more efficient execution. The Java code's documentation has been expanded. The APIs of SearchToHTML, HDocSearcher, and SearchSieve have changed.

The new versions of the classes are not compatible with older versions of SearchToHTML. Make sure that you upload all of the class files -- SearchToHTML, HDocSearcher, ProgressBar, and SearchSieve. If the applet doesn't load after you update, make sure that your browser is not caching older versions of the class files. As always, if you have a problem using the applet, please e-mail gilbertnews@hotmail.com for help.

March 7, 2001
The March 7, 2001 release, version 2.0b, adds a progess bar to the SearchToHTML applet. In the process of building SearchToHTML from the AdvSiteSearcher applet, the progress bar (as a separate class) was eliminated in hopes of reducing the load time of the applet. Without a progress bar, however, users lost a valuable visual cue about the applet's continued progress -- especially important for time consuming searches.

Several parameters allowing the new progress bar to be customized have been added: hide_progress_bar, progress_bar_completed_color, progress_bar_remaining_color, progress_bar_text_color, progress_bar_height, progress_bar_width, progress_bar_message, and hide_progress_bar_message.

In addition, parameters allowing the label next to the search box and the button to be hidden have been added: hide_button and hide_searchbox_label.

Roughly, the applet's interface can be divided into three sections: top (label, search box, button), middle (checkboxes), and bottom (progress bar). When all of the elements of a section are hidden, that section is not drawn to the screen -- the other UI sections "slide" to cover an empty section. Using this new feature, you should be able to greatly reduce the screen size of the SearchToHTML, even reducing it to just a bare text field.

March 4, 2001
The March 4, 2001, version 1.16, release of the applet adds four new parameters for controlling the appearance (or disappearance) of the applet's checkboxes. Set hide_exact_chkbx to true to hide the "Exact matches only" checkbox. Set hide_xhtml_chkbx to true to hide the "Exclude HTML" checkbox. The documentation for the applet's code has been somewhat expanded as well. exact_matches_only and ignore_tags are the other two new parameters.

August 22, 2000
The August 22, 2000 release of the applet changes the default value of the waitforall parameter from false to true. A few more erroneous/dumb comments have been removed from the source.

August 17, 2000
The August 17, 2000 release of the applet slightly improves the efficiency of searches and expands and corrects the applet's documentation. For more information on the modifications to the source code, see the individual source files. (Since the May 12, 2000 release of the applet, the following parameters have been added: leadingcontextlength, trailingcontextlength, xhtml_chkbx_checked, exact_chkbx_checked, and max_num_matches.)


ReadMe