

                       Words-View 1.0 for Windows                p 1 of 6.
                       c 1997 by Peter Neuendorffer

                                 Manual


Register this software:

This software is not free. To register it, and receive a registered disk, send
$25.00 to:
                 Peter Neuendorffer,
                 1399 Commonwealth Ave #11,
                 Allston MA 02134
Peter's Internet email address is petern@user1.channel1.com. Registered
users will receive a "nagless" disk as well as phone and email support for
the product.

System requirements: Windows 3.1, 3.11 or Windows 95. 8 megs RAM, at least 3MB
free disk space when running the program. High speed CPU recommended.


This program allows you to view the content of text files in a different way,
by cataloging the files. Up to 250 files may be catalogued. You can catalog a
single file or an entire directory. Word lists are created and saved for up to
250 files.

This can be useful to many creative professions, such as:
writers, editors
scientists, computer scientists, astronomers, anthropologists
people who write using technical words.
hobbysits and collectors - art collectors.
and anyone who saves a variety of text files on their computer.

When you view the words from text out of context - in a list -
words stand out that you might not ordinarily associate with the
file. Also, you can create short keyword lists to help you read the file.

------->Note in most cases, when you have a list box, a single click on a
line selects the item. A double click on the item will select the item and
perform the task for the box.


Cataloging Files:

Select a text file from your system with File/Open. (or click the Open 
button) A list of all the words in that file will be made. To stop at any 
point, click on "Stop Catalog." The cataloging starts from the beginning 
of the file and goes to the end. The percent looked at is shown at the bottom
of the screen.


You may force a rescan on the current file (listed at the top of the main
screen) by clicking the Rescan button.

-----> This software will display WordPerfect and Word files, as well as
plain text files. although some formatting characters may be shown.
When you display the file's text, you may wish to check on the
"small fonts" checkbox. It is recommended you do this at the
first display of the file.






                            Words-View manual                         p 2.


Word Size:

Set the minimum size of words to be cataloged by selecting Options/minumum
letters from the main menu. Set the minimum size and click on OK. All the
options are described at the bottom of this article.


Frequency Counts:

The first list is alphabetical. To sort the list by frequency in the file,
select the Frequency option dot at the left. This can also be done later.
Click on "stop sorting" to stop.


Viewing Text:

Double click on a word in either the alphabetical or frequency list. You are
shown the file with the first found of this word highlighted. To find other
occurences, click on Next. Note large text files are broken up into 29k blocks
which may be accessed from the slidebar at the top of the screen.

From the main screen,  you can also view a word in the file by single-clicking
a word and clicking Find (same as double-clicking the word to fine from the
list.)  Or you can view the text with no particular word by clicking on Top.

-----> In fact, any time you see  a Find button, select a word to find from
the listbox to the left, and click Find. This is the same as double-clicking
the word in the list box. Clicking at Top will bring you to the beginning of
the file's text. You may drag and drop words to any Find or Top button.
-----> You may drag and drop words to "Keyword" button to add the word to the
keyword list.

From the text display screen, you can click Custom to manually type your own
search word. Click on OK to find first. If you wish to change the catalog
search word or keyword, click on Exit on the text screen.
-----> To return to the word list, click on Exit.


Paragraphs:

Whenever possible, from the text display screen (you got to it from the Top
or Find buttons) you can display a list of beginnings of each paragraph. Click
on Paragraph from the text display screen. You can go to a given paragraph by
double-clicking on a line in the list. This option works best on files which
are single spaced or with indented paragraphs. Note you do not need to
catalog the whole file for this option to work.


Accessing Cataloged Files:

To access previously cataloged files, select Open/Catalogued from the File
menu. You will see a list of all files previously cataloged. When you double
click on an item, it is like doing a file open on the file, except that the
catalog information will be retrieved without the need to wait again.

From the list, you may delete an item by selecting it, then clicking on
Delete. Please note, you are only deleting the catalog information for this
file, you are not deleting the file itself. You can remove all catalog
information with Clear (use with care.)




                            Words-View manual                  p 3.


The software looks for text files in original location of the file. If a file
is moved after cataloging, the file cannot be found for the catalog
information. However, the actual catalog information is always saved in the
Words-View program directory.

When you click on a previously cataloged file, it checks the date-time stamp
on the file to see if it is the same as when it was first cataloged. If the
stamp is different, indicating the file has been edited since, a message
"catalog data out of date" will appear, and the program will proceed to
re-catalog the file.

When there are already 250 files cataloged, when you catalog a new file, the
first item is dropped, and all other items moved up. Then the new catalog
information is placed in the 250th place. Thus, you can catalog new files,
but only 250 maximum may be cataloged.

Note that if a cataloged file is itself moved or deleted, the catalog
information will be automatically removed when you run Words-View.

You can check the check box to just see the file names without
their paths. Or uncheck the box to see the paths.


Directory Cataloging:

You can catalog a group of files from a directory. Select File/Directory.
Choose the drive and then choose the directory by double-clicking the
directory list box. Choose the file mask (such as *.txt, *.doc) in the edit
box at the top of the Window. To start the scan, click on the "Ok" button.

You have a couple of options. If you want to force a rescan of all files,
check off the rescan check box. If you only want to search the first 100
lines, or first 200 lines of each file, check off the appropriate option dot.

If the software encounters an already-catalogued file, it will check
to see if the date-time stamp has changed. If it has, then the file will be
re-cataloged. Otherwise it will not be re-cataloged (unless you checked the
rescan all files check box.) The minimum word size is as you set it in the
rescan window. You can see how many files having your selected file mask
in the directory there are by clicking on "how many."


Job Queue: This is much like the directory cataloging option, except that you
can specify a list of files to catalog, no matter what the directory. Select
files by selecting the drive and directory (double click on directory box)
then double click on a file name to add it to the queue. When you are done
with the list, click on OK to catalog the list of files you have made.
You can bring in the entire list of previously cataloged files to redo by 
clicking on "All Previous Cataloged." You can also add files to the job
list by dragging them from the bottom left box to the job list.













                            Words-View manual                  p 4.


Compare:

You can get a list of words that is common to two files. This is accomplished
in two steps. First, select any two files from the large listbox of previously
cataloged files at the top of the File/Compare screen, then click on Compare.
Then, when the software is done, click on one or the other of the two files
in the second list box, then double click on a word to view it in that file.

The listbox at the bottom of the screen contains those words that are in both
files. The list is compiled from the word lists for the files AS CONTAINED IN
THE PREVIOUSLY CATALOGED LISTS for those two files.

You may stop the compare process after clicking on Compare by clicking on the
"stop compare" button. Checking "ignore common words" will filter out the
common word list in compiling your combined list.


Word Find:

You can find a list of files (from the cataloged information only) that
contain a given word. Select File/Word-find-in-files and enter a word to find.
Then click the Find button. A list of files from the cataloged list will
appear below. To go to a file, double click on the file name, or select a
file and click on OK. This is the same as opening a file in the catalog list.

Please note the found words are only based on the current catalog information.
If, for example, a file was only 10% cataloged, some words might not be found.

You can search for more than one word by clicking on AND or OR, and typing in
a word in both edit boxes. If AND is chosen, both words must be present in
each file. If OR is chosen, either word can be present in each file. You
can also drag and drop a word from the main screen word list. Drop the
word over the "Cataloged" button to do a "word find in file."


Keywords:

You can select a smaller list of words for each file, usually ones which
serve as main keywords for the file. Also, you can write a brief (60
character) description for each file. When a file is selected in the main
screen, click on the Keywords button at the bottom right of the main screen.

To change the description for the current file, simply type in the new
description below "description." You may wish to use the first line of the
file for the description, by clicking on "use first line."

There are two list boxes on this screen. The left-hand one is the current list
of words from the main screen for the current file. The right-hand box
contains the current keywords you have chosen. Note that even if you do a
rescan on the file, the keywords will be kept. (Only when the file's time
stamp changes and a rescan is done will the keywords be erased)












                            Words-View Manual   p.5


To add a keyword, double click on a word in the left hand list. To delete a
keyword, select it in the right-hand list and click on delete. You can erase
the entire keyword list for this file by clicking on Clear. To view the
keyword as it appears in the file, double-click on a keyword in the right-
hand list. You can also add keywords by dragging a word from the left
listbox and dropping to the right listbox.



There is another way to add keywords. Open a file, and click on Find or Top
to bring up the file's text. Then every time you double-click on a word in
the text, that word will be added to the keyword list. A third way to
add keywords is to drag a word from the main screen word list. Then drop
it over the "keywords" button.


Using Editors:

You can specify one or two editors (or word processors) to edit the current
file. To set the editors, select Options/Set Editors. Then either type in
the complete path of the editor(s) - including the file name; or you can
obtain the editor path by clicking on the browse buttons and selecting the
editor or word-processor .exe on your system.

To edit the current file, click on Edit and click on the editor or word
processor to use. The editors are set in the Options/Set Editors window.
Notepad is the default for the first editor. When you are done editing the
file, close the editor program (and save your changes if desired.) Then
maximize the Words-View program. If the current file has been changed the
software will proceed to re-catalog the file.


Options: (from the main menu Options)

The options effect how this program catalogs words from text files. These
options are saved for the next session. Also the saved catalog data is based
on the options at the time of the scan. If you want to change the options for a
cataloged file then change the options and do a "rescan" for the file..

Minimum word size can be set so the cataloging only looks at words of a
minimum size, say 4 letters for example.


Ignore Words is a list of words that the software will ignore in text when
compiling word lists. This option is enabled by checking off the checkbox in
the Options/Ignore Words window. You can add and delete words from this list.
Either by double-clicking words from the currently opened file, or typing
in your own words and clicking on Add. Select a word and click Delete to
remove a word from the ignore-word list. You can restore the original words
that shipped with Words-View by clicking on Factory.

You can also add words to the ignore list by dragging words from
the lefthand listbox and dropping them in the ignore list.










                            Words-View Manual    p. 6


Punctuation allows you to specify that certain punctuation may be included
in words. If hyphen is checked then hypenated words are included
("pre-emptive" for example.) If underscore is checked then the underscore
character may be included in a word. This is especially useful if you are cataloging
computer program source files (my_procedure for example.) The apostrophe
works similarily ("couldn't" for example.)

Please note the options set in the File Directory and File Compare screens
are not saved for the next session..

You may disable a message that will pop up when the list of catalogued
files if full (250). Since when you catalog the 251st file, the first
file catalog data (NOT the file itself) rolls off your list, you are
prompted with a message to continue. Check off this option if you do
not want to see that message.


Directory Move:

You only use this option if you have moved files that have been cataloged.
This option does not actually move files. It only tells the software the new
location of any cataloged files you may have moved. This directly affects the
listing File/Open Cataloged files menu option. It is usually used upon startup
of the program when you are prompted that files may have been moved on disk.

For example, suppose you had cataloged the file c:\doc\alice.txt with this
program. Then later you moved the file to c:\hello directory. This option
gives you a way to update the catalog data for this file so it can be found
by this software.

Select either file or directory or moved files. If you are talking about a
single file, use the file or "moved files" option. If you are talking about a
whole directory, use the directory option. Choose the old location, then
choose the new drive and directory (double-click the directory box at the
bottom.) When the old and new settings are as you want them, click on Rename
to make the change. Note this option does not deal with subdirectories, which
must be chosen one at a time.

When you load in the program each time, the program checks to see that the
cataloged data points to real files on disk. If not, you are asked if you
wish to rename any directories, and the directory move screen is brought up.
Afterwards, at any rate, the software will automatically remove any catalog
data that doesn't point to a real found file. The software never deletes
actual files, just the catalog data.

The software will not check for correct destination if you choose directory. 
It is up to you to make sure the new directory is correct.















