TheSage Documentation

Documentation is always a work in progress as it is only useful when users are actually able to benefit from it.

We have compiled here the information that we believe will be of practical use. If you find that something merits being included or discussed in more detail, contact us at info@sequencepublishing.com and we will adjust this document as appropriate.

Table of Contents

1. What is TheSage? [^]

TheSage is a professional software package that integrates a complete dictionary and multifaceted thesaurus of the English language into a single and powerful language reference system.

TheSage can look up words directly from almost any program (IE, Word, Firefox, Outlook, Thunderbird,... ) and is 100% portable.

2. System Requirements [^]

TheSage has been developed for the Windows 95/98/ME/2000/NT/XP operating systems. It is highly recommended that the latest OS Service Packs be installed.

TheSage requires downloading a setup file of approximately 8 MB in size and, once installed, TheSage occupies approximately 20 MB of hard drive space. TheSage has no special RAM requirements and will use about as much memory as any other program.

2.1 Installing [^]

To install TheSage, execute the setup program and follow the instructions.

Once installed, TheSage come be invoked from the Start menu, the Desktop, the Quick Launch toolbar, or directly from its folder in the hard drive.

2.1.1 Installing to a USB Flash Drive [^]

TheSage does NOT pollute your hard drive by placing files in system directories (and the such). TheSage does NOT depend on the registry or static identification of specific OS resources. Therefore, it is possible to run TheSage from a portable device such as a USB flash drive.

To use TheSage from a flash drive, follow these simple steps:

The local copy is no longer necessary to run TheSage. It can be uninstalled if so desired.

2.2 Uninstalling [^]

TheSage's package includes an uninstaller utility. To run it, navigate through the Start Menu or through the hard drive to TheSage's folder. Alternatively, it is possible to uninstall TheSage through the 'Add/Remove Programs' applet located in the 'Control Panel'.

3. Program Features [^]

TheSage's English Dictionary and Thesaurus has been designed with simplicity of use in mind, striving to be as intuitive and useful as possible.

The Dictionary comprises:

• More than 145,000 references with multiple detailed definitions (over 200,000).
• A large collection of examples of usage (approx. 35,000).
• Encyclopedic information (geographical, historical, political,...).
• Academic knowledge (medicine, biology,... ).

The Thesaurus encompasses:

• Synonyms, antonyms, hypernyms, hyponyms, meronyms, holonyms,...
• Nearly 1,200,000 relationships between definitions.

The essential functionality includes the following:

• Look up words directly from almost any program (IE, Word, Firefox, Outlook, Thunderbird,... ).
• Clean, well-behaved design that allows TheSage to be a 100% portable application.
• Tabbed interface allowing multiple definitions and searches to be readily available.
• Quick cross-referencing (any and all displayed words are clickable, triggering a lookup).
• Standard and advanced wildcard search functionality.
• Anagram search.
• History and session record keeping.
• Options that allow customization of the appearance of TheSage.
• Copy to clipboard of all or part of the information displayed.

Below are detailed explanations on how to carry out a lookup, a wildcard search, and an anagram search.

3.1 Looking up a word in TheSage [^]

To look up a word or words in TheSage's Dictionary, type it (or them) and then click on 'LookUp'. Alternatively, type the word(s) and then simply press ENTER.

For example: chatoyant, african violet, prestigious, natural law, atomic weight, titanosaur, legerdemain,...

If the word is found in TheSage's index, a new tab will be created displaying this word's information as shown below:

The image above shows what is called a lookup tree. The color buttons on each node of the tree are referred to as semaphores and serve to toggle (open/close) the display of nested levels.

The information in the tree is conceptually divided into lemma, part(s) of speech, definition(s), thesaurus, and example(s).

• At the top of the tree is the lemma which corresponds to the entry found in the dictionary. Usually, the lemma is the same as the word searched for. However, if the word typed is an inflection or derivation (i.e. 'plays' or 'prettier') and this word is not found, TheSage will automatically extract and display the base word (i.e 'play' or 'pretty').
• The parts of speech are found at the second nested level of the lookup tree. In the case of the image above, these are 'Noun', 'Verb', 'Adjective', and 'Adverb' and serve to group definitions accordingly.
• At the third nested level are the definitions. These are numbered and their background color can be changed (selected) to help isolate them visually.
• The thesaurus contains related entries to the lemma in function of following relationships: synonym, antonym, hypernym, hyponym, attribute, entailment, cause, similar, derived, holonym, meronym, category, region, usage, and other (under 'see also'). Thesauri found under a particular definition only apply to that definition. Thesauri found under a given part of speech are the collection of all thesauri for definitions under such part of speech. Finally, thesauri under the lemma are all thesauri available for this entry.
• Examples of use can be found as branches of the lemma, parts of speech, and definitions. As with thesauri, examples can be found as branches of the lemma, parts of speech, and definitions. The same logic applies.

Note that any and all displayed words are clickable, automatically triggering a new lookup.

3.2 Wildcard Search [^]

To select index entries that match a wildcard pattern, type the pattern and click on 'Wildcard'. Alternatively, type '=' followed by the pattern and press ENTER.

Patterns are formed by a combination of letters/numbers and special characters (see below).

Special characters:

• * matches any number of occurrences of any character.
• ? matches a single character.
• # matches a single vowel (a, e, i , o , u).
• $ matches a single consonant (b, c, d, f, ..., x, y, z).
• (abc..) matches a single character to one of those in the parenthesis.
• (#-ae) matches a single vowel except 'a' and 'e'.

Examples:

• =ch#p returns chap, chip, chop.
• =$ait returns bait, gait, wait.
• =($-g)ait return bait, wait.
• =s$(rl)##n returns screen, spleen, sprain, strain, syrian.
• =*##?#tion returns acquisition, aeration, alienation,...

The results from a wildcard search are displayed as follows:

Note, again, that any and all displayed words are clickable, automatically triggering a lookup.

3.3 Anagram Search [^]

To find all anagrams of a character string in TheSage's index, type the string and click on 'Anagram'. Alternatively, type '>' followed by the string and press ENTER.

The anagram search returns only those words that are found in the dictionary, that is, valid English words. It does not return all possible anagrams of a character string.

Examples:

• >humanity returns hitman, mithan, mutiny, amity,...
• >furniture returns nurture, fenrir, future, return,...
• >playing returns gainly, laying, paling, paying,...
• >bachelor returns cholera, chorale, bleach, boreal,...

The results from an anagram search are displayed as follows:

Note, once more, that any and all displayed words are clickable, automatically triggering a lookup.

4. Additional Functionality [^]

In order to make TheSage as useful as possible, supplementary operations have been implemented.

4.1 Looking up words from another program [^]

TheSage can look up words directly from almost any program (IE, Word, Firefox, Outlook, Thunderbird,... ). This is accomplished by selecting the relevant word in the appropriate program and by pressing TheSage's Hotkey. TheSage will then read the word and carry out a lookup automatically.

A hotkey is a combination of keys that, when pressed simultaneoulsy, invoke a program. By default, TheSage's hotkey is CTRL + SHIFT + A but users can chose whatever combination they prefer via the Hotkey dialog (below).

The Hotkey dialog is available through TheSage's System Tray Menu.

4.2 Tab Operations [^]

As explained, all information resulting from a lookup or search is displayed in a tab for ease of access. In order to facilitate working with tabs, the following functionality is supported:

• A tab can be closed by means of a mouse RIGHT-CLICK or MIDDLE-CLICK as long as there is more than one tab open.
• Tabs can be reordered by means of drag'n'drop operations. All is needed is to hold down the LEFT mouse button while pressing the CTRL key. The dragged tab will always be placed before the one it is dropped on. To place a tab as the right-most, drag this tab to the available space on the right or outside of the tab control.

4.3 History [^]

TheSage keeps a record of all words (lookups and searches) carried out as well as the time and duration of each of the sessions when it has been active.

There are two ways to access the History. First, there is a dropdown list that shows only those entries typed in the current session, as shown below:

Second, there is a History tab that shows all entries from the current as well as previous sessions. The History tab is always shown in the left-most position and can neither by dragged nor replaced as the left-most tab. It is possible, however, to close it by right or middle clicking on it as with any other tab.

The History tab is activated/deactivated by clicking on the toolbar button featuring a clock on the top-right corner, as shown below:

As usual, any and all displayed words are clickable, automatically triggering a lookup.

4.4 Clipboard [^]

All or part of the information regarding a lookup and search can be copied to the clipboard by means of context (RIGHT-CLICK) menus. The operation of this feature is quite intuitive.

If the clipboard operation is conducted on a wildcard/anagram tab, the context menu looks as follows:

If the clipboard operation is conducted on a lookup tab, the contents of context menu will vary depending on which part of the tree it is invoked on. Essentially, however, the menu looks as follows:

In addition to the context menu, it is possible to copy directly to the clipboard the word under the mouse by means of the combination CTRL + LEFT-CLICK.

The information copied to the clipboard is in ASCII format. In the case of a wildcard/anagram tab, the contents of the clipboard equate to a text file with one entry per line. In the case of a lookup tab, the contents of the clipboard equate to a text file depicting a nested structure and where each line stands for a branch of the lookup tree.

5. TheSage's System Tray Menu [^]

A number of options and functionality are available through TheSage's System Tray Menu, always visible in the bottom-right corner of the screen while TheSage is running.

A left-click on TheSage's System Tray icon will activate it and make it visible.

In order to view the menu, a right-click on TheSage's System Tray icon will display the menu shown above. From this menu it is possible to customize TheSage's appearance and functionaliy, access the help, check for updates, or go online to our site.

5. Options [^]

The Options dialog is invoked by clicking on the toolbar button featuring a bulleted list on the top-right corner of TheSage, as shown below:

Each options tab provides a brief description of its contents.

5.1 Lookup Tree Options [^]

The Options dialog (also accessible from TheSage's System Tray icon) provides a number of parameters (font, color, the behavior of history and clipboard, Add to Start Menu, ...) that will allow you to customize the appearance and behavior of TheSage. The screenshot below shows the options available to modify the appearance of the lookup trees:

In order to ease the selection of custom colors, the 'color chooser' controls implement a magnifier-dropper (RIGHT-CLICK) in addition to the standard Windows color dialog (LEFT-CLICK). The magnifier moves with the mouse cursor (or arrow keys) and can be used to inspect any location on the screen. The magnifier zooms in/out by pressing SHIFT + UP/DOWN, and increases/decreases its size by pressing SHIFT + RIGHT/LEFT. Once over the desired pixel, LEFT click on it to select its color or RIGHT click to dismiss the magnifier.

Note that, regardless of what changes you make to TheSage, you can always restore the default settings (under the 'General' tab).

5.2 Semaphore Options [^]

The Semaphores Tab makes it possible to chose whatever semaphore colors are best suited to each user. The working of the 'color chooser' controls is identical to that in the Lookup Tabs.

Of note are the 'By default show' checkboxes at the bottom-left. These allow the user to determine what information will be initially shown when a lookup is carried out. Opening or closing all local example/thesaurus nodes automatically cannot only be accomplished via these defaults. When working with a lookup tree, the keys CTRL-A, CTRL-S, and CTRL-D will expand/collapse all local example/thesaurus nodes, all local thesaurus nodes, and all local example nodes, respectively.

6. Updates and Contact [^]

TheSage's project has accomplished all its core objectives and the package is fully functional. Nonetheless, updates will be made available as the project evolves.

Visit www.SequencePublishing.com for up-to-date information regarding TheSage.

Feedback Form

We value feedback. Feel free to contact us via the form below (or send us an email if you prefer) with comments and questions.

Name: Email: Comments:

7. License Agreement [^]

READ CAREFULLY ALL TERMS OF THIS LICENSE AGREEMENT BEFORE USING THIS SOFTWARE

IF YOU DO NOT AGREE WITH THE TERMS OF THIS LICENSE AGREEMENT, YOU ARE NOT AUTHORIZED TO USE THIS SOFTWARE

Permission is hereby granted to anyone to freely use TheSage's English Dictionary and Thesaurus (hereafter referred to as 'this software') for any purpose with the exception of including it in a product, in which case both permission and acknowledgment are required.

To the maximum extent permitted by applicable law, the software and documentation are provided "as is". Franc Morales and Leah Gilner (hereafter referred to as 'the authors') disclaim all other warranties and conditions, either express or implied, including, but not limited to, implied warranties of merchantability, fitness for a particular purpose, conformance with description, title and non-infringement of third party rights. In no event shall the authors be liable for any indirect, incidental, consequential, special or exemplary damages or lost profits whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or any other pecuniary loss) arising out of the use or inability to use the software product, even if the authors have been advised of the possibility of such damages.

The authors allow you to distribute this software if all of the following conditions are met: you are not charging any money for it, the distribution files are kept together and unmodified, and the authors' permission is obtained before distribution. You may give this software package to friends or colleagues, burn it onto cd-rom's (or other media) and upload it to free/shareware sites as long as the original package remains unmodified.

All rights to this software (including any images or text incorporated into this software) are owned by the authors.

You may not disassemble or reverse engineer any part of this software.

You may not rent or lease this software.

The authors are not required to make available technical support for this software. The authors may, from time to time, revise or update this software. In so doing, the authors incur no obligation to furnish such revision or updates to you.

This license agreement will immediately and automatically terminate without notice if you fail to comply with any one of the terms and conditions cited. Upon termination of this license agreement, you agree to promptly remove the software from your system.

TheSage's English Dictionary and Thesaurus.
Copyright 2001-2007 by Franc Morales and Leah Gilner.
All rights reserved.

WordNet 2.0 Copyright 2003 by Princeton University. All rights reserved.

THIS SOFTWARE AND DATABASE IS PROVIDED "AS IS" AND PRINCETON UNIVERSITY MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PRINCETON UNIVERSITY MAKES NO REPRESENTATIONS OR WARRANTIES OF MERCHANT-ABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE LICENSED SOFTWARE, DATABASE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.