DIPLOMATIC E-TEXT OF _BEOWULF_, v2.3

(C) System Design and Texts, Copyright Rochelle I. Altman (1994, 1992).
(C) Pascal Code, Copyright William Altman (1994).
Permission is explicitly granted for any non-commerical use of this
material without restriction, and in any form required by the user,
provided that  appropriate notice is given of its copyright status.


                                                    Quick Reference Guide 1

USING THE DIPLOMAT TEXT UTILITIES

First:

Make a new directory called BIOWULF.
    IMPORTANT:   Please name your new directory BIOWULF. All of the programs
    in the utility package have the name BIOWULF in the path.

-   Transfer the ASCII files to the new directory.
-   Transfer the utilities package to the new directory.
-   Execute the Self-Exploding Software package DIPLOMAT.EXE.

Then write:

      Command line                           Description

DCOD BEO1.EDN              Decodes the TEI encoded Master Text. DCOD first
                           calls the ENTITY table (BEO.ENT), then the TEI
                           endcoded Master Text (BEO1.EDN), e.g.DCOD BEO BEO1
                           will decode BEO1.EDN according to BEO.ENT and
                           produce BEO1.MST.

*MAKEECT FILENAME.SRC      Create the Edition ConTrol file. The output file
                           has the extension .ECT.

       INPUT FILENAME             OUTPUT FILENAME         EDITION NAME

         MANU.SRC                   MANU.ECT               MANUscript
         DOE.SRC                    DOE.ECT                DOE
         KLAEBER.SRC                KLAEBER.ECT            KLAEBER
         THA.SRC                    THA.ECT                THorkelin A
         ZUP.SRC                    ZUP.ECT                ZUPitza-Davis

       * You do not have to perform this step as the five .ECT  files are
       included in the DIPLOMAT.EXE compressed file. However, if you make
       any changes to the Edition ConTrol SouRCe file (FILENAME.SRC), you
       will have to make a new ECT. (See ECTTOTXT).

EXTRACT FILENAME           Enter one or more edition names  separated by a
                           space, e.g. EXTRACT THA ZUP.  Two editions will
                           be regenerated:  Thorkelin A  and Zupitza.  You
                           may extract all five editions at once by writing:

                           EXTRACT MANU DOE KLAEBER THA ZUP

                           The OUTput is FILENAME.OUT.

The edition texts are now ready to be transferred to your TEXT editor.

                                                    Quick Reference Guide 2

NOTE: If you intend to work with e-texts -- either to use or to create new
ones -- you probably should import a text editor from an FTP site. While it
is safer to use a TEXT editor, you may use Word or WordPerfect, for example,
but be sure to save the files in TEXT mode.  If you use Windows, be careful
not to use Word or WordPerfect for Windows, instead choose the icon for
normal Word, etc. Windows operates only in graphic mode and will not display
the screen fonts.

      Command line                           Description


FNTLOAD EDITIONNAME            Loads an EGA/VGA Text Screen Font named in
                               the Edition ConTrol file.
                               To return to normal screen mode, either
                               write MODE CO80 <CR> or FNTLOAD <CR>
                               (without an Edition name).


PRNTLAS EDITIONNAME            Downloads the printer font named in the
                               Edition ConTrol file to an HP Laser II
                               compatible printer, then sends the edition
                               output file to the printer.


ENCOD BEO FILENAME.OUT         Converts a text back to e-mailable format.
                               Output is FILENAME.EDN, e.g. ENCOD BEO THA.OUT
                               will encode THA.OUT according to BEO.ENT and
                               produce THA.EDN.


ECTTOTXT  asks for an ECT      Converts an *.ECT file to an Edition Source
          file name and        file for editing.
          request an output
          file name, e.g. DOE.SRC


     Any changes you may wish to make to the Edition Control File should
     be made through the SouRCe files. ENTITY definitions, abbreviations
     and decimal equivalents may be found on pages 3-4 of this guide.
     After you have made the desired changes,  you must make a new ECT by
     running the MAKEECT compiler. The following example is the ECT Source
     file for DOE. Explanatory comments are written within a pair of angle
     brackets.
                                               Comments


MASTER: c:\BIOWULF\BEO1.MST       <root directory:\directory\*.MST        >
EDITION: DOE.OUT                  <Edition NAME.OUT                       >
EDITNO: 2 of 5                    <Number of the Edition where MANU is #1 >
SCREENF: c:\BIOWULF\FIXED.FNT     <root:\directory\screen font name       >
FONT: c:\BIOWULF\FIXED.SFP        <root:\directory\printer font name      >
PEJ:  NO                          <Page Eject - YES or NO                 >
PLUS: NO                          <Retain hidden letter marker - YES or NO>
XLATE:                            <Translation Table - indicates letters  >
                                  <to be collapsed. The input may be decimal>
                                  <(101), alpha ('e'), or hexidecimal (65H).>
                                  < *translation table continued on page 3* >

                                                     Quick Reference Guide 3

<! -- ENTITY taelig     >                167    = 145
<! -- ENTITY caelig     >                215    = 145
<! -- ENTITY haelig     >                168    = 145
<! -- ENTITY htaelig    >                169    = 145
<! -- ENTITY yogh       >                165    = 'g'
<! -- ENTITY RusticA    >                172    = 41H
<! -- ENTITY BowA       >                173    = 'A'
<! -- ENTITY LatA       >                174    = 'a'
<! -- ENTITY e-         >                226    = 'e'
<! -- ENTITY e--        >                228    = 'e'
<! -- ENTITY em-        >                216    = 101
<! -- ENTITY E          >                156    = 101
<! -- ENTITY E-         >                157    = 101
<! -- ENTITY lows1      >                158    = 's'
<! -- ENTITY lows2      >                159    = 's'
<! -- ENTITY longs      >                175    = 's'
<! -- ENTITY avir       >                220    = 'a'
<! -- ENTITY aeligvir   >                223    = 145
<! -- ENTITY evir       >                217    = 'e'
<! -- ENTITY ivir       >                221    = 'i'
<! -- ENTITY ovir       >                219    = 'o'
<! -- ENTITY uvir       >                214    = 'u'
<! -- ENTITY UncE       >                229    = 'E'
<! -- ENTITY ydot       >                218    = 'y'
<! -- ENTITY Carriage Return >           '$'    = 0DH

END:                              <Indicates End Of File (EOF).      >
                                  <The ECT is a compiler.  Do not    >
                                  <forget to write END:, or you will >
                                  <get an error message.>

<    Note that anything enclosed by angle brackets is a comment.   >
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =

DIPLOMAT is very flexible.  The utilities package has been designed specifi-
cally to implement the creation of E-Texts in general and diplomatic or stem-
matic in particular. The software was coded in an almost standard PASCAL to
facilitate system independence. An experienced programmer can easily make the
slight changes needed to allow DIPLOMAT to run on other computer platforms.
The PASCAL source files are available upon request. Full operating instruct-
ions and information on implementing the multiple uses of DIPLOMAT are in the
forthcoming USER'S MANUAL.
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =

ENTITY DEFINITIONS, ASSIGNMENTS, AND DECIMAL EQUIVALENTS

The following are specifically meant for a PC compatible environment, and
apply to both the specially designed EGA/VGA screen font and HP II PCLIV
fixed 10 point printer font included with this package. If your equipment
requires another configuration, you will need to reconfigure or replace the
ENTITY codes, i.e. exchange code numbers. You may implement the ENTITY re-
placement on the ENTITY Table (BEO.ENT) or, preferably, on the Edition
ConTrol source file. (See ECTTOTXT on pages 2-3 of this Guide.)

Please note that while the special fonts are not required to print or view
this text, optimum use of the capabilities encoded into the text does require the
variant letter forms.

                                                     Quick Reference Guide 4

     Definition             ENTITY Assignment    Decimal Equivalent

ENTITY thorn                      thorn                  211
ENTITY Thorn                      Thorn                  210
ENTITY that abbreviation          that                   227
ENTITY eth                        eth                    213
ENTITY Eth                        Eth                    212
ENTITY aesch                      aelig                  145
ENTITY tongued aesch              taelig                 167
ENTITY curved tongued aesch       caelig                 215
ENTITY high-e aesch               haelig                 168
ENTITY high-e tongued aesch       htaelig                169
ENTITY AEsch                      AElig                  146
ENTITY yogh                       yogh                   165
ENTITY a bar    (a macron)        abar                   230
ENTITY e bar    (e macron)        ebar                   170
ENTITY i bar    (i macron)        ibar                   155
ENTITY u bar    (u macron)        ubar                   224
ENTITY y bar    (y macron)        ybar                   209
ENTITY a circumflex               acirc                  131
ENTITY e circumflex               ecirc                  136
ENTITY i circumflex               icirc                  140
ENTITY u circumflex               ucirc                  150
ENTITY m-dash                     mdash                  171
ENTITY medial point               mpt                    225
ENTITY triple point               trpt                   208
ENTITY tironian and               and                    177
ENTITY Rustic A                   RusticA                172
ENTITY Bowed A                    BowA                   173
ENTITY Latin Capital A            LatA                   174
ENTITY Tongued e                  e-                     226
ENTITY Long-tongued e             e--                    228
ENTITY Curved Long-tongued e      em-                    216
ENTITY High-e                     E                      156
ENTITY Tongued high-e             E-                     157
ENTITY Low-s  Scribe 1            lows1                  158
ENTITY Low-s  Scribe 2            lows2                  159
ENTITY Long-s                     longs                  175
ENTITY a virgule                  avir                   220
ENTITY aesch virgule              aeligvir               223
ENTITY e virgule                  evir                   217
ENTITY i virgule                  ivir                   221
ENTITY o virgule                  ovir                   219
ENTITY u virgule                  uvir                   214
ENTITY Uncial E                   UncE                   229
ENTITY dotted-y                   ydot                   218
ENTITY Page eject                 pej                     12