home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Supreme Volume 6 #1
/
swsii.zip
/
swsii
/
226
/
SUDSW11.ZIP
/
SUDSW.DOC
< prev
next >
Wrap
Text File
|
1993-02-16
|
20KB
|
458 lines
SUDSW version 1.1
Copyright (C) 1993
by
Michael C. Taylor
All rights reserved
Introduction
The key to successful brewing lies in keeping good
records of each batch! Like most, I tend to learn from my
experiences (good and bad). My weak point has always been
in locating the scraps of paper where I invariably kept my
brewing notes.
This was the inspiration for SUDS - the brewers
cookbook and log program. From a simple attempt to
coordinate some recipe and log notes, SUDS turned into a
year-long project and has resulted in an extremely
comprehensive brewer's program.
This is the second major release of SUDS for Microsoft
Windows 3.x and involved almost a total rewrite of the DOS
version. The two versions are extremely similar and share
the same file structures. You can move easily between both
versions and can even keep both in the same directory if you
wish!
SUDSW includes the following features:
o DBASE III compatible recipe and log files which can be
browsed by any utility capable of viewing DBASE III
file formats.
o Multi-windowing editor featuring undo, full cut and
paste capability between windows, mouse support and
Windows clipboard import/export.
o Ability to import and export standard ASCII text files
to and from the SUDS recipe database allowing recipes
to be shared with SUDS and non-SUDS brewers.
o Ability to import and export formatted SUDS SXF-files
allowing you to share your recipes easily with other
SUDS and SUDSW users.
o Recipe and log printing and reporting capabilities.
o Categorization of recipes by type (ie Pale Ale, Stout
and any categories you may have defined)
o Built-in pop-up calculator to help with calculations.
o Built-in pop-up calendar
o Hop-IBU spreadsheet to calculate hop IBUs for beer
batches.
o Printing of beer labels.
SUDSW is not, nor has it ever been free software or "Public
Domain". SUDSW is being distributed as shareware and
continued use beyond the 30-day trial period is prohibited.
Unlike a new recipe, SUDSW is a no-lose proposition! You're
free to try out SUDSW for a 30 day period after which you can
pay the nominal $15 registration fee if you are satisfied.
Because SUDSW is distributed as shareware, you are strongly
encouraged to share SUDSW with other brewers. I would ask
only that if you do use the program, you pay the
registration fee. Shareware only works as well as it is
supported and this helps keep software prices reasonable!
The support for SUDSW will help determine whether or not it
will continue to be released as shareware.
Hardware requirements - This release of SUDS requires at least
2 megs of memory and Microsoft Windows release 3.0 or higher
(or OS/2 2.0).
Installing SUDSW
SUDSW is distributed in either a ZIP file or a self-
extracting archive file called SUDW10.EXE. If you have
SUDW10.ZIP, you will need a utility to "UNZIP" the file
(PKUNZIP, XTGold, etc.).
To install SUDSW do the following:
Create a directory on your hard disk to house the SUDSW
files (named SUDS or SUDSW for example).
Copy the SUDW10.EXE or SUDW10.ZIP file into the
directory.
Change into the directory (ie CD \SUDS).
Type "SUDW10" at a DOS command line (or DOS window)
to extract SUDW10.EXE; or "unzip" SUDW10.ZIP with
your unzip utility.
NOTE - Previous users of DOS SUDS: You will probably want
to install SUDSW into your current SUDS directory. This
will allow both versions to share the same set of files so
you can run from Windows or DOS!
SUDSW should now be installed on your computer. You may want
to create a group in Program Manager to add SUDSW to (See
Windows documentation for details on program manager).
Now that SUDSW is on your system, you should type "DIR" and
see at a minimum the following files:
SUDSW.EXE - SUDSW program file
SUDSCVT.EXE - Conversion program to update files from 1.0
SUDSHST.DAT - Configuration for for SUDSW
BWCC.DLL - Needed to run SUDSW
SUDSW.HLP - On-line Help file for SUDSW
SUDSW.DOC - Documentation file for SUDSW
README.TXT - Short introduction to SUDSW release
REGISTER.TXT - SUDSW registration form
RECIPES.SXF - "Starter" set of recipes to import into
SUDSW.
Once your installation is complete, run SUDSW from the
Program Manager group you set up or from File Manager.
This will put you into the multi-windowing SUDSW desktop.
Select the "Options" menu with the mouse or arrow keys and
then select the "Import SXF file" option. This option is
used to import recipes that have been saved in the SUDS
"SXF" file format. The file RECIPES.SXP provided with SUDSW
contains several recipes to get you started. Select the
"RECIPES.SXP" file from the Import list. This will load the
SUDS database with the starter-set of recipes.
The SUDSW environment
If you've used the DOS version of SUDS or are familiar with
any standard Windows applications, you will quickly feel
right at home with SUDSW. You'll find a menu along the top
of the screen with pull-down options. Take advantage of the
help function! This describes all of the major functions
of SUDSW.
Whenever you are editing recipe or log information, you will
find vertical and horizontal "scroll-bars" along the free-
form editing areas. You can page through textual
information with the standard keyboard keys, by clicking the
mouse on the scroll-bars or by dragging the scroll-bar
indicator (small box) with the mouse.
The editor used in SUDSW is extremely easy to use and has
full editing features in the Edit menu including an "UNDO"
command that will undo changes made.
The right mouse button in several places is active to
provide a "shortcut" to one of the menu options. For
example, while editing an existing recipe, pressing the
right mouse button will display a list of log entries for
the recipe (if any exist) providing a means to edit or add
new log entries for the recipe. The right mouse button is
also active in date fields and the HOP IBU field in the log
detail screen.
The SUDSW environment allows any number of windows to be open
at one time (limited only by the memory on your PC). The
best way to get familiar with this is to experiment with the
program. Open one or 10 windows! You can switch between
windows by clicking on any exposed portion of a window, or
by selecting a window from the Windows file option. If a
window is not visible (ie is covered by another), use the
Cascade or Tile option from the Windows menu at the top of
the screen to rearrange the windows.
When saving recipe information or log information, SUDSW uses
dialog boxes to enter field by field information. Use the
tab and back tab keys to skip from field to field. If you
use to mouse to go directly to a field, hold down the left
button and drag across the field if you intend to change it.
If you then type something, the field will change to the new
information (you could also press delete to remove the old
value before typing). If you use tab and back tab, you
won't have to worry about this. Again, explore and have a
home-brew!
All SUDSW screens provide on-line help available by pressing
the F1 key. This provides context sensitive help particular
to the function you are attempting. Use this frequently!
The SUDSW database stores information in DBASE III compatible
files. Information within SUDSW is organized into recipes
within beer categories and log entries for recipes. To
enter a log entry requires that a recipe entry first exist.
Hop information can also be entered for any log entries.
You must first have a log entry before using the HOP IBU
spreadsheet.
You can transfer text to and from different SUDSW windows (or
within the same SUDSW window) by using the commands found
under the Edit menu. SUDSW uses the standard Windows "clipboard"
to allow you to Cut, Copy and Paste text information to and
from windows or even other Windows applications.
To copy text into the "clipboard", you first must mark the
block to copy. With the mouse this is done by holding down
the left button and dragging across the desired text. Once
the text is marked select the Cut command to MOVE the text
into the clipboard, or the Copy command to COPY the text
into the clipboard.
To copy text from the "clipboard", move the cursor to the
desired location for the text and select Paste from the Edit
window. After one or two tries, this should be intuitive.
Entering Recipes
Recipes can be entered into SUDSW in many ways. You can key
in a new recipe entirely from scratch. You can open any
ASCII file (for instance a recipe downloaded from
CompuServe) and then save the recipe into the SUDS database.
You can also do combined functions such as opening a file,
selecting recipe information and copying the information
into another window (ie for Internet newsletters).
To enter a recipe from scratch, you would select New Recipe
from the File menu of SUDSW. This opens up a blank edit
window into which you would enter your recipe text. When
you complete your keying, pressing F2 or selecting the Save
option would display the Recipe details screen. Here you
enter any pertinent information about the recipe such as
starting and finishing gravities, category (Pale Ale, etc.),
method (ie Extract, Full Mash). Selecting OK would then
save the recipe into the SUDSW database.
To import a recipe from a file you would select the Open
File option from the File menu. This would bring up a list
of files in the current directory. You can select files
from other directories by clicking on any directory names
from the Open file dialog box. Once you select a file, an
edit window will be opened showing the contents of the file.
Here you can edit or change any recipe information and then
save it back to a file or into the SUDSW database from the
File menu.
A good source of recipes is the Internet newsletter
available by Internet Email or on CompuServe in the Beer
forum. These newsletters often contain a wealth of
information as well as recipes. To extract a recipe from
within a file proceed as follows:
o Use the Open File option to open the file
o Find the recipe in the file
o Mark the recipe with the mouse or keyboard commands
(See above)
o Select the Copy command from the Edit menu at the top of
the screen.
o Select New Recipe to open another empty window.
o Select the Paste command to copy the text you previously
copied into the "Clipboard" into the new window.
o Save the recipe from the new window into the SUDS
database.
This really is much easier than it sounds. With a little
trial and error, you'll find that cutting and pasting is
usually the easiest way to create a new recipe since most
recipes are variations of one kind or another.
With SUDSW you can also import recipes from other SUDS users!
This is nicer than importing ASCII files since SUDS "SXF"
files already include any Recipe detail information. From
the SUDS Options menu, you can export your database to any
"SXF" file or import any "SXF" file.
Note - The file structures are IDENTICAL for both DOS SUDS
users and Windows SUDS users so files may be easily exchanged
and you can use either version interchangably.
The import will list any "SXF" files in the current
directory. Selecting a file will load any non-existing
recipes into your database from the "SXF" file. If the
recipe name already exists in your database, it will not be
replaced! This is how the SUDS STARTUP recipes are
distributed (in file RECIPES.SXF).
You are encouraged to share any "SXF" files you wish with
other users via BBS's, CompuServe or just among friends.
Please be sure to let users of your "SXF" files know that
SUDS or SUDSW is required to use the files. Actually
"SXF" does not use a complex file format at all, so non-SUDS
users could read the contents with any browse utility!
Entering Log Entries
Log entries can be entered into SUDSW only for recipes in
your SUDS database. NOTE - If you wish to enter log entries
for recipes that you do not wish to enter into SUDSW, you
will have to create a "dummy" recipe. To do this, just
create a recipe with no text, and give it a name when you
save it.
To enter a log entry for a recipe, you must first open the
recipe file (see above). When the desired recipe is
displayed, either click the right mouse button, or select
the Open Log option from the SUDSW File menu. If any log
entries exist for this recipe, a list will be displayed
which allows you to select existing log entries or add new
ones. If no log entries existed for the recipe, you are
taken directly to the log detail screen.
The log detail screen contains a number of fields pertaining
to a particular batch of the selected recipe. These
include: Date started, Date bottled, Starting and Finishing
gravities, Hop IBUs and free form notes.
Here you fill in or update any information pertaining to
your recipe batch. Several "shortcuts" or help functions
exist for these fields to assist you in entering.
Date fields: pressing "+" or "-" in a date field will
increase or decrease the date by one day. Pressing either
with a blank date will fill in the current date.
Hop IBUs: Pressing the right mouse button or selecting HOP
IBU Spreadsheet from the tools menu will bring up the HOP
IBU spreadsheet used to calculate HOP IBUs (International
Bittering units). The Hop IBU spreadsheet allows you to
enter up to 4 different hop lines to calculate the IBU
value.
Log Notes: The log notes field works exactly like the recipe
edit windows (see above). The only difference is that the
tab key will jump you out of the log note field to the next
field. This is where you will enter any comments about the
batch you are brewing.
If no recipes are open when you select the Open Log option
from the SUDS File menu, you will get a chronological list
of all log entries in your database. Here you can edit any
existing log entry.
Printing Recipes, Log Entries or Labels
Selecting Print from the SUDS File menu (or pressing Alt-P)
will bring up a print confirmation box for the current
recipe or log entry.
For a log entry, selecting "Yes" or clicking on the Yes
button will print the current entry.
For a recipe, 3 check boxes are displayed allowing you to
specify whether to print recipe text, stats and log entries
for the recipe.
When a log entry is displayed, you can select print labels
from the SUDS tools menu. This will display a sample label
that you can customize. SUDS will print labels on standard
1-up mailing labels. You can edit any of the information
shown on the sample label and can override the number of
labels to print.
Appendix A - Technical information
Suds was developed using Turbo-Pascal for Windows 1.5,
and Topaz database manager 3.5.
The files used are standard DBASE-III+ compatible files.
However, the index files (*.IND) are not DBASE compatible.
If you intend to use DBASE against the files, you will have
to index the files yourself. You should periodically select
the Pack option from the SUDS Options menu to optimize
indexes and reclaim deleted space.
A non-Windows version of SUDS is also available and is
functionally equivalent to the Windows version.
The DOS version is called SUDS13.EXE or SUDS13.ZIP and is
available via the Compuserve Wine forum and various BBS's.
SUDSW REGISTRATION FORM.
NOTE - If you are already a registered user of SUDSW 1.0,
(meaning you've paid the fee already), this upgrade is
FREE! No upgrade fee is required.
If you register before 12/31/93 and enclose one of your
own recipes to be included with future releases of SUDSW
(your name will also be included) you can register SUDSW for
$10 rather than the full price of $15. Currently REGISTERED
users of DOS SUDS may upgrade to Windows version for $7.
Just copy this file to your printer, fold, and mail to
Michael Taylor
1626 Main Street
Bethlehem, PA 18018-1905
Enclosed please find $____ for the following:
[ ] $15 to register SUDSW 1.1
[ ] $10 to register SUDSW 1.1
(I am enclosing recipe with order)
$10 offer expires 12/31/93.
[ ] $7 to register SUDSW 1.1
(Currently registered users of DOS SUDS only!)
Name:________________________________________________
Address: _______________________________________________
_______________________________________________
State: ___________________________ Zip:_______________
SUDSW 1.1 was acquired from:
[ ] friend
[ ] free BBS, name and phone #
[ ] pay BBS (i.e., CompuServe)
[ ] disk duplicating service, name
[ ] user group
[ ] other_________________________________________
Comments, suggestions: