MUSAIOS 2002 A

Instruction Manual

Copyright (c) 1992-2002 by Darl J. Dumont and Randall M. Smith

NOTE: If you want to get started with a minimum of delay, you can skip through this text,
reading only the boldface type for the essential information you need to get MUSAIOS up
and running. Your five-minute quick tour will orient you to the layout of the manual, for
future reference, and you will learn about the less obvious features of Musaios.

Musaios c/o Darl J. Dumont

840 Oneonta Drive
Los Angeles, California 90065-4125

Internet: ddumont@musaios.com February 20, 2002

rsmith1@rpprog.com
www.musaios.com or www.rpprog.com/musaios
 TABLE OF CONTENTS:

I. INTRODUCTION

II. WHAT'S NEW IN MUSAIOS 2002 A

III. REGISTRATION

IV. HARDWARE REQUIREMENTS

V. SOFTWARE REQUIREMENTS

VI. GREEK FONTS

VII. INSTALLATION OF MUSAIOS FROM THE SETUP DISKETTE OR CD-ROM

VIII. INITIAL CONFIGURATION OF MUSAIOS

IX. OVERVIEW OF OPERATION

X. OPENING AND USING TEXT WINDOWS

XI. EXPORTING TEXT TO OTHER PROGRAMS

XII. DISPLAYING BIBLIOGRAPHIC DATA FROM THE TLG CANON

XIII. USING THE CONCORDANCE VIEW

XIV. WORKING WITH FONTS

XV. PRINTING FROM MUSAIOS

XVI. SEARCHING A SINGLE TEXT

XVII. SETTING UP A MULTI-TEXT SEARCH

XVIII. ADVANCED SEARCHING

XIX. USING THE TLG WORD INDEX

XX. USING THE TLG CANON LISTS

XXI. OPTIMIZING SEARCH PERFORMANCE

XXII. WORKING WITH A WORD PROCESSOR

XXIII. THE TOOLBAR

XXIV. ACCELERATOR KEYS

XXV. THE WinGREEK KEYBOARD

XXVI. DE-INSTALLATION OF MUSAIOS

XXVII. IN CASE OF PROBLEMS:

XXVIII. LEGAL NOTES AND DISCLAIMER
I. INTRODUCTION

The authors of MUSAIOS were also authors of the previous SEARCHER and PHAROS dating
back to the late 1980s. When C++ became widespread ten years ago, it was decided to
completely rewrite the program without reference to what had been done before. SEARCHER
and PHAROS remain the property of the Regents of the University of California, but are no
longer supported.

Until the beginning of 1994, MUSAIOS was distributed under the name of SCRIPTORIUM. Due
to legal threats by a dealer in celebrity autographs in Beverly Hills, we decided to change our
name. According to the OCD, Musaios was a mythical singer connected to Orpheus, who taught
oracles, and the same name was held by the late 5th century A.D. author of Hero and Leander,
"a poem of some competence and romantic grace".

Over 500 individuals and institutions have registered MUSAIOS since it was launched in 1993.
We have never yet charged anyone for an upgrade, and this upgrade is no exception. Beginning
later in 2002 we probably will charge an upgrade fee at intervals for those who have not
registered relatively recently. This will enable more and faster improvements to be made to the
program.

You may feel free to distribute copies of the Musaios setup diskette or CD-ROM to your friends,
however, they must register and pay us within 30 days or stop using the software. MUSAIOS will
admonish them about registration until they write to us and get a registration number.

Version 2002 introduces support for a Latin Word Index, available as an option. Various
improvements and bug fixes are also included. See section II below for details.

Version 2001 A is a more major upgrade than those that have gone before. See section II
below for details.

Version 1.0e includes several bug fixes (outlined in revision.doc) and adds support for
the TLG CD #E.

Version 1.0d includes several bug fixes (outlined in revision.doc) and adds support for
multiple Greek fonts, either individually or together and allows the size and
characteristics of both Greek and Latin fonts to be specified (see section XIV. below). It
also allows text to be exported directly to a file as well as through the Clipboard (see
section XI. below).

Version 1.0c adds capability for two-term "Boolean" searches, wildcard characters, and
character set matching (see section XVIII. below). The core of the searching software has
been completely replaced, although the user interface is almost unchanged. The
preliminary version of PHI's new "Founding Fathers" CD-ROM is supported.
II. WHAT'S NEW IN MUSAIOS 2002 A

Please read this if you are familiar with a previous version of Musaios.

1. There is support for a Latin Word Index, which works exactly like the existing TLG (Greek)
Word Index. The files for the Latin Word Index were not produced by Packard Humanities
Institute. They were produced by the Musaios Project, and are available separately, included on
the Musaios Concordance CD-ROM.

2. Performance of the Greek word index has been improved. The list of works for a specific
word form takes less time to be generated, and when the "Show Text" function is chosen, all the
occurrences are immediately searched for, resulting in a quicker display.

3. Previously when long words beginning with vowels were searched for in the Greek Word
Index, sometimes a fatal error would occur. This has been fixed.

4. Problems with the GreekKeys fonts are fixed. Specifically, the keyboard mappings have been
fixed when word forms are entered for searching. Also, if Beta Code is selected, Greek is no
longer displayed when word forms are entered.

5. Greek text within Latin language files is now properly displayed. This did not work properly in
Musaios 2001A.

6. Rarely, duplicate search results were erroneously reported. This has now been fixed.

WHAT WAS NEW IN MUSAIOS 2001 A

1. In the TLG Canon Lists feature (accessed via the Search menu) the "Search These" button
now works. At this point, entire authors are always searched, not individual works, even if the
list you were viewing specifies individual works. This refinement will be addressed in a future
release.

2. When you are viewing a text, you may see the information about the author and the specific
text from an option on the View menu after you have opened the text. Choose the "View
Bibliographic Canon Information for This Work" item from the View menu.

3. Much more text can be exported to the Windows Clipboard, or a file in Rich Text Format
(RTF). Formerly you could only select for export the text visible on the screen. Now you can
select about 100 lines. In this we have followed the lead of Pandora (software for the
Macintosh). The limitation remains at this level at the specific request of TLG because of
concerns about facilitating copyright infringement.

4. A "Concordance View" can be opened for certain authors once you have obtained the
"Musaios Concordance Plug-Ins" for those authors. These may be downloaded from our website
at www.musaios.com/plugins.htm. (A separate registration number is required for each package
of related authors. However you may download the plug-ins for evaluation before you register)
Once you have installed the plug-ins, you may rapidly shift back and forth between the Text View
and the Concordance View. The plug-ins contain no text themselves, but they enable Musaios
to construct the Concordance View on the fly by reading the TLG-E or PHI 5.3 text that they
correspond to.
III. REGISTRATION

After receiving a copy of MUSAIOS from whatever source, you must register and pay
within 30 days, or else de-install the product from your computer and cease using it.

If you are not already registered:

To obtain a registration number for Musaios 2002 A you can register electronically through our
web site (www.musaios.com) using a credit card or you can send $80 in U.S. funds to:

Musaios c/o Darl J. Dumont

840 Oneonta Drive
Los Angeles, California 90065-4125

Be sure to include the exact name you would like the program to be registered to. It will be
displayed every time you enter the program.

The above price covers registration of electronically-distributed copies, and does not include
mailing of diskettes. If diskettes and a printed instruction manual are required, $15 must be
added for destinations within the U.S., and $25 for destinations abroad. Shipping will be by
priority mail in countries where that is available, otherwise by air-mail.

Checks should be payable to MUSAIOS, and must be drawn on a U.S. bank, with U.S.
style magnetic letters. We can be reached by E-mail on Internet at ddumont@musaios.com or
rsmith1@rpprog.com.

IV. HARDWARE REQUIREMENTS

MUSAIOS 2002 A does not have any specific hardware requirements beyond those required to
run the operating system except that a CD-ROM drive is required to read the TLG and PHI discs.
A higher performance CD-ROM drive is highly desirable though Musaios will work with any speed
drive.

V. SOFTWARE REQUIREMENTS

MUSAIOS 2002 A runs under Microsoft Windows 95, Windows 98, Windows ME, Windows NT,
Windows 2000, or Windows XP on PC-compatible computers. This version of MUSAIOS does
not run under Unix, DOS or a 16-bit version of Windows (e.g. Windows 3.0, Windows 3.1,
Windows for Workgroups). This version of MUSAIOS does not run directly on the Macintosh,
though we have had reports of success running it under several of the PC emulators available
for the Macintosh.

If you are considering buying a Windows-based word processor, we recommend Microsoft Word
For Windows, because WinGreek assumes that is what you are using, and because Word, unlike
its competition, is an OLE and DDE server. In plain English, this means that we will be able to
provide a much more powerful link with Word in future releases than for other word processors. If
you already own a competing word processor, be sure to ask your software retailer about
competitive upgrade offers -- the discounts have been quite deep.
VI. GREEK FONTS

MUSAIOS currently supports three Greek fonts: WinGreek, GreekKeys, and Porson
PolyGreek from Kappa Type. One of these Greek fonts must be installed before you can
see Greek texts displayed in Greek letters. If you are only interested in Latin-alphabet texts or
only want to view Greek texts in beta code, you do not need to install WinGreek. Each of these
fonts is a separate product that provides fonts to all Windows applications. Once installed, any
time in Windows that you are given the option of choosing a font, you may choose a Greek font,
whether in Word for Windows, Paintbrush, or Musaios. The latest versions provide "TrueType"
fonts which offer printability on almost any printer under almost any circumstances, as well as a
vast range of "scalability".

1.) WinGreek - WinGreek font is a font package which provides TrueType, bitmapped, and
PostScript Greek, Hebrew and Coptic fonts to any program running under Windows.
We have obtained permission to distribute WinGreek with our product, but WinGreek is
not ours and it is not free. If you wish to use it you must register and pay the authors as
described below, if you have not done so in the past.

The business address of WinGreek is:

Peter J. Gentry
55 Ambercroft Blvd.
Scarborough, Ontario
Canada M1W 2Z6

Checks for US$35 should be payable to Peter J. Gentry. Any technical or business questions
concerning WinGreek should be directed to the authors of WinGreek, and not to us.

2.) GreekKeys is a Windows version of a leading font package for the Macintosh. The Windows
version provides a Greek font and keyboard handler. This package is available from Scholar's
Press:

c/o Professional Book Distributors

P.O. Box 6996
Alpharetta, GA 30239-6996
800-437-6692
404-442-8633
404-442-9742 (Fax)

3.) Porson Poly-Greek is a new font styled after the Porson font used in the Oxford Calssical
Texts (OCT). It is available from Kappa Type Inc.:

P.O.Box 1652
Palo Alto
California 94302
Tel +1 415 322 0135
Fax +1 415 326 8844
Orders & Inquiries 800-480-0135 (USA & Canada)
E-mail: kamal@netcom.com
VII. INSTALLATION OF MUSAIOS FROM THE SETUP DISKETTE OR CD-ROM

Put the diskette in drive A: or B: as appropriate, or put the CD-ROM in your CD-ROM drive.

From Windows, from the FILE menu of the Program Manager, select the RUN option.
Select A:\SETUP.EXE or B:\SETUP.EXE, or perhaps D:\SETUP.EXE for the CD-ROM
according to which drive you put the disk in. You will be given some self-explanatory
message boxes as the installation proceeds.

The only option you are offered during setup concerns the directory in which you want MUSAIOS
installed. It is suggested that you stick with the default: C:\MUSAIOS, which will be created for
you if it does not exist already. This will make support by us easier if you should require it in the
future.

Installation takes about one minute. When installation is complete, you will have a new
Program Manager group labeled MUSAIOS, with two icons, one to execute MUSAIOS 2002
A and the second to display this manual (via WordPad).

VIII. INITIAL CONFIGURATION OF MUSAIOS

The first time you run MUSAIOS, the program will detect that there is no configuration
information. You will then be prompted to enter the drive letter of your CD-ROM drive.
Afterward you are shown two screens of default settings. If you don't find these self-
explanatory just click on the OK button to accept the defaults. You can always come
back and change them later.

These two screens may be edited later at any time via the Options menu.

The first of the two screens gives you the chance to specify file paths. You may later want to
copy certain files from the CD-ROMs to various directories on your hard drive. This will greatly
improve performance, especially for authors stored on the inner tracks of the CD-ROM drive
(seek times for these authors are slow). Hesychius, the scholia to Homer, and all the patristic
writers will benefit greatly by this treatment. However, this is an advanced technique and you
probably should delay taking up space on your hard drive until you have an actual need to
improve performance for a specific author. Recently CD-ROM drives have greatly increased in
speed and you may wish to consider upgrading yours as an alternative.

The second of the two screens concerns user preferences. If you select "Always Run
Maximized", whenever you start MUSAIOS it will be expanded in size to take up the entire
screen. The rest of Windows is still running beneath MUSAIOS. You are still free to resize the
window later using the standard Windows techniques.

If you have installed Windows versions of Word, WordPerfect, or Ami Pro, click on the
appropriate radio button. However, these formerly-default locations are actually no longer the
default, and the issue of word processor interfaces will be addressed in a future upgrade. If you
can find where your word processor is installed, and enter the path on this screen, you can
launch it from within Musaios as described in section XXII, below.
IX. OVERVIEW OF OPERATION

There are several ways to perform almost every operation in MUSAIOS. These include via
the menu system using the mouse, via the menu system using the keyboard, via function
and control keys, and via the icons on the "tool bar". It is easiest to start out using the
menu system via the mouse and/or keyboard and learning the alternatives later. Note that
as each menu item in a drop-down menu is highlighted, the "status bar" at the bottom of
the screen explains its function.

Our "beta sites" were given no documentation at all and yet seemed to have no problem learning
the program intuitively from the menu system. We have tried to conform closely to standard and
mainstream Windows practices, so if you are already familiar with a few other Windows
applications you should have no problem at all.

You will also note that once you have opened up a window for a specific text, the menu
system expands considerably, adding items that only make sense if there is a text window
open. That is why you may see references in this manual to menu items that you might
not be able to find. Just open up a text window and the missing menu items will appear.
X. OPENING AND USING TEXT WINDOWS

If you open up the FILE menu, you will see that the first four menu items are: PHI 5, PHI 6/7,
TLG, and "Auto Select". There will be a checkmark next to one of these four items. If you
have not copied files from the CD-ROMs to your hard drive, and you have only one CD-
ROM drive, leave Auto Select checked on the FILE menu. This means that whatever CD-
ROM you happen to have in your CD-ROM drive will be automatically selected for reading.
If you have PHI's Founding Fathers CD-ROM, leave Auto Select checked.

(Once you have copied files from more than one of the CD-ROMs to your hard drive, you require
a way to specify which set you are interested in without having to put the specific CD-ROM in the
drive each time. That is why this option is provided.)

Put the CD-ROM of interest to you in your CD-ROM drive, and use the OPEN menu item in the
FILE menu to open text windows. After you select OPEN, the author list for the CD-ROM
will be shown. Type in the first few characters of the name of the author of interest to scroll
that part of the author list into view. Use the mouse or the down-arrow key to highlight the author
you want. Click on OK or hit return, and you will be shown a list of works for the author, provided
there is more than one work. Repeat this process for the work, and a text window will open up,
displaying the beginning of the work.

You can use the PAGE UP, PAGE DOWN, UP ARROW, DOWN ARROW, HOME, and END keys
to move through the work. You can click on the different parts of the scroll bar, or drag the scroll
bar thumb to move through the work. MUSAIOS responds to scrollbar actions identically to
Word for Windows.

You can also use the JUMP menu to choose a specific location within the work.

You will notice a little pointer >> at the left of each open text window, which always points
to one of the lines of the text. The location information at the bottom of the text window
always specifically describes the line at which the pointer is aimed. Use the up arrow key
and down arrow key to move the pointer.

If you have more than one text window open at a time, you may arrange them using items in the
WINDOW menu. Available are CASCADE, TILE VERTICALLY, TILE HORIZONTALLY, CLOSE,
and CLOSE ALL, which are self-explanatory (just open three text windows and try them all).

The NEXT WINDOW option on the WINDOW menu cycles through your open text windows,
bringing each to the top sequentially.
XI. EXPORTING TEXT TO OTHER PROGRAMS

With a text window open there are two ways to export text to another program, through the
Clipboard (also known as "cut and paste") and by saving text to a file.

For any open text window, you may select text by dragging the mouse, or by using shift-
up-arrow and shift-down-arrow in the standard Windows manner (refer to your Windows
manual if this is unclear). Selected text is shown as white-on-black instead on black-on-
white.

To export text via the Clipboard, use the COPY item on the EDIT menu to export the text
to the Windows clipboard. To save the selected text to a file, use the EXPORT item on the
EDIT menu then enter the filename you wish to use. If the text was being displayed in normal
mode, the text will be exported in Rich Text Format (RTF). In order to paste this text into
a program or open the saved file, the other program must be able to understand RTF. At
this time Microsoft Word is the best example of this type of program. WordPerfect claims
to do this, but does not seem to work correctly with Musaios or any other program. If the text
was being displayed in Beta Code, the text will be exported in Text format. Almost any
program which works with textual data should be able to accept text from the Clipboard
or open a file in this format.

Starting with MUSAIOS 2001 A, much more text can be exported than before to the Windows
Clipboard, or a file in Rich Text Format (RTF). Formerly you could only select for export the text
visible on the screen. Now you can select about 100 lines for export. In this we have
followed the lead of Pandora (software for the Macintosh). The limitation remains at this level at
the specific request of TLG because of concerns about facilitating copyright infringement.

XII. DISPLAYING BIBLIOGRAPHIC DATA FROM THE TLG AND LATIN CANON

TLG:

When you are viewing a TLG text, at any time you can choose "View Bibliographic Canon
Information for This Work" from the View menu. A screen will pop up with information
about the author in the top half of the screen and bibliographic information about the particular
text in the bottom half. You may tab to either of these text segments and then click with the right
button of your mouse to copy the data into the Windows clipboard for pasting into other
applications. (A menu will pop up after your right-click.)

PHI Latin Canon:

Using the Open item on the File menu, type in Latin Canon to scroll the listbox to near the
end. Select Latin Canon and you may search and browse this text file to find the Author
and Work you are looking for. (The format is less sophisticated than the TLG Canon).
XIII. USING THE CONCORDANCE VIEW

A "Concordance View" can be opened for certain authors once you have obtained the
supplemental Musaios Concordance Plug-Ins for those authors. These may be
downloaded from our website at www.musaios.com/plugins.htm. It is a very fast way to
do searching within a particular author. (A separate registration number is required for each
package of related authors. However you may download the plug-ins for evaluation before you
register.) Once you have installed the plug-ins, you may rapidly shift back and forth between the
Text View and the Concordance View. The plug-ins contain no text themselves, but they enable
Musaios to construct the Concordance View on the fly by reading lines in the corresponding TLG-
E or PHI 5.3 CD-ROM text.

For your evaluation, the plug-ins for [Longinus] Rhet. (TLG-E) and Tibullus (PHI 5.3) are
included in the Musaios download from the Internet and on the setup CD-ROM. They are
automatically copied to your hard drive when you install Musaios and are immediately available.

To switch to the Concordance View, open any work by the author you are interested in as
described in the section above. Then from the View menu, choose Concordance View. If
the plug-in has not been installed, the item will be grayed.

The Concordance View may be navigated using the same techniques as are used for text
files. The screen is divided into two halves with a blank stripe down the middle. The
alphabetized words are at the right edge of this central stripe and the following context is
immediately after. Where there is a line break, a few extra spaces are added so the structure of
poetry remains visible. More of the preceding or following context can be seen by dragging the
horizontal scroll bar at the bottom of the screen to the left or right (or using the left- or right-arrow
keys).

The pointer on the Concordance View screen occupies the blank stripe at the center of the
screen. The location pointed to is shown at the bottom left of the screen. You can move the
pointer with the up or down arrow keys.

You can jump within the Concordance View to a specific word or phrase using the Move To a
Different Word in Concordance View item, which appears both on the View menu and Jump
menu when you have a concordance view open.

You can return to the normal view of the full text by choosing one of two options from the View
menu. "Text View (No Repositioning)" returns you to exactly where you were in the text before
switching to the Concordance View. "Text View (With Repositioning)" will cause the Text View to
move its position to that point matching the pointer in the Concordance View.

Just as in the Text View, you can select and export text from the Concordance View.
Location markings will be added for each line. You can also print the screen you are
currently viewing.
XIV. WORKING WITH FONTS

Musaios 2002 A supports the use of multiple Greek fonts as well as the selection of the
size and other characteristics of both Greek and Latin fonts. Although the current operating
systems used on the PC (e.g. Windows 95 and Windows 98) do not support it, there is an
international character coding convention, known as Unicode (ISO 10646). This expanded
character set supports over 65,000 characters instead of the 256 commonly in use today, which
means that every character from dozens of languages, including Greek and Hebrew, have their
own, unique, numeric codes. Internally MUSAIOS 2002 A converts the Beta Code texts into
Unicode; this means that it is ready to work with Unicode operating systems and fonts once they
are widely available. Windows NT 4.0 and Windows 2000 support Unicode but are not yet in
wide circulation for individual desktops.

In the meantime, Musaios uses a priority scheme to map from its internal Unicode representation
of texts to something which can be displayed on the screen. To accomplish this, a list of fonts, in
descending order of priority, is used to tell Musaios how to map Unicode to fonts available on the
system. In its shortest form, this list consists of a Latin font, which maps the standard Latin
characters, and a Greek font which maps the most commonly used Greek characters. This list
may be extended with more fonts, which will fill in any Unicode characters not already mapped
by previous fonts in the list. Thus symbol fonts or characters from secondary Greek fonts can be
used to display less common characters. These mappings are contained in configuration (.ini)
files which can be modified and distributed separately from Musaios itself.

MUSAIOS 2002 A ships configured to use the system Latin and WinGreek fonts it has
previously used. These defaults can be modified as described below. To change font
settings, use the CHOOSE FONTS... item under the OPTIONS menu. This will present the
current list of fonts which Musaios is using. By selecting a font in the list and clicking
the MODIFY button you can alter the size and other characteristics of that font. For the
Latin ANSI font at the top of the list, you could change it from the System font to Times New
Roman for a more graceful font when displaying Latin text. For the Latin ANSI font almost any
normal Latin font can be chosen. For Greek fonts you must be careful not to change the
font itself since this would result in incorrect mapping. For Greek fonts only change the
style (i.e. bold, italic) and size settings.

To add new font mappings to the system, you must have a font configuration (.ini) file for the font
you wish to add. MUSAIOS 2002 A ships with .ini files for GreekKeys and Porson Poly-
Greek in addition to the Latin ANSI and WinGreek files which are installed by default. We
will add to this list as people ask us to support various fonts and font vendors supply us with
sample fonts. If you have both the font (available from various vendors as described in
section VI. above) and a font configuration file, click the ADD FONT button and choose
the .ini file which describes the font (grk_gk.ini for GreekKeys, grk_por.ini for Porson
Poly-Greek). The font will be added to the list above the currently selected font (except
for Latin ANSI, which must always be at the top, as described below). You must install
the font itself into the Windows environment as described in the font vendor's
documentation. After you have added the font to the list, you can select it and use the MODIFY
button to set is size and style as you wish.

As explained above, the order of fonts in the list is significant since the fonts map to Unicode in
the order in which the font mapping files are read. For this reason, the Latin ANSI font map
must remain first in the list, and this dialog box is designed to enforce that restriction.
Other than this font, selecting a font and clicking the MOVE UP and MOVE DOWN buttons
causes a fonts position in the list, and thus its priority in mapping Unicode characters, to be
changed.
If the font capabilities seem confusing, a little experimentation is recommended; it is
easier to make these changes than to explain it. At this time, Musaios must be exited and
restarted for any font changes to become active. This restriction will be removed in a future
version.

XV. PRINTING FROM MUSAIOS

Version MUSAIOS 2002 A of MUSAIOS has only a very basic print capability, although it can do
quite a nice job of printing Greek characters on ink jet and laser printers. When you select
PRINT, exactly the text that is visible on the screen will be printed. The screen where you
select page numbers is not yet implemented. Just click on OK to clear it.

To use the print options, you must have your printer correctly installed into Windows. Refer to
your Windows manual and your printer manual. In case of trouble verify that the printer DOES
work properly from other Windows applications (such as Write) before contacting us. If your
printer does not work in other Windows applications, then you have a problem with your printer
installation, not with MUSAIOS.

The PRINT PREVIEW and PRINT SETUP menu items are fully functional, They are Windows
"Common Dialog" screens, meaning that they are absolutely standard, built into Windows in fact,
and work just like everywhere else in Windows. Refer to your Windows manual..

XVI. SEARCHING A SINGLE TEXT

Beginning with Musaios 2001 A, the FIND option on the SEARCH menu searches the
entire work you are viewing. You can then move backward and forward instantly through
the search results. The FIND NEXT item and FIND PREVIOUS items take as their starting
point the point you are viewing in the file.

The search string may contain embedded spaces if you are looking for a phrase. When
you are prompted for a search string, you are also given the option to set the "Search Mode".
The effect of the Search Mode can be illustrated by example: Suppose you are searching for
the word "wife". The word "midwife" will be found if the Search Mode is set to SUFFIX
or ANY. The word "wifely" will be found if the search mode is set to PREFIX or ANY. If
the mode is set to EXACT WORD, only the word "wife" will be found. The word "wife"
will in fact always be found in all four search modes.
XVII. SETTING UP A MULTI-TEXT SEARCH

If you wish to search the entire corpus of an author, or more than one author, use the
CREATE SEARCH SPECIFICATION item on the SEARCH menu. The first thing you must do
is select the authors you want to search. Highlight them one at a time in the "combo box" on the
left, and click on the Add button. If you make a mistake, highlight the author you don't want in
the box on the right, and click on the Remove button. There is an Add All button which will
add all authors quickly. This feature is now enabled for the TLG discs as well as PHI. But
there are so many authors you may want to use the TLG word index instead (see section
XIX). For each of the three CD-ROMs you may save a permanent default list of favorite
authors. Use the Save as Default List button.

It is easy to search a subset of your permanent default author list. You may highlight
only a few authors (or only one) in the right-hand list by clicking on those of immediate
interest, and only those authors will be searched. If no authors are highlighted, all authors in
the right-hand list will be searched. The Deselect Highlighted Authors button may be used to
bring about this condition if some of the authors are selected. You can also deselect individual
authors by clicking on them again. If they are highlighted the highlighting will be cleared.

Once you have picked your authors, you are ready to enter the search string and search mode.
The same screen is displayed as in the case of "Searching a Single Text" described above, and
the search modes work in the same way.

Once the search has begun, it is conducted in background. You are free to open new text
windows, including the text currently being searched. You can also "minimize" Musaios
and use other applications in Windows while the search proceeds. When the search
completes, you will hear a single "beep". The status bar at the bottom of Musaios's main
window shows the work currently being searched, and the percentage of the work searched so
far.

To view results as they come in, click on the Results button. You will be switched to the
Results screen. The upper left corner of the Results screen summarizes the search and its
progress so far. As incidences of the word arrive, the author, work, and number of occurrences
found so far are displayed in the right hand listbox.

To display the text for an occurrence on the Results screen, highlight the author and work
of interest in the right-hand listbox and then click on the Show Text button. A complete
location reference and three lines of text will be displayed at the bottom of the screen.
The Next and Previous buttons can be used to look at other occurrences in the same work. If an
occurrence especially interests you, you can use the Full Window button and the text will be
displayed exactly as if you had opened up a text window and jumped to the location of the
search word.

Once you have opened up a text window from the Results screen, you may use the FIND
NEXT and FIND PREVIOUS items on the SEARCH menu to look at earlier and later
occurrences without having to return to the Results screen. If you do wish to return to the
results screen, use the SEARCH RESULTS item on the SEARCH MENU. To return to the
Search Specification screen, use the CREATE SEARCH SPECIFICATION item on the SEARCH
menu. For each of the four CD-ROMs, your most recent list of search results are saved on
the hard disk automatically. You may exit Windows and turn off your computer, but the
next time you enter Musaios and go to the Results screen, your last results list will be
displayed.
XVIII. ADVANCED SEARCHING

Version MUSAIOS 2002 A includes two features for performing advanced searches:
wildcard and Boolean searching, both of which are discussed in this section. The
techniques described here can be used in conjunction with the basic search mode
options described above. Since no current search program has any understanding of
morphology or grammar, it is necessary to provide other means, such as wildcard and set
matching to find all occurrences of a given word. To match a single character at any point in
the search string, type a '?' in the string. Please note that multi-character wildcards ('*') are
not yet supported. Also, a set of characters may be specified at any point in the search
string. To use this feature, enclose the character set in square brackets ('[' and ']').
Ranges may be specified with a dash (e.g. '[a-y]' will match all letters from 'a' to 'y', but not 'z').
Character sets are useful when looking for words which may have a long or short vowel
depending on dialect or a constrained set of characters depending on tense or case. The
question mark can also be used in these instances and will find the desired words but may also
find many unwanted words. If the caret ('^') is the first character of the set, any characters not in
the set will be matched. For example 'di[ae]' in the search string will match 'dia' and 'die' but not
''dio' in the text. In contrast, the search string 'di?' will match 'dia', 'die', and 'dio', in other words,
'di' followed by any character. The opposite effect can be obtained with the search string 'di[^ae]'
which will cause 'dia' and 'die' not to be found, but will match 'dio' and any other string beginning
with 'di' without an immediately following 'a' or 'e'.

It is often useful to search for words near each other in a text, without being an exact phrase.
For this purpose Musaios supports four Boolean operators, OR ('||'), AND ('&&'), AND
THEN ('&<'), AND NOT ('&!'). Any of these operators may be inserted between two
expressions in the search string. At this time only two Boolean terms are supported; this will
be expanded in future versions. The OR operator matches any place in the text where either
one or both of the terms connected by the OR operator occur; note that this is not an exclusive
OR; the OR operator will match places in the text where both words occur. The AND operator
matches any place in the text where both of the terms connected by the AND operator occur,
regardless of the order of the two terms in the text. The AND THEN operator matches any place
in the text where the first term occurs in the text followed by the second term. The AND NOT
operator matches any place in the text where the first term occurs without the second term. The
default vicinity used by the Boolean operators is 100 characters, i.e., the effect of the
Boolean operator extends only 100 characters from the first term. It is possible to set this
by using the '#' character followed by a decimal number (e.g. 300). The preferred location
of this option is immediately following the Boolean operator (e.g. '&<#250').
Summary of all special search characters:
&& AND operator finds passages with the two words in proximity, in any order.
&! AND NOT operator finds passages with the first word when the second word is not in
proximity.
&< AND THEN operator finds passages with the first word and the second word in
proximity after the first word.
|| OR operator finds passages with either or both of the two words.
#n sets proximity to n characters (default = 100).
\< at the beginning of an expression sets search mode to PREFIX, thus matching the
expression only at the beginning of a word. Using both this and the following
operator has the effect of setting the search mode to EXACT.
\> at the end of an expression sets search mode to SUFFIX, thus matching the
expression only at the end of a word. Using both this and the preceding operator has
the effect of setting the search mode to EXACT.
[] creates a character set and matches any characters within the set. Ranges may be
specified using a dash (e.g. [1-9] will match all digits except 0).
[^] creates a character set and matches any characters not within the set.
? matches any single character.

In this version the above characters will not be displayed correctly while typing search
strings in Greek characters. Type the above characters on the keyboard regardless of the
screen display. This problem will be fixed in a future version, but it did not seem worth delaying
the introduction of Boolean searching to fix this display problem.

Examples:
"dog||cat" will find any passages containing the word "dog" or the word "cat", or both words, in
any order.

"dog&&cat" will find any passages containing the words "dog" and "cat", in any order, within 100
characters (the default) of each other.

"dog&<#250cat" will find any passages containing the word "dog" followed by the word "cat"
within 250 characters.

"dog&!#175cat" will find any passages containing the word "dog" without the word "cat" within
175 characters before or after the word "dog".

If the above examples were run with the search mode set to ANY, words in the text such as
"dogs", "cats", and "catapult" would all have been matched as well. In order to control this
behavior search modes must be specified.

"dog\>&&cat\>" will find any passages containing the word "dog" (but not "dogs") and the word
"cat" (but not "cats" or "catapults"), in any order, within 100 characters (the default) of each other.

In the preceding example, the word "scat" would also have been matched by the second term.
The search can be narrowed as follows:

"dog\>&&\<cat\>" will find any passages containing the word "dog" (but not "dogs") and the word
"cat" (but not "cats", "catapult", or "scat"), in any order, within 100 characters (the default) of each
other.
XIX. USING THE TLG WORD INDEX

To select the TLG Word Index screen, use the TLG WORD INDEX item on the FILE menu,
(For convenience the item also appears on the SEARCH menu.)

The TLG Word Index screen in appearance and operation closely resembles the Results
screen described above, except for the upper left corner, where there is a listbox which
contains every form of every Greek word in every text on TLG CD-ROM D. You may select
a specific portion of the alphabet by typing in the Greek text. Whenever you stop typing
for one second, the listbox repositions itself. You may also drag the scrollbar thumb in
the standard Windows fashion to move through the list.

When you have found the word form you want, click on the Show Works button to fill the right-
hand listbox with a list of authors and works. Note that to save disk space, the TLG Word Index
files specify works by work number only and not by name. Therefore Musaios displays only the
work number, since the time required to fetch and display the name of each work would make
the index prohibitively slow. You can use the TLG Canon of Greek Authors and Works to
determine the names of the works.

Text for each citation is displayed in the same way as for the Results screen described above.
However, the TLG Index files do not contain location information for each word -- only a list of
authors and works. So once a text is selected for display, further searching must be done. You
will be shown a progress box with a cancel button.
XX. USING THE TLG CANON LISTS

To select the TLG Canon Lists screen, use the TLG CANON LISTS item on the SEARCH
menu. These are various lists of authors and works, selectable by literary classification,
chronologically, by epithet or genre, geographically, etc. You will want to explore these
lists in designing your searches. You can now easily search the authors that you select
via these lists.

Furthermore, the authors on each of these lists can be ordered by TLG number, or
chronologically, and include or exclude the authors not included on the latest CD-ROM. When
you enter the TLG Canon Lists screen, you will see that you can select the ordering by TLG
number or chronologically using the upper of the two listboxes, and can select the list criteria
(geographical, women writers, epithet or genre, etc.) using the lower one. Once you have made
your selections, you may click on the View Contents button and you are moved to the next file
tab in the folder. On this screen, you see the categories in the list in the left listbox, then pick out
the lists you are interested in. You may click on Display to add the authors and works in the list
to the right listbox (the existing contents of the right listbox will be erased). Or you may click on
Add to retain the present authors in the right listbox and add some more from a new list. To
remove authors you may click on individual ones and choose Remove, or clear the list entirely
with Remove All.

Once your right listbox contains a list of authors that you are ready to search, click on Search
These. You will be moved to the Multi-Text Search screen described in section XVII above, and
you will see your authors in the right listbox of that screen.

At this point in the evolution of Musaios, entire authors are always searched, not individual
works, even if the list you were viewing specifies individual works. This refinement will be
addressed in a future release.
XXI. OPTIMIZING SEARCH PERFORMANCE

The basic principle behind speeding up search performance is to make the computer read the
data faster. There are several areas in which to attack this problem, each of which has different
costs associated with it; many of these suggestions can be combined to produce the fastest
possible searching.

The first area concerns faster access to the CD drive. First, and most important when
purchasing a new system, use a 32x or faster CD-ROM. These drives are under $100 in the
US..

The second area involves using the hard disk so that some or all of the files which must be read
are on the hard disk, which is much faster than the CD-ROM. All of these techniques require that
Musaios know both the CD and hard disk locations to search. This can be configured by
choosing the USER FILE INFORMATION item under the OPTIONS menu. This dialog box can
be used to specify different CD-ROM drives for different discs so that TLG and PHI texts can be
available at the same time on a system with two CD-ROM drives. A hard disk path can also be
entered for each database; this hard disk path is always searched before the CD, so any files
moved to the hard disk will automatically be found and used before the CD is checked.

Because the various CD's have files with the same names, it is necessary to put files from each
CD into a separate subdirectory on the hard disk. We recommend the following arrangement on
the hard disk:
C:\
TEXTS\
TLGD\
PHI5\
PHI6\
With this hierarchy on your disk, you would enter "c:\texts\phi5" in the Hard Disk column in the
PHI #5 row and "c:\texts\tlgd" in the TLG CD #D and TLG CD #D Index rows.

Once Musaios knows where to look on the hard disk for the files from various CD's, you can copy
as many files from the CD's to your hard disk as you have room for. The first files to copy are
the authtab.dir files from each CD; this will make loading the author list much faster. Make sure
to copy these files to the correct subdirectories; Musaios will be very confused if you do not. If
you use the TLG index extensively, copy as many of the following files as you have room for to
the TLGD subdirectory; the first three files are very small, but the second two are much larger
and can be left on the CD if you do not have room on your hard disk: tlgwlinx.inx, tlgwcinx.inx,
tlgawlst.inx, tlgwlist.inx, tlgwcnts.inx. If there are certain authors which you use extensively, you
can copy the .txt and .idt files for those authors to the hard disk. You will need to determine the
author number from the TLG Canon in order to know which files to copy. For example, Plato's
author number is 0059, so you would need to copy TLG0059.TXT and TLG0059.IDT to the hard
disk.

As the price of hard disks has dropped, it has become quite feasible to purchase a sufficiently
large hard disk to hold all the material from all the TLG and PHI CD's. A 4GB hard drive, which
will hold at least 6 CD's worth of material, currently costs less than $200. This would also make
all the material available at once, without the expense of purchasing multiple CD-ROM drives. If
you wish to use this configuration, simply setup Musaios to look at the hard disk and copy all the
files from each CD into its own subdirectory as outlined above. Musaios will automatically look
at the hard drive for all files and will never need to look at the CD drive at all; in fact, once the
files have been copied, the machine will not even need a CD drive attached.
XXII. WORKING WITH A WORD PROCESSOR

The USER PREFERENCES item of the OPTIONS menu brings up a screen from which you can
establish information about your Windows-based word processor. Once you have established
this information, word-processor functionality in Musaios is enabled.

Whenever you select the ACTIVATE WORD PROCESSOR item of the EDIT menu, your
word processor is displayed on the screen. If the word processor has not yet been
started, Musaios will automatically start it up, just as if you had switched to the Windows
Program Manager and double-clicked on its icon.

For any open text window, you may select text by dragging the mouse, or by using shift-
up-arrow and shift-down-arrow in the standard Windows manner (refer to your Windows
manual if this is unclear). Selected text is shown as white-on-black instead on black-on-
white. Use the COPY item on the EDIT menu to export the text to the Windows clipboard.

Any other Windows application that has been programmed to accept text in Rich Text
Format (RTF) will be able to Paste this text. This includes Word for Windows, but it does not
include Write, Paintbrush, etc. WordPerfect for Windows 6.x seems not to be able to import RTF
text from Musaios or from any other source.

A high priority for Musaios 1.1 is the implementation of OLE techniques with word processors
and other programs. This will allow you to Copy and Paste with a single click, without having to
make your word processor visible on the screen at all. We will also provide a method to export
location markings.
XXIII. THE TOOLBAR

Once you are familiar with the menu system, learn the toolbar equivalents:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

From left, these symbols equate to:

MENU ITEM

1. FILE OPEN
2. EDIT COPY
3. FILE PRINT
4. EDIT ACTIVATE WORD PROCESSOR

5. SEARCH FIND PREVIOUS

6. SEARCH FIND
7. SEARCH FIND NEXT

8. JUMP BEGINNING OF THIS WORK

9. JUMP GO BACK
10. JUMP JUMP
11. JUMP END OF THIS WORK

12. WINDOW CASCADE

13. WINDOW TILE VERTICALLY
14. WINDOW TILE HORIZONTALLY
15. WINDOW NEXT WINDOW

16. WINDOW CLOSE

17. WINDOW CLOSE ALL

18. SEARCH CREATE SEARCH SPECIFICATION

19. SEARCH SEARCH RESULTS
20. SEARCH TLG WORD INDEX

21. HELP ABOUT

XXIV. ACCELERATOR KEYS

For almost all of the menu items, there are function key and control key equivalents.
These are listed to the right of each menu item throughout the menu system.
XXV. THE WinGREEK KEYBOARD

This table will not be printed correctly by Microsoft Word until you have installed the WinGreek
fonts.

Qq Ww Ee Rr Tt Yy Uu Ii Oo Pp

Aa Ss Dd Ff Gg Hh Jj Kk Ll

Zz Xx Cc Vv Bb Nn Mm

Note that the terminal sigma is lower case j.

For GreekKeys keyboard assignments, please see the GreekKeys documentation.

XXVI. DE-INSTALLATION OF MUSAIOS

From the Start Menu (normally launched by the button at the far lower left of the screen), select
the Settings item, then choose Control Panel. From the Control Panel, launch the Add/Remove
Programs applet. Scroll down through the list of programs, select Musaios, then click the
Add/Remove Program item. After you confirm that you want to remove Musaios and all its
components, full removal will proceed automatically.

Note: These instructions do not de-install WinGreek, which is a separate product by different
authors.
XXVII. IN CASE OF PROBLEMS:

We have inspected a fair number of texts, but nonetheless there are likely to be problems with
some of the texts we haven't looked at yet, especially on PHI 6. If you find a problem, it is
most important that you record AUTHOR (or COLLECTION), WORK, and ALL LOCATION
INFORMATION, and include them explicitly in your report to us. This will maximize your
chance of getting it fixed quickly.

We solicit all kinds of comments, including comments on "merely aesthetic" matters to help us
set priorities as we plan our work for future releases.

The preferred method of correspondence is by Internet E-mail. Contact:

DARL J. DUMONT at ddumont@musaios.com

or
RANDALL M. SMITH at rsmith1@rpprog.com

You may also write to the project's business address listed at the beginning of this document.

Due to the fact that we both have full-time jobs, it is impossible for us to receive phone calls at
home or at work.

XXVIII. LEGAL NOTES AND DISCLAIMER:

After receiving a copy of MUSAIOS from whatever source, you must register and pay within 30
days, or else de-install the product from your computer and cease using it.

IN NO EVENT WILL THE AUTHORS OF MUSAIOS (DARL J. DUMONT AND

RANDALL M. SMITH) BE LIABLE FOR ANY DAMAGES WHATSOEVER
(INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS OF BUSINESS
PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION AND
THE LIKE) ARISING FROM THE USE OR THE INABILITY TO USE THIS
PRODUCT, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE POSSIBILITY
OF SUCH DAMAGES.

Destination control notice: United States Law prohibits disposition of this software to Afghanistan, Cuba, Iran,
Iraq, Libya, North Korea, Serbia, Sudan, or Syria unless otherwise authorized by the United States of America .

DOSTM, Windows TM, Windows for Workgroups TM, Word For Windows TM, and Windows
NTTM are trademarks of Microsoft Corporation.

WordPerfect TM is a trademark of WordPerfect Corporation.

AmiProTM is a trademark of Lotus Development Corporation.

SoundBlasterTM is a trademark of Creative Labs Inc.

MusaiosTM is a trademark of Darl J. Dumont and Randall M. Smith.