
















                                                         ZEDIT Version 1.16




                                                                  June 1994


                                                         Clyde Thomas Zuber

                                                        2121 Woodrow Street
                                                           Durham, NC 27705
                                                                     U.S.A.







        ABSTRACT

        Zedit is a Latin/Greek/Hebrew editor providing diacritic overlays
        (i.e. accents, vowels, breathing marks).  Language scripts can be
        mixed, text entered in L->R or R->L modes.  ISPF/PDF-like
        interface.


        SPECIAL NOTICES

        Licensed Material - Program Property of Clyde Thomas Zuber.
        (c) Copyright 1987, 1994.  All Rights Reserved.













































                                                               Abstract  ii






        CONTENTS


          Conceptual Overview   . . . . . . . . . . . . . . . . . . . . . 1
          Getting Started   . . . . . . . . . . . . . . . . . . . . . . . 1
            Command Line Options  . . . . . . . . . . . . . . . . . . . . 1
            Scroll Keys   . . . . . . . . . . . . . . . . . . . . . . . . 1
          Description   . . . . . . . . . . . . . . . . . . . . . . . . . 1
          Graphic Video Modes   . . . . . . . . . . . . . . . . . . . . . 2
          Fonts   . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
          Internal Data Representation  . . . . . . . . . . . . . . . . . 3
          Entering a Data Set Name  . . . . . . . . . . . . . . . . . . . 4
            The Data Set Definition Panel   . . . . . . . . . . . . . . . 4
            Fast Path (/z=dsn) Invocation   . . . . . . . . . . . . . . . 4
          Screen Display Concepts   . . . . . . . . . . . . . . . . . . . 5
            Dual Screen Areas   . . . . . . . . . . . . . . . . . . . . . 5
            Message Line and Audible Alarm  . . . . . . . . . . . . . . . 5
            The Display "Window"  . . . . . . . . . . . . . . . . . . . . 5
          Data Entry  . . . . . . . . . . . . . . . . . . . . . . . . . . 6
            Getting Used to the Keyboard  . . . . . . . . . . . . . . . . 6
            Typing Terminal/Final Form Letters  . . . . . . . . . . . . . 7
            Typing Diacritical Marks  . . . . . . . . . . . . . . . . . . 7
            Typing Direction  . . . . . . . . . . . . . . . . . . . . . . 8

          Primary Commands  . . . . . . . . . . . . . . . . . . . . . . . 9
            Key to Notes Column   . . . . . . . . . . . . . . . . . . . . 9
          Table of Valid Primary Commands   . . . . . . . . . . . . . . . 9
          Primary Command Descriptions   . . . . . . . . . . . . . . . . 12
          Entering Commands or Abbreviations   . . . . . . . . . . . . . 17
          Entering Scroll Amounts  . . . . . . . . . . . . . . . . . . . 17
          Find/Change Parameters   . . . . . . . . . . . . . . . . . . . 18
          Numbered/Unnumbered Edit, Browse   . . . . . . . . . . . . . . 18
          Character Set Considerations   . . . . . . . . . . . . . . . . 19

          Control Keys   . . . . . . . . . . . . . . . . . . . . . . . . 20
          PFkey (Function Key) Settings  . . . . . . . . . . . . . . . . 20
          Other PC - PS/2 Keys   . . . . . . . . . . . . . . . . . . . . 21

          Line Commands  . . . . . . . . . . . . . . . . . . . . . . . . 24
          Line Command Set   . . . . . . . . . . . . . . . . . . . . . . 24
          Shifting and Language Tags   . . . . . . . . . . . . . . . . . 25

          Symbolic Correspondence  . . . . . . . . . . . . . . . . . . . 27
          Code Tables  . . . . . . . . . . . . . . . . . . . . . . . . . 27
          Keyboard Layouts   . . . . . . . . . . . . . . . . . . . . . . 32

          Optional Configuration   . . . . . . . . . . . . . . . . . . . 33
          Description  . . . . . . . . . . . . . . . . . . . . . . . . . 33
          Entering the Configuration Tables  . . . . . . . . . . . . . . 33

          Printing with Zedit  . . . . . . . . . . . . . . . . . . . . . 35
          Print Functions  . . . . . . . . . . . . . . . . . . . . . . . 35
          Download Font Options  . . . . . . . . . . . . . . . . . . . . 35
            Print Description  . . . . . . . . . . . . . . . . . . . . . 35
            PostScript Printers  . . . . . . . . . . . . . . . . . . . . 36


                                                              Contents  iii






            Dot Matrix Printers  . . . . . . . . . . . . . . . . . . . . 36
          Generic Graphic Print Option   . . . . . . . . . . . . . . . . 37
            Print Description  . . . . . . . . . . . . . . . . . . . . . 37

          Command Line Summary   . . . . . . . . . . . . . . . . . . . . 39
          Screen Display Functions   . . . . . . . . . . . . . . . . . . 39
          Miscellaneous Functions  . . . . . . . . . . . . . . . . . . . 39
          Printer Options  . . . . . . . . . . . . . . . . . . . . . . . 40
          Auxilary Options   . . . . . . . . . . . . . . . . . . . . . . 41
















































                                                               Contents  iv






        CONCEPTUAL OVERVIEW



        GETTING STARTED



        COMMAND LINE OPTIONS

        To obtain a complete list of command line options enter the
        command, ZEDIT1 for DOS, ZEDIT2 for OS/2 1.3, or ZEDIT3 for OS/2
        2.0, without any options, and a usage list will be displayed.

        Later you may want to create a DOS batch (.BAT) or OS/2 command
        (.CMD) file which selects the options for you.  Or if using OS/2
        1.3, they may be added to the program properties if you use a PM
        group to start the program.  For OS/2 2.x open the settings of a
        new program icon.  The program name and parameters may be entered
        on the program page of the notebook.

        The following is an example batch file:

        ZEDIT1 /i /z=%1 /n




        SCROLL KEYS

        If you are familiar with the PDF or XEDIT editors on the IBM MVS or
        VM operating systems, one thing that will be different is the need
        to use TAB to move between screen field areas.  For instance, the
        line number field and the text entry field are separate screen
        field areas.  In Zedit, one must use TAB or reverse-TAB to switch
        from either area to the other.  The RTAB primary command may also
        be set to a PFkey to perform the reverse-TAB.


        DESCRIPTION

        Zedit is a multiple script language editor.  It supports the normal
        ASCII character set in both a regular and special font set.  It has
        font definitions for Latin, Greek and Hebrew with diacritic
        capabilities.  And it allows multiple direction/multiple script
        text to coexist anywhere in the file.

        Zedit is an editor modeled after the IBM ISPF/PDF editor.   For
        this reason documentation for the PDF editor in either the MVS/TSO
        or the VM/CMS environment can also be referenced to learn how to
        use Zedit.  Zedit is like PDF but it is not identical.  This
        documentation emphasizes the unique differences.

        Some commands have been given aliases where the PDF editor function
        overlaps with functions from VM/CMS XEDIT and the two use different


                                                     Conceptual Overview  1






        names for the function.  An example is the PDF "cancel" and the
        XEDIT "quit".  Zedit will accept either.

        There are also many commands in Zedit which are unique to its
        application.  These must be learned from the included documentation
        and by experimenting with their use.


        GRAPHIC VIDEO MODES

        Zedit was first developed on the original IBM PC with a monochrome
        monitor and a Hercules type graphics card.  This mimicked the
        regular text mode of the monitor in that the graphics mode did not
        change the number of pixels on the screen, 720h X 348v.  This
        standard screen size is 80 characters across with 25 lines.  The
        character box is 8 X 14 pixels with an extra pixel between each box
        horizontally for extra legibility.  If you have this hardware,
        select the /h (Hercules) option.

        Note: The /h option will display random characters with random
        attributes if selected on a VGA screen.

        Support was later added for CGA graphics in its highest resolution
        of 640h X 200v.  There was no graphics mode for this monitor which
        was the same as its normal text display.  The character box for
        Zedit is still 8 X 14 so the screen size is 80 characters across
        with only 14 lines.  There is also no pixel between character
        boxes.  The CGA mode has a vertical elongation of the aspect ratio
        which makes the characters appear tall.  The total effect has the
        look of a "large print edition".  This is the /c (CGA) option.

        The next set of hardware to be supported was the IBM PS/2.   The
        display mode used is 640h X 350v.  This was developed using VGA
        equipment, but is actually an EGA resolution.  This standard
        graphics mode resembles the original monochrome graphics, but does
        not have the extra pixel between character boxes.  This mode is
        selected with the /e (EGA) option.

        The /m option and the /v option provide 640h X 480v pixels on MCGA
        and VGA displays respectively.  Zedit uses an 8 X 19 character box
        in these modes giving 80 characters across by 25 lines down.  Some
        may find that the extra blank space in the character box provides
        greater legibility.  This is especially the case for Latin
        diactritics if placed over capital letters (upper case).

        Knowing that the normal character display on the terminal is done
        with 720h X 350v pixels, I created a mode which programs the
        display registers directly.  This mode allows for the extra pixel
        between character boxes as the original Hercules mode does.  It is
        selected with the /i (IBM) option.  I called it the IBM option
        because it may not work with all VGA clone hardware.  For
        legibility, this mode is recommended if it will work with your
        hardware.  If you have a slow processor in your computer you may
        prefer /e for a faster display.



                                                     Conceptual Overview  2






        Corresponding to the /m and /v options there is also a /i+ option
        which provides 720h X 480v resolution.

        Note: Since Zedit updates the physical screen registers when using
        the /i and /i+ options, IOPL=YES must be coded in CONFIG.SYS for
        their use in OS/2 protect mode.  If IOPL=NO is coded then the /w
        option may also be required in any video mode which defaults to a
        display color.

        The most recent video mode addition, /x, provides 8514/XGA adapter
        support.  This mode has a resolution of 1025h X 768v with 25 lines
        of 80 characters.  This mode was created to provide additional
        space horizontally between characters.  For OS/2, a separate set of
        excutable modules, ZEDIT2X and ZEDIT3X, are needed which allow the
        use of this mode.  The display is controled by IBM software which
        is supplied with the display adapter.  Under DOS, this support is
        provided by a TSR program for the 8514 (HDILOAD.EXE) and a .SYS
        file which is added to the CONFIG.SYS file for XGA.  Under OS/2 a
        .DLL file is required for the /x enabled executables to run.

        There is also a text video mode, /t, which is non-graphic on all of
        the supported hardware.  The editor runs as normal, but output is
        only in the default hardware character set; diacritic codes are not
        displayed.


        FONTS

        The Greek and Hebrew font sets are both entirely original creations
        of mine.  Consideration was given to being able to fit all possible
        diacritic combinations in an overlay fashion on top of the
        consonant character set.

        The "regular" font set is similar to the pixel layout of an IBM
        3278 display terminal.  The "special" font set is the built in 8 X
        8 character set from your computer's ROM.  (When printing with the
        PostScript option, "special" will print as an italics version of
        "regular").  See "Character Set Considerations" on page 19 for more
        information.


        INTERNAL DATA REPRESENTATION

        The data file produced by Zedit contains only 7-bit ASCII codes.
        This makes conversion between ASCII and EBCDIC easier using normal
        code translate tables.  The only control character used is ASCII
        x'7F' which translates to EBCDIC x'07'.

        Note: In actual practice I have found that my original goal was too
        idealistic because code translation tables vary considerably from
        location to location if transported between multiple hosts.  When
        transferring Zedit files across an EBCDIC network, I recommend
        uploading and downloading in binary mode.




                                                     Conceptual Overview  3






        Since the codes are the ones used for normal code pages
        (independent of terminal type) the data may be inspected and
        manipulated using other editors.  Diacritic overlay codes follow
        their consonant code.  Diacritics must be allowed for when choosing
        a maximum logical record length for a data file.  In addition, a
        change in script usually requires two bytes.  It will require four
        if there is a mixture of Hebrew with any of the other scripts on
        the same line.  Finally, two bytes at the end of every line are
        required for a newline character and a null byte.


        ENTERING A DATA SET NAME



        THE DATA SET DEFINITION PANEL

        The data set name entry panel allows for a disk drive letter, three
        levels of path directories and an eight character name with a three
        character extension.  The main thing to note is that no punctuation
        is needed for any of these items as they are entered on different
        fields of the panel.  In other words, there is no need for a colon
        after the drive letter and no slashes with the path name and also
        no period in the file name.

        If your data set name does not fit within the above restrictions,
        or if you just prefer, there is a free form field for entering a
        data set name.  The name will be used exactly as entered, Zedit
        does not syntax check it; all system required punctuation must be
        present.  On OS/2 HPFS disks, long data set names may be used in
        OS/2 screen sessions.


        FAST PATH (/Z=DSN) INVOCATION

        As an alternative to menu panel invocation, an edit session may be
        started by specifying the data set name on the command line.  For
        example:

        zedit -i -z=discuss.dat


        would be the same as selecting option 2 on the primary menu and
        then entering "discuss" for the file name and "dat" as the
        extension.

        Note: The data set name when selected in this manner is not
        validity checked or verified for syntactical correctness.  On OS/2
        HPFS disks, long data set names may be used in OS/2 screen
        sessions.

        Another use of the /z= option is to select a data set for printing.
        If no display mode option is selected the editor prints the data
        set rather than creating an edit session.



                                                     Conceptual Overview  4






        SCREEN DISPLAY CONCEPTS



        DUAL SCREEN AREAS

        Zedit supports two logical screens for all graphic display modes.
        This allows the use of the SWAP or SPLIT commands in order to have
        two edit/browse sessions going at the same time.

        The /t option only uses one screen area.  It may also require the
        swap command to find the block cursor when using CGA hardware and
        ZEDIT1 under DOS.


        MESSAGE LINE AND AUDIBLE ALARM

        The Zedit message line on most displays is the bottom line of the
        screen, line 25.  In CGA mode (option /c) the top line of the
        screen also doubles as the message line.  (Sorry, this does not
        always work very well as some messages are written and then
        immediately reset).  Messages are displayed in reverse video and
        are of both informational and error/warning types.  Error/warning
        messages are prefixed by an exclamation point "!".  All messages
        which have the exclamation point are also accompanied by an audible
        alarm (beep).

        The audible alarm or beep is also used to indicate certain
        conditions under which Zedit exits to the system prompt in failure.
        In a failure situation, Zedit attempts to restore the screen
        display to text mode so that an error message can be displayed.
        Since under failure conditions there is no certainty as to whether
        the message will be displayed, the number of alarms sounded also
        indicates what the error was that caused Zedit to terminate.  One
        alarm is a general failure.  An example of this is when Zedit is
        invoked with no parameters.  Two alarms is an error opening an
        input file, three alarms is an error opening an output file, four
        alarms signifies a video failure, and five alarms occurs when Zedit
        is unable to obtain additional memory storage.


        THE DISPLAY "WINDOW"

        The screen area can be thought of as a window through which one can
        view only part of the page of a book.  By scrolling or moving the
        window to the left or right, up or down, one can see the other
        portions of the page.  This concept is common to all editors and
        actually common to most computer display use.  With Zedit the
        concept gets somewhat confusing because it supports text that is
        written right to left (Hebrew) as well as the more common left to
        right.

        The concept of left and right in relation to scrolling gets
        reversed for Hebrew.  The best way of keeping this straight is to
        mentally associate left with the beginning of the line and right


                                                     Conceptual Overview  5






        with the end.  Zedit provides synonyms of over (right) and back
        (left) to use instead, if you find them helpful.

        The reversal of left and right for Hebrew is specific to the data
        itself.  It is a by-product of Zedit allowing the two different
        directions to exist in the same data file and even in the same
        line.

        The keys that move the cursor, the arrow keys, will always move the
        cursor in the direction of the arrow.

        Note: If the beginning of a Hebrew line, for the entire screen
        width, is all Hebrew, Zedit will not allow any other script to be
        added to the line when scrolled over.

        The display window concept also affects the operation of insert
        mode versus overlay mode.  Overlay mode allows the changing of the
        data within the window scope by typing new data over the existing
        data (if there is any).  Insert mode moves the existing data out of
        the way of the new data.  It does this by moving the existing data
        "to the right" (or over).  The main thing to remember in this
        regard is that no existing data outside of the scope of the window
        will ever be changed.  It does not matter whether the keyboard is
        in insert or overlay mode.

        In insert mode, if a character must be moved from the rightmost
        column (or leftmost for Hebrew) the keyboard will lock to prevent
        data loss.


        DATA ENTRY



        GETTING USED TO THE KEYBOARD

        Zedit was developed in a complete vacuum as far as conventions or
        standards relating to keyboard layout.  The decisions made for
        location of key assignments were made to try to provide the most
        logical connection between my knowledge of the English alphabet,
        the U.S.  keyboard layout and classical Greek and Hebrew.
        Sometimes the correlation is as weak as the shape of one letter
        being suggestive of the other.  Sometimes it was because it was an
        available key.  Often I sought to maintain the alphabetic order
        correspondence or the type of sound of the two letters was the
        same.

        One of the more obscure associations I made was the capital V with
        the Greek iota-subscript.  I think of the V as a big arrow head
        down to the subscript below the line.

        I especially tried to keep the Hebrew vowels with their closest
        English vowel equivalent.  This meant moving Alef to the single
        quote key location.  The single quote was chosen because a smooth
        breathing mark is sometimes used to transliterate Alef.


                                                     Conceptual Overview  6






        The other main consideration was to keep as much on the lower case
        keys and the easier to reach keys as possible.


        TYPING TERMINAL/FINAL FORM LETTERS

        Greek has a terminal sigma and Hebrew has many terminal forms.
        These forms are entered by typing a totally different key for the
        Greek sigma (v), and by using the shift (capital) key for Hebrew.
        As a convenience, if you first type the normal form of the letter
        followed by the terminal form, the terminal form will automatically
        replace the normal form.  Thus, the key sequence, sv, will have the
        same result as just v.  In Hebrew, the terminal form must be typed
        before any diacritics for the replacement to be done.  Zedit will
        issue a warning if you type any consonant instead of a space or
        punctuation following a terminal form.  It will also warn you if
        you end a word with the non-terminal form of a letter that has one.


        TYPING DIACRITICAL MARKS

        Diacritical marks are keyed in after the letter on which they will
        be placed.  Thus the cursor must be in the position following the
        letter which will be marked.  If the diacritic placement is correct
        then the cursor will not advance until a non-diacritic character is
        typed.  If the diacritic does not properly go on the letter the
        cursor is positioned after, then the diacritic will be placed in
        the position occupied by the cursor itself, overlaying a blank
        character instead, and the cursor will advance to the next
        position.

        If you first type a diacritical mark and need to change it, typing
        the correct mark will often replace just the diacritic in error, if
        the two are mutually exclusive.  If the two are not mutually
        exclusive, then the backspace key must be used to start over.

        To place diacritics on a Greek capital, type the diacritics
        preceding the Greek capital as is done in printed Greek texts.  For
        capitals in the Latin script, the diacritic is typed just as for
        the lower case forms.  In all the video modes except /v and /i+ the
        diacritic may merge with the character due to its size.

        The regular and special character sets can have the underline
        character overlaid on them in the same manner as the diacritics for
        Greek and Hebrew.  The ctrl key in combination with the
        underline/dash key is used to enter the overlay.  The underline is
        unique and different from the diacritics in that it will repeat if
        held down through a line of text.









                                                     Conceptual Overview  7






        TYPING DIRECTION

        The text entry direction is totally independent of the script type.
        The commands for changing language scripts are also independent
        from the command to change direction.  If you are in overlay mode
        you can type in the reverse direction and end up with the
        characters in reverse order.

        A feature of insert mode is called "reverse insert".  When the
        typing direction is the opposite of normal for the selected script
        type (e.g. right to left for English, left to right for Hebrew),
        the cursor will remain stationary with the insert pushing the text
        into the line without disrupting any text of that normally flows in
        that direction.  This is especially convenient when typing a text
        line that contains multiple script directions.

        Note: The command line at the top of the screen is always parsed
        from left to right.  This also is independent of the direction of
        text entry.






































                                                     Conceptual Overview  8






        PRIMARY COMMANDS

        The following table is an exhaustive list of commands recognized by
        Zedit.  Most are available by PFkey or by menu option.  Several are
        aliases of other commands for the benefit of those users who are
        already familiar with the similarly functioned command name.


        KEY TO NOTES COLUMN

          +  indicates command is also defined to a PFkey.

          *  indicates command is also a primary menu option.


        TABLE OF VALID PRIMARY COMMANDS

        Ŀ
            Notes   COMMAND                      ALIAS                   
                                                                       
        Ĵ
                    back                         left                    
                                                                       
        Ĵ
                    bottom                       down max                
                                                                       
        Ĵ
                *   browse                       1                       
                                                                       
        Ĵ
                +   cancel                       quit                    
                                                                       
        Ĵ
                +   change                                               
                                                                       
        Ĵ
                    columns                                              
                                                                       
        Ĵ
                *   config                       0                       
                                                                       
        Ĵ
                    copy                         get                     
                                                                       
        Ĵ
                    create                       replace                 
                                                                       
        Ĵ
                +   cursor                                               
                                                                       
        Ĵ
                    delete                                               
                                                                       
        Ĵ
                +   down                                                 
                                                                       
        Ĵ
                *   edit                         2                       
                                                                       
        Ĵ
                +   end                          file                    
                                                                       
        Ĵ
                +   eraseeof                                             
                                                                       
        Ĵ
              * +   exitsys                      x                       
                                                                       
        





                                                        Primary Commands  9






        Ŀ
            Notes   COMMAND                      ALIAS                   
                                                                       
        Ĵ
                *   expgrk                       53                      
                                                                       
        Ĵ
                *   expheb                       54                      
                                                                       
        Ĵ
                *   exphhi                       56                      
                                                                       
        Ĵ
                    file                         end                     
                                                                       
        Ĵ
                +   find                                                 
                                                                       
        Ĵ
                    get                          copy                    
                                                                       
        Ĵ
                +   greek                                                
                                                                       
        Ĵ
                +   hebrew                                               
                                                                       
        Ĵ
                +   help                                                 
                                                                       
        Ĵ
                *   impgrk                       51                      
                                                                       
        Ĵ
                *   impheb                       52                      
                                                                       
        Ĵ
                    keys                                                 
                                                                       
        Ĵ
                    latin                                                
                                                                       
        Ĵ
                +   left                         back                    
                                                                       
        Ĵ
                    list                         locate                  
                                                                       
        Ĵ
                    letters                                              
                                                                       
        Ĵ
                    locate                       list                    
                                                                       
        Ĵ
                    over                         right                   
                                                                       
        Ĵ
                +   print                                                
                                                                       
        Ĵ
                    put                          replace                 
                                                                       
        Ĵ
                    quit                         cancel                  
                                                                       
        Ĵ
                +   refresh                                              
                                                                       
        Ĵ
                +   regular                                              
                                                                       
        Ĵ
                    replace                      create                  
                                                                       
        






                                                       Primary Commands  10






        Ŀ
            Notes   COMMAND                      ALIAS                   
                                                                       
        Ĵ
                +   reset                                                
                                                                       
        Ĵ
                +   return                       =                       
                                                                       
        Ĵ
                +   reverse                                              
                                                                       
        Ĵ
                +   right                        over                    
                                                                       
        Ĵ
                    rtab                                                 
                                                                       
        Ĵ
                +   save                                                 
                                                                       
        Ĵ
                +   special                                              
                                                                       
        Ĵ
                    split                        swap                    
                                                                       
        Ĵ
                +   swap                         split                   
                                                                       
        Ĵ
                *   system                       exitsys                 
                                                                       
        Ĵ
                    top                          up max                  
                                                                       
        Ĵ
                +   up                                                   
                                                                       
        Ĵ
                *   x                            exitsys                 
                                                                       
        Ĵ
                *   0                            config                  
                                                                       
        Ĵ
                *   1                            browse                  
                                                                       
        Ĵ
                *   2                            edit                    
                                                                       
        Ĵ
                *   51                           impgrk                  
                                                                       
        Ĵ
                *   52                           impheb                  
                                                                       
        Ĵ
                *   53                           expgrk                  
                                                                       
        Ĵ
                *   54                           expheb                  
                                                                       
        Ĵ
                *   56                           exphhi                  
                                                                       
        Ĵ
                    =                            return                  
                                                                       
        










                                                       Primary Commands  11






        PRIMARY COMMAND DESCRIPTIONS

        Command   DESCRIPTION

        back      This is an alias for LEFT.  This might be more acceptable
                  when entering Hebrew in right to left mode.

        bottom    This is an alternative to entering "DOWN MAX".  XEDIT
                  compatible.

        browse    Displays preexisting data file only.

        cancel    Ignore all changes since last SAVE and or since beginning
                  of edit session if SAVE has not been entered.

        change    Syntax is "CHANGE parm1 parm2".  A search is done for
                  parm1 and if found, parm2 is substituted in its place.
                  See "Find/Change Parameters" on page 18 for more
                  information.

        columns   This command is valid within an edit or browse session.
                  It adds a line to the display that numbers the column
                  positions across the data area.  The line is added as the
                  first line on the display area.  If the data that
                  occupies the first line of the display when the command
                  is entered is Hebrew text, the column positions will be
                  displayed right to left.  The same display can also be
                  obtained by the COLS line command.

        config    Use this option to specify a Zedit customization
                  configuration.  See the section titled "Optional
                  Configuration" on page 33 for more information.

        copy      Gets a copy of a file from another data set other than
                  the one currently being edited and adds it to the one
                  currently being edited.  The position where to add the
                  lines that are copied may be marked using an A or B line
                  command.  If a line is not marked, the lines are added
                  after the first line of the current screen display.

        create    Basically does a SAVE into another data file.  If the
                  file already exists it will replace it, thus its alias is
                  REPLACE.  Syntax is "CREATE dsn".  No validity checking
                  is done on "dsn" to see if it matches operating system
                  requirements.  This command is different from ISPF/PDF in
                  that lines are not selectable, the entire in storage edit
                  file is used.

        cursor    This command only makes sense on its PFkey.  Performs a
                  "home" of putting the cursor on the command line.

        delete    The minimum abreviation for this command is "DEL".  It
                  requires a parameter of either "X" or "NX".  An optional
                  parameter of "ALL" is allowed.  An example of the full
                  syntax is "DEL ALL X".  This would result in all excluded


                                                       Primary Commands  12






                  lines being deleted.  "DEL NX" would result in all
                  non-excluded lines being deleted.

        down      Scroll the data display forward or down.  See "Entering
                  Scroll Amounts" on page 17 for more information.

        edit      Edit a new or existing data set.  If data set does not
                  exist, it will automatically be created.

        end       Deselect the current display panel.  If in an edit
                  session, it will also save the data set.  The next panel
                  displayed is the one which was immediately displayed
                  before the current one.

        eraseeof  Erase the line from the current cursor position to the
                  end of the screen field.

        exitsys   Similar in function to END and RETURN but exits Zedit
                  completely, returning to the operating system.

        expgrk    This option takes a Zedit file as input and does an
                  "export" by striping out its diacritics.  In addition,
                  the Zedit codes used to represent the consonants are
                  exchanged according to whatever is defined in the Greek
                  keyboard customization table.  The only reason to want to
                  do this is for processing with some other editor or
                  printing convention.  See the section titled "Optional
                  Configuration" on page 33 for more information.

                  The result (output) file of this function will have the
                  same name as the input file with the three letter
                  extension changed to EXP.

        expheb    This option takes a Zedit file as input and does an
                  "export" by striping out its diacritics.  In addition,
                  the Zedit codes used to represent the consonants are
                  exchanged according to whatever is defined in the Hebrew
                  keyboard customization table.  The only reason to want to
                  do this is for processing with some other editor or
                  printing convention.  See the section titled "Optional
                  Configuration" on page 33 for more information.

                  The result (output) file of this function will have the
                  same name as the input file with the three letter
                  extension changed to EXP.

        exphhi    This option is similar to EXPHEB above.  The output data
                  file consonants are in the IBM standard Hebrew character
                  codes rather than according to the Hebrew keyboard
                  customization table.  The standard Hebrew character codes
                  are in the high ASCII range (i.e. greater than x'7F') and
                  this export is not customizable within Zedit.  See the
                  section titled "Optional Configuration" on page 33 for
                  more information.



                                                       Primary Commands  13






                  The result (output) file of this function will have the
                  same name as the input file with the three letter
                  extension changed to HEB.

        file      This is an alias for END.  XEDIT compatible.

        find      Syntax is "FIND parm1".  A search is done for parm1.  See
                  "Find/Change Parameters" on page 18 for more information.

        get       This is an alias for COPY.  XEDIT compatible.

        greek     Select entering text in Greek characters.

        hebrew    Select entering text in Hebrew characters.

        help      (currently non-functional).

        impgrk    This option takes a file created by some other editor as
                  input and does an "import" by adding a Zedit Greek
                  control sequence to the beginning of the file.  In
                  addition the Zedit codes used to represent the consonants
                  are exchanged according to whatever is defined in the
                  Greek keyboard customization table.  See the section
                  titled "Optional Configuration" on page 33 for more
                  information.

                  The result (output) file of this function will have the
                  same name as the input file with the three letter
                  extension changed to ZED.

        impheb    This option takes a file created by some other editor as
                  input and does an "import" by adding a Zedit Hebrew
                  control sequence to the beginning of the file.  The
                  standard high (ASCII 128-256) code point values for the
                  Hebrew consonants are automatically mapped to the Zedit
                  internal values.  If the input is in the low range then
                  the consonants are exchanged according to whatever is
                  defined in the Hebrew keyboard customization table.  See
                  the section titled "Optional Configuration" on page 33
                  for more information on low range processing.

                  The result (output) file of this function will have the
                  same name as the input file with the three letter
                  extension changed to ZED.

        keys      This command is valid within an edit or browse session.
                  It adds a line to the display that shows the primary,
                  unshifted PFkey function values.  The line is added as
                  the first line on the display area.  The same display may
                  be obtained using the KEYS line command.

        latin     Select entering text in Latin characters.

        left      Scroll the screen data display area to the left or rather
                  to the beginning of the line.  For lines that have been


                                                       Primary Commands  14






                  stored in the reverse direction, the impression will be
                  of scrolling right.  For this reason, the alias of BACK
                  may be used to maintain intuitive perspective.

        letters   This command is valid within an edit or browse session.
                  It adds lines to the display that show the alphabetic
                  correspondence between the regular, Greek, and Hebrew
                  scripts.  The lines are added at the top of the display
                  area.  The same display may also be obtained by the LETS
                  line command.

        list      This is an alias for LOCATE.

        locate    Syntax is "LOCATE linenum".  The display will be scrolled
                  to have the line with the count of linenum at the top of
                  the screen.  Note that this is in no way related to the
                  XEDIT locate command.  For that function, use FIND.

        over      This is an alias for RIGHT.  This might be more
                  acceptable when entering Hebrew in right to left mode.

        print     Prints the entire data set being browsed or edited.  This
                  is different from ISPF/PDF.  To only print a screen image
                  as the PDF command does, see "print screen" under "Other
                  PC - PS/2 Keys" on page 21.  See "Printing with Zedit" on
                  page 35 for more information on printing the entire data
                  set.

        put       This is an alias for REPLACE.  XEDIT compatible.

        quit      This is an alias for CANCEL.  XEDIT compatible.

        refresh   This is a "panic mode help key".  Because Zedit changes
                  the video display registers in some operating
                  environments this function key was created to refresh the
                  video mode.  Use this key if the display becomes garbage.
                  It should only be needed with the Hercules graphics mode,
                  but it will function, if needed, in any mode.

        regular   Select entering text with REGULAR characters.  This is
                  specifically opposed to SPECIAL characters.  See
                  "Character Set Considerations" on page 19 for more
                  information.

        replace   This is an alias for CREATE.

        reset     Will cancel any pending line commands and/or erase the
                  message display line area (line 25 or in CGA, line 1).

        return    Functions like END except that the primary option menu is
                  displayed next.

        reverse   Change the directional orientation of text entry.  This
                  operates as a toggle between left to right and right to
                  left.


                                                       Primary Commands  15






        right     Scroll the screen data display area to the right or
                  rather away from the beginning of the line.  For lines
                  that have been stored in the reverse direction, the
                  impression will be of scrolling left.  For this reason
                  the alias of OVER may be used to maintain intuitive
                  perspective.

        rtab      Performs the reverse tab key combination (or tab-left).
                  Its intended use is as the value of a PFkey as performing
                  the reverse tab is awkward on many keyboards.

        save      Write the data set to disk.

        special   Select entering text with SPECIAL characters.  This is
                  specifically opposed to REGULAR characters.  See
                  "Character Set Considerations" on page 19 for more
                  information.

        split     This is an alias of SWAP.

        swap      Display the other screen area.

        system    This is an alias of EXITSYS.

        top       This is equivalent to entering "UP MAX".  It is XEDIT
                  compatible.

        up        Scroll the data display backward or up.  (Note that
                  "BACK" is NOT an alias for this command).  See "Entering
                  Scroll Amounts" on page 17 for more information.

        X         EXITSYS option on primary option menu.

        0         CONFIG option on primary option menu.

        1         BROWSE option on primary option menu.

        2         EDIT option on primary option menu.

        51        IMPGRK option on primary option menu.

        52        IMPHEB option on primary option menu.

        53        EXPGRK option on primary option menu.

        54        EXPHEB option on primary option menu.

        56        EXPHHI option on primary option menu.

        =         This is an alias for RETURN.  Its use, however, is as a
                  fast path key to another option.  Thus "=2" says return
                  to primary option menu and select option 2.





                                                       Primary Commands  16






        ENTERING COMMANDS OR ABBREVIATIONS

        All commands may be abbreviated up to the point where they are
        still unique, except as noted below.  In other words, it depends on
        what other commands start with the same letter, or letters, and on
        how much of the command must be typed.

        Note: FIND and CHANGE can always be abbreviated by one letter, "f"
        and "c", respectively, regardless of other commands that begin with
        the same letters.

        Note: The minimum abreviation for DELETE is "del".

        Commands should be entered in regular script.  The parameters may
        be in the other scripts for FIND or CHANGE.


        ENTERING SCROLL AMOUNTS

        Scroll amounts can be entered on the command line following the UP,
        DOWN, LEFT, or RIGHT commands.  They can also be entered alone when
        the command is entered via PFkey.  If no amount is entered on the
        command line the value in the SCROLL ===> field is used.  This
        value may also be changed and will remain in effect for the length
        of the edit or browse session.

        The values which may be specified are as follows:

        Value     DESCRIPTION

        a number  A decimal number or count may be used.

        data      Indicates to scroll the entire screen size less one.  For
                  instance, the bottom line of the screen would become the
                  top line of the next display for a DOWN command.

        half      Scroll half the number of lines for the display.

        max       Scroll to the outermost range.

        page      Scroll the entire screen size.

        csr       Scroll to the location the cursor occupies when the
                  command is entered.



        FIND/CHANGE PARAMETERS

        1. Parameters are delimited by blanks unless a parameter is
           enclosed within quotes.  Either single or double quotes may be
           used if a parameter is to contain either blanks or the other
           type of quote.

        2. Only forward search is supported at this time. Thus, the PDF


                                                       Primary Commands  17






           parameters ALL, NEXT, PREV, FIRST, are not supported.

        3. The search starts from the first line on the display through to
           the bottom of the data file.  If the FIND command is entered
           again after receiving the bottom of data message, the search
           will begin again from the top of the data file.

        4. If the parameter to be searched for contains diacritics, only
           exact matches including diacritics will be found.  If the
           parameter does not contain diacritics, all strings with any
           possible diacritics will be found.

           In this context, terminal letters are treated the same as
           diacritics.  To do the fuzzier search, without diacritics, the
           terminal letter may be entered in its regular form (not the
           terminal form).

        5. The search parameter is case sensitive.

        6. Strings which span lines will not be matched.

        7. The parameters on the command line are always parsed left to
           right.

        8. The parameters may be in any script but a change from one script
           to another is not supported.

        9. Be careful of confusing Latin with the regular ASCII script as
           they display similarly on the screen.



        NUMBERED/UNNUMBERED EDIT, BROWSE

        The numbered edit mode is 72 characters wide by default.  The
        unnumbered browse mode is 80 characters.

        Other screen widths up to the default, which is the maximum, can be
        selected with the /b option when used in combination with the /r=
        option.  The /r= option sets the right margin for working with
        interlinear text.  Matching different directional lines requires
        the window line size to be a constant.  Since Hebrew is the only
        script Zedit supports which goes right to left, this is only a
        consideration if the data will include Hebrew text.

        More importantly, the line size is also an issue for printing
        multi-directional type data.  For this reason, the /r= option is
        provided for specifying a right margin for Hebrew.  In pratice,
        relative displacements of multi-directional text lines will be the
        same if a multiple of the original display window is chosen for the
        right margin value.

        Note: The default value is /r=72.




                                                       Primary Commands  18






        Zedit has a bias toward left to right text in that when a line has
        more than one direction for its scripts, it stores it in the left
        to right direction.  So even if a line is mostly Hebrew, if it has
        any other type of text script, it will be stored in the left to
        right direction.  This also will create multi-directional type data
        with the convergence considerations mentioned above.

        When using the PPDS graphic print modes, /g, /g+, or /gx, with /2
        to switch from dual density to single density printing, the /r=
        option has the additional use of shortening the print line so that
        it can be fit to the width of the paper.  /gx needs this capability
        with or without the /2 option because of the greater size of the
        printed characters.  See "Generic Graphic Print Option" on page 37
        for more information on the PPDS graphic print modes.


        CHARACTER SET CONSIDERATIONS

        Under most circumstances, use regular as opposed to the special
        character set.  Special has been provided to tag text for special
        consideration during printing or other processing.  For instance,
        with dot matrix printers (default, /p, /n) the print command prints
        the special character set from the resident font within the
        printer.  It therefore is not the same height as the other fonts
        when printed.  On the other hand, when printing with a PostScript
        printer (/s), the special character set is printed as an italic
        version of regular.  And finally, with the PPDS graphic print modes
        (/g, /g+, /gx) the special characters are always printed just as
        they appear on the display screen.  See "Generic Graphic Print
        Option" on page 37 for more information on the PPDS graphic print
        modes.


























                                                       Primary Commands  19






        CONTROL KEYS



        PFKEY (FUNCTION KEY) SETTINGS

        Ŀ
                     <NONE>          SHIFT         CTRL           ALT    
                                                                     
        Ĵ
           PF1       refresh         help          help          help    
                                                                     
        Ĵ
           PF2        swap           swap          swap          swap    
                                                                     
        Ĵ
           PF3         end            end        eraseeof         end    
                                                                     
        Ĵ
           PF4       exitsys         print        return        return   
                                                                     
        Ĵ
           PF5       regular         find          find         regular  
                                                                     
        Ĵ
           PF6        greek         change        change         greek   
                                                                     
        Ĵ
           PF7       hebrew           up           reset        hebrew   
                                                                     
        Ĵ
           PF8       reverse         down         cancel        reverse  
                                                                     
        Ĵ
           PF9        latin          swap          left          latin   
                                                                     
        Ĵ
          PF10        left           left          right        special  
                                                                     
        Ĵ
                                                                         
                                                                     
        Ĵ
          PF11        right          right         save          left    
                                                                     
        Ĵ
          PF12       special        cursor        exitsys        right   
                                                                     
        

        1. The SHIFT PFkeys are set to the default ISPF/PDF settings.

        2. The function key for find and change operate slightly
           differently than their PDF counterpart.  There is no distinction
           of command for the repeat function (e.g. RFIND). In addition,
           when the find or change parameters are initially entered, the
           command "f" or "c" may be entered on the command line or the
           pfkey selected, but not both.  (PDF requires both if the
           function key is used).

        3. PF11 and PF12 are available under DOS only with the use of the
           /k command line option when using an enhanced keyboard.









                                                           Control Keys  20






        OTHER PC - PS/2 KEYS

        Key       DESCRIPTION

        alt       The ALT state keys are used in combination with the
                  PFkeys keys.

        backspace The backspace key moves the cursor one character position
                  to the left, removing the character that was in that
                  position.  All of the characters following the cursor on
                  the line (in the screen field) move with the cursor.
                  Sometimes this action is referred to as "destructive
                  backspace".  Compare with DELETE.

        ctrl      The control key may be used in combination with other
                  keys, such as the PFkeys, the scroll keys, PgUp and
                  PgDown, and the DELETE and END, keys.

        delete    The character in the box marked by the cursor is removed.
                  All of the characters following the cursor on the line
                  (in the screen field) move toward the cursor.  Compare
                  with BACKSPACE.  This key in combination with the CTRL
                  key is the same function as the ERASEEOF primary command
                  or PFkey.

        end       When this key is pressed, the cursor moves to the end of
                  the current screen field.  This key in combination with
                  the CTRL key is the same function as the ERASEEOF primary
                  command or PFkey.

        enter     The regular ENTER key is a combination of "newline" and
                  "enter".  Newline means that normally it will simply move
                  the cursor down the screen to the beginning of the next
                  entry field.  "Enter" means it signals a command event
                  for Zedit to start processing a command that has been
                  entered.  The only time it functions as "enter" is when
                  it is pressed and the cursor is on the primary command
                  line, or when a line command has been typed in the prefix
                  area.

                  In order to signal "enter" to process a panel such as the
                  data set entry panel, ENTER should be used in combination
                  with the CTRL key.  If you wanted to process a command
                  from the command line on such a panel without processing
                  the panel itself, the cursor should be on the primary
                  command line and the key used without the CTRL key.

                  Another way to signal CTRL-Enter is to use the ENTER key
                  on the numeric keypad of the PS/2 enhanced keyboard.  It
                  always has the "enter" function.  If for some reason you
                  prefer not to use CTRL-Enter or the keypad ENTER, CTRL-J
                  is another method.

        escape    This key performs the same function as the "end" primary
                  command which is assigned to PF3 by default.  It


                                                           Control Keys  21






                  deselects the current display panel.  If in an edit
                  session, it will also save the data set.  The next panel
                  displayed is the one which was immediately displayed
                  before the current one.

        home      Moves the cursor to the beginning position of the command
                  field at the top of the screen.  This is the same
                  function as the CURSOR primary command.

        insert    Toggles the data entry state for the screen field area
                  between overlay and insert.  Overlay replaces characters
                  in the position where the cursor is.  Insert moves the
                  character and all following characters one position away
                  to make room for the freshly typed character.

                  Insert state is remembered independently of the command
                  line sate in OS/2 protect mode sessions.  In other words,
                  the initial state, INS or OVR, may appear to be arbitrary
                  when starting Zedit.

        page down The action is the same as entering the DOWN primary
                  command.  Performs similarly to the command when entered
                  via PFkey.  This key in combination with the CTRL key is
                  the same function as DOWN with MAX as a parameter (or the
                  BOTTOM alias).

        page up   The action is the same as entering the UP primary
                  command.  Performs similarly to the command when entered
                  via PFkey.  This key in combination with the CTRL key is
                  the same function as UP with MAX as a parameter (or the
                  TOP alias).

        print screen (and *) The native operating system provides some
                  graphic display support.  This does not include
                  nonstandard modes.  Zedit includes code to print a screen
                  image direct from the the video buffer in whatever mode
                  it was invoked with.

                  On the PC (10 function key) keyboard it is selected by
                  pressing the shift key while pressing the print screen
                  key.  This key has an "*" character in the shift
                  position.  The corresponding key on the PS/2 enhanced
                  keyboard is the "*" key on the right numeric keypad.  No
                  shift is necessary on the enhanced keyboard.

                  Note: Hercules mode (/h) print screen support is
                  available only for Epson printers.

                  Note: Print screen to PostScript printers (/s) is not
                  supported.

        return    See ENTER above.

        scroll    Also called arrow keys.  These four keys move the cursor
                  one character position at a time around the screen field


                                                           Control Keys  22






                  areas.  If you are familiar with the PDF or XEDIT editors
                  on MVS or VM, one thing that will be different is the
                  need to use TAB to move between screen field areas.  For
                  instance, the line number field and the text entry field
                  are separate screen field areas.  In Zedit, one must use
                  TAB or reverse-TAB to switch from either area to the
                  other.  The RTAB primary command may also be set to a
                  PFkey to perform the reverse-TAB.

                  CTRL in combination with a SCROLL key will make the
                  cursor move twice as fast.  On most keyboards, care must
                  be given to press the CTRL key prior to the SCROLL arrow,
                  otherwise the opposite will happen.

        shift     The shift state keys are used in combination with other
                  keys, such as the PFkeys.  The most common use, of
                  course, is to select capital letters.

        tab       On most keyboards, there is one TAB key which, when
                  pressed, performs a TAB to the right.  The SHIFT key in
                  combination with the TAB key performs a reverse-TAB to
                  the left.  CTRL-U will also perform a reverse-TAB, as
                  well as the RTAB primary command when assigned to a
                  PFkey.

                  The TAB function moves the cursor from one screen field
                  area to the next/right or previous/left.  The line will
                  move to the next or previous line if the cursor is at the
                  "end of the screen".

                  The TAB key or keys do not place any data within your
                  file as some editors do.  Zedit does not support the
                  changing of "tabs" created by such editors.

                  Note: TAB must be used to move between the line number
                  prefix area and the text area in zedit numbered mode.





















                                                           Control Keys  23






        LINE COMMANDS



        LINE COMMAND SET

        The line commands may be entered in upper or lower case.  They are
        shown here in upper case to help distinguish the actual command
        from the (n) variable which is an optional count parameter.  The
        default for n is 1 in all cases.

        Note: The # is used as a place marker by Zedit to indicate a
        partially processed command.  An example of this would be when a C
        (copy) has been entered on a line and the return key has been
        entered.  A # will appear on the line number field until the A, B
        is entered on another line number.  The RESET primary command will
        clear outstanding (#) line commands if, for instance, the command
        was entered accidentally.

        Command   DESCRIPTION

        "n        alias for the R, XEDIT compatible

        ""n       alias for the RR, XEDIT compatible

        (n        shift left n positions

        ((n       block shift left n positions

        )n        shift right n positions

        ))n       block shift right n positions

        A         After, used with copy and move

        B         Before, used with copy and move

        Cn        Copy n lines

        CC        Copy block of lines

        COLS      essentially the same as the COLUMNS primary command, with
                  the column marker placed above the selected line rather
                  than as the first line of the display

        Dn        Delete

        DD        Delete block of lines

        Fn        show (re-display) First n lines of an excluded block

        GR        GReek

        HE        HEbrew



                                                          Line Commands  24






        In        Insert or add n lines

        KEYS      essentially the same as the KEYS primary command, with
                  the PFkey display line placed above the selected line
                  rather than as the first line of the display

        Ln        show (re-display) Last n lines of an excluded block

        LA        LAtin

        LETS      essentially the same as the LETTERS primary command, with
                  the alphabet lines placed above the selected line rather
                  than as the first line of the display

        Mn        Move n lines

        MM        Move block of lines

        On        On, used with copy and move

        OO        block On, used with copy and move

        RE        REgular

        Rn        Repeat line n times

        RRn       Repeat block of lines n times

        Sn        Show (re-display) first n lines of an excluded block

        SP        SPecial

        TE        Zedit does not support the Text Entry line command.

        TF        (currently non-functional) Text Flow

        TS        (currently non-functional) Text Split

        Xn        eXclude n lines from being displayed

        XX        eXclude a block of lines from being displayed



        SHIFTING AND LANGUAGE TAGS

        As is the case with PDF, data that is shifted toward the beginning
        of the line (left) or over the end of the maximum logical record
        length (right) is lost.

        Since Zedit has embedded tags to indicate the language of the text
        it is possible to change the script of text by the use of the shift
        line commands, (, ((, ), and )).  Zedit attempts to minimize the
        exposure of this happening by preventing tags from being lost where
        they normally occur.  The exposure is mainly in single lines that


                                                          Line Commands  25






        contain multiple scripts.  This type of manipulation of text data
        is expected to be unusual but Zedit provides line commands to allow
        the correction of internal tags in this event:

          GR - changes the starting script type of the line to Greek.

          HE - changes the starting script type of the line to Hebrew.

          LA - changes the starting script type of the line to Latin.

          RE - changes the starting script type of the line to Regular.

          SP - changes the starting script type of the line to Special.

        Note: These commands can NOT be used to change a line that already
        begins with an embedded tag.  They are provided only for corrective
        use.  If a block of text needs to be changed back to a particular
        text type, start with the last line affected, enter the command,
        and repeat the command on each line up to the first affected line.






































                                                          Line Commands  26






        SYMBOLIC CORRESPONDENCE



        CODE TABLES

        1. ASCII is used for both Regular and Special.

        2. Only the hex codes which appear from Zedit output are listed.

        3. DEL, x'7F', and the character following it in the file indicates
           the Zedit character set or direction.

        4. A reserved or unused code is indicated by <*> (Hebrew only).

           Note: Hebrew code point names enclosed in angle brackets (e.g.
           <segolta>) are proposed assignments for Hebrew accent support in
           the next release.

        Ŀ
          hex    ASCII    Greek              Hebrew          Latin        
                                                                     
        Ĵ
          20    space    space              space           space        
                                                                     
        Ĵ
          21      !      !                  !               !            
                                                                     
        Ĵ
          22      "      grave accent       "               "            
                                                                     
        Ĵ
          23      #      #                  # <salselet>    breve/ caron 
                                                                     
        Ĵ
          24      $      $                  $ <darga>       cedilla/     
                                                                     
                                                            ogonek/      
                                                                     
                                                            double acute 
                                                                     
        Ĵ
          25      %      %                  % <pazer        overdot/     
                                                                     
                                            magnum>         overcircle/  
                                                                     
                                                            middle dot   
                                                                     
        Ĵ
          26      &      &                  &               eth          
                                                                     
                                            <pasta/azla>                 
                                                                     
        Ĵ
          27      '      acute accent       alef            acute accent 
                                                                     
        Ĵ
          28      (      (                  (               (            
                                                                     
        Ĵ
          29      )      )                  )               )            
                                                                     
        Ĵ
          2A      *      *                  *               *            
                                                                     
        Ĵ
          2B      +      +                  + <pazer>       +            
                                                                     
        






                                                Symbolic Correspondence  27






        Ŀ
          hex    ASCII    Greek              Hebrew          Latin        
                                                                     
        Ĵ
          2C      ,      ,                  ,               ,            
                                                                     
        Ĵ
          2D      -      -                  maqqaf          -            
                                                                     
        Ĵ
          2E      .      .                  .               .            
                                                                     
        Ĵ
          2F      /      /                  /               stroke       
                                                                     
        Ĵ
          30      0      0                  0               0            
                                                                     
        Ĵ
          31      1      1                  1               1            
                                                                     
        Ĵ
          32      2      2                  2               2            
                                                                     
        Ĵ
          33      3      3                  3               3            
                                                                     
        Ĵ
          34      4      4                  4               4            
                                                                     
        Ĵ
          35      5      5                  5               5            
                                                                     
        Ĵ
          36      6      6                  6               6            
                                                                     
        Ĵ
          37      7      7                  7               7            
                                                                     
        Ĵ
          38      8      8                  8               8            
                                                                     
        Ĵ
          39      9      9                  9               9            
                                                                     
        Ĵ
          3A      :      raised dot colon   sof pasuq       :            
                                                                     
        Ĵ
          3B      ;      ;                  shewa           ;            
                                                                     
                                                                         
                                                                     
        Ĵ
          3C      <      <                  < <mahpak>      <            
                                                                     
        Ĵ
          3D      =      =                  =               =            
                                                                     
        Ĵ
          3E      >      >                  > <yetib>       >            
                                                                     
        Ĵ
          3F      ?      ?                  ?               ?            
                                                                     
        Ĵ
          40      @      dieresis           @               dieresis     
                                                                     
                         (umlaut)                           (umlaut)     
                                                                     
        Ĵ
          41      A      ALPHA              qamats          A            
                                                                     
        Ĵ
          42      B      BETA               <*>             B            
                                                                     
                                            <mahpakatum>                 
                                                                     
        





                                                Symbolic Correspondence  28






        Ŀ
          hex    ASCII    Greek              Hebrew          Latin        
                                                                     
        Ĵ
          43      C      GAMMA              final           C            
                                                                     
                                            (terminal)                   
                                                                     
                                            kaf                          
                                                                     
        Ĵ
          44      D      DELTA              <*>             D            
                                                                     
                                            <seggolta>                   
                                                                     
        Ĵ
          45      E      EPSILON            seggol          E            
                                                                     
        Ĵ
          46      F      ZETA               cholam          F            
                                                                     
        Ĵ
          47      G      ETA                <*> <geres>     G            
                                                                     
        Ĵ
          48      H      THETA              <*>             H            
                                                                     
                                            <garsayim>                   
                                                                     
        Ĵ
          49      I      IOTA               <*> <silluq>    I            
                                                                     
        Ĵ
          4A      J      rough breathing    <*> <rebia>     J            
                                                                     
                         mark                                            
                                                                     
        Ĵ
          4B      K      KAPPA              <*> <zaqef>     K            
                                                                     
        Ĵ
          4C      L      LAMBDA             <*> <zaqef      L            
                                                                     
                                            magnum>                      
                                                                     
        Ĵ
          4D      M      MU                 final           M            
                                                                     
                                            (terminal)                   
                                                                     
                                            mem                          
                                                                     
        Ĵ
          4E      N      NU                 final           N            
                                                                     
                                            (terminal)                   
                                                                     
                                            nun                          
                                                                     
        Ĵ
          4F      O      OMICRON            <*> <qamets     O            
                                                                     
                                            qatan>                       
                                                                     
        Ĵ
          50      P      PI                 final           P            
                                                                     
                                            (terminal) pe                
                                                                     
        Ĵ
          51      Q      XI                 <*> <kepula>    Q            
                                                                     
        Ĵ
          52      R      RHO                <*> <mereka>    R            
                                                                     
        Ĵ
          53      S      SIGMA              sin             S            
                                                                     
        Ĵ
          54      T      TAU                <*> <tipha>     T            
                                                                     
        






                                                Symbolic Correspondence  29






        Ŀ
          hex    ASCII    Greek              Hebrew          Latin        
                                                                     
        Ĵ
          55      U      UPSILON            <*> <munah>     U            
                                                                     
        Ĵ
          56      V      iota subscript     <*> <galgal>    V            
                                                                     
        Ĵ
          57      W      PHI                <*> <illuj>     W            
                                                                     
        Ĵ
          58      X      CHI                final           X            
                                                                     
                                            (terminal)                   
                                                                     
                                            tsadi                        
                                                                     
        Ĵ
          59      Y      PSI                <*> <tebir>     Y            
                                                                     
        Ĵ
          5A      Z      OMEGA              <*> <dehi>      Z            
                                                                     
        Ĵ
          5B      [      [ (left bracket)   [ (left         ae diphthong 
                                                                     
                                            bracket)                     
                                                                     
        Ĵ
          5C      \      \ (back slash)     ;               thorn        
                                                                     
                                                                         
                                                                     
        Ĵ
          5D      ]      ] (right           ] (right        oe ligature  
                                                                     
                         bracket)           bracket)                     
                                                                     
        Ĵ
          5E      ^      circumflex         ^ <atnah>       circumflex   
                                                                     
                         accent                             accent       
                                                                     
        Ĵ
          5F      _      _ (underline)      raphe           _ (underline)
                                                                     
        Ĵ
          60      `      " (double quote)   ' (single       grave accent 
                                                                     
                                            quote)                       
                                                                     
        Ĵ
          61      a      alpha              pattach         a            
                                                                     
        Ĵ
          62      b      beta               bet             b            
                                                                     
        Ĵ
          63      c      gamma              kaf             c            
                                                                     
        Ĵ
          64      d      delta              dalet           d            
                                                                     
        Ĵ
          65      e      epsilon            sere            e            
                                                                     
        Ĵ
          66      f      zeta               dagesh          f            
                                                                     
        Ĵ
          67      g      eta                gimel           g            
                                                                     
        Ĵ
          68      h      theta              he              h            
                                                                     
        Ĵ
          69      i      iota               chiriq          i            
                                                                     
        





                                                Symbolic Correspondence  30






        Ŀ
          hex    ASCII    Greek              Hebrew          Latin        
                                                                     
        Ĵ
          6A      j      smooth breathing   tet             j            
                                                                     
                         mark                                            
                                                                     
        Ĵ
          6B      k      kappa              het             k            
                                                                     
        Ĵ
          6C      l      lambda             lamed           l            
                                                                     
        Ĵ
          6D      m      mu                 mem             m            
                                                                     
        Ĵ
          6E      n      nu                 nun             n            
                                                                     
        Ĵ
          6F      o      omicron            samekh          o            
                                                                     
        Ĵ
          70      p      pi                 pe              p            
                                                                     
        Ĵ
          71      q      xi                 quf             q            
                                                                     
        Ĵ
          72      r      rho                resh            r            
                                                                     
        Ĵ
          73      s      sigma              shin            s            
                                                                     
        Ĵ
          74      t      tau                tav             t            
                                                                     
        Ĵ
          75      u      upsilon            qubbuts         u            
                                                                     
        Ĵ
          76      v      final (terminal)   ayin            v            
                                                                     
                         sigma                                           
                                                                     
        Ĵ
          77      w      phi                vav             w            
                                                                     
        Ĵ
          78      x      chi                tsadi           x            
                                                                     
        Ĵ
          79      y      psi                yod             y            
                                                                     
        Ĵ
          7A      z      omega              zayin           z            
                                                                     
        Ĵ
          7B      {      { (left brace)     { <telisa       AE diphtong  
                                                                     
                                            parvum>                      
                                                                     
        Ĵ
          7C      |      | (vertical bar)   paseq           THORN        
                                                                     
        Ĵ
          7D      }      } (right brace)    } <telisa       OE ligature  
                                                                     
                                            magnum>                      
                                                                     
        Ĵ
          7E      ~      ~ (tilde)          ~               tilde accent 
                                                                     
                                            <sinnorit/zarqa>                
                                                                     
        Ĵ
          7F     DEL     DEL                DEL             DEL          
                                                                     
        





                                                Symbolic Correspondence  31






        KEYBOARD LAYOUTS

        The code tables may be used to map Zedit's use of a symbol to most
        (if not all) keyboard layouts.  Zedit operates independently of the
        computer's code page definitions or character sets except for text
        entered as SPECIAL.  See "Fonts" on page 3 for more information on
        SPECIAL.


















































                                                Symbolic Correspondence  32






        OPTIONAL CONFIGURATION



        DESCRIPTION

        Zedit is configured by default according to what is documented in
        this manual.  No configuration is required.  If keyboard or
        function key redefinitions are desired the configuration file must
        be kept in the same directory as the editor executable module
        (ZEDITx.exe).  The configuration file name is ZEDIT.CFG.

        The optional configuration file may be created by selecting option
        "0" from the primary menu.  The first panel to be displayed will
        contain an entry panel to override the default keyboard assignment
        for both Greek and Hebrew.  The second panel displays the current
        PFkey assignments and allows you to update them.  Both panels must
        be entered for the configuration file to be created.  If no changes
        are desired for one of the panels, simply process it with
        CTRL-Enter without making any changes.

        A second, perhaps unconnected, use is made of the configuration
        file in processing the import and export functions.  The
        configuration file provides a code translate table for exchanging
        codes when doing an import or an export.  If the file you are
        importing does not use the same code correspondence as your
        keyboard customization, you will need another configuration file
        besides the one you use for your customizations.  Using different
        configuration files is a manual process of renaming the ZEDIT.CFG
        file.

        Note: The standard high range (greater than x'7F') encoding for the
        Hebrew consonants is recognized for IMPHEB.  To import data from a
        standard Hebrew editor, no configuration is necessary for the
        consonants themselves.  If you have a configuration file it will
        only be used for code values that fall in the low range.  A
        configuration file will be necessary if the single quote is used as
        punctuation in the file, for example, as the default mapping of the
        single quote is to the character Alef.


        ENTERING THE CONFIGURATION TABLES

        On the first display will be the ASCII character sequence with
        their Zedit characters immediately below it, in paired lines.  Each
        character on the screen occupies a separate field.  This is to
        enable you to enter diacritics as separate characters with no
        reference to their surrounding characters.  The consequence of this
        is that to navigate the cursor around the screen you must use the
        TAB key and the reverse-TAB key to move left and right rather than
        the scroll/arrow keys.

        If you have the code correspondence chart in front of you it may be
        possible to enter the table with the ASCII character set.  This is
        not recommended.  The most obvious reason is that it is easier to


                                                 Optional Configuration  33






        enter the characters and see the correspondence with the Greek or
        Hebrew script.  You should change the Zedit input mode to either
        Greek or Hebrew in the same manner as is done during an edit
        session.

        The changes will not take effect until the panel is processed with
        CTRL-Enter.  Furthermore, the configuration file will not be saved
        until the PFkey configuration panel is processed.

        To enter changes to the PFkeys, find the key to be changed and type
        the command which you would like it to perform.  The entry field
        for the command is only five characters long, so only enter up to
        the first five characters for the command.  Just like the command
        line, the command only needs to be typed to the point where it is
        unique to any other command.










































                                                 Optional Configuration  34






        PRINTING WITH ZEDIT



        PRINT FUNCTIONS

        There are two ways in which to print from within Zedit. In
        addition, Zedit may be used to print without any panel being
        displayed.  The first way to print is to graphically print a screen
        image.  This function is supplied from within Zedit and is
        triggered by pressing a keyboard key which is described by "print
        screen" under "Other PC - PS/2 Keys" on page 21.

        The second way to print is further broken down into two categories
        and is what this section of the manual describes.

        The break down into categories is based on whether Zedit is
        downloading fonts to the printer or is printing a bit mapped
        graphic image of the document.  Either method is invoked by the
        "print" primary command from within edit or browse or by invoking
        Zedit without a display mode option and using /z= to select the
        file to be edited.  Which method Zedit uses, font downloading or
        bit mapped graphics, depends on the command line option chosen when
        Zedit is started.

        Zedit is mainly an editor, and as such, it encodes the character
        sequences for later use, such as reading or printing.  If you have
        some other support for printing Greek or Hebrew text, it is
        possible to convert the data into the form needed by the other
        facility.  Zedit provides some help with this type of task with its
        export function.


        DOWNLOAD FONT OPTIONS



        PRINT DESCRIPTION

        All print options, other than /g, /g+, and /gx use printer font
        downloading capabilities.

        When the print command is used within Zedit, the current, in
        storage buffer that is being displayed by the edit or browse
        session is printed.  Under DOS, this means that while the buffer is
        being printed the cursor will disappear.  Under OS/2 protect mode,
        the cursor will return as a separate thread will print the buffer.
        You may continue to edit the data set, but keep in mind that the in
        storage buffer that you are editing is also the one that is
        printing.  If you attempt to end the edit or browse session while
        the print task is still executing the cursor will disappear just as
        it does under DOS.  Furthermore, any attempt to use a line command
        will have the same affect.

        Note: (OS/2 only) It is not recommended that you continue editing a


                                                    Printing with Zedit  35






        data set while also printing it.  Whether the changes will be
        printed is unpredictable.  Browsing the data from edit or browse
        will not cause problems.  To edit a different data set while
        printing is being done you may use the SWAP command to use the
        other logical session.


        POSTSCRIPT PRINTERS

        Zedit supports PostScript printers by invocation with the /s
        option.  The print screen function is not available with this
        option, however.

        PostScript output is calibrated for full page printing of your
        file.  It is possible to direct the PostScript output to a data set
        rather than to a printer.  Doing so will enable you to edit the
        PostScript print file and change character generation point sizes
        or otherwise customize the output at your discretion.  This, of
        course, assumes that you have familiarity with the PostScript
        language.


        DOT MATRIX PRINTERS

        Zedit will print on any printer that supports the command set
        supported by either the IBM Proprinter, 9-pin models, or the Epson
        FX line of printers.  These printers only support 8 X 8 character
        boxes in their downloadable fonts.  Zedit downloads its 8 X 14
        fonts in two halves and then prints two lines for each line of
        text.  The first pass is the top half of the character and the
        second is the bottom half.  Epson mode is the default mode.  /p
        selects Proprinter draft and /n is Proprinter NLQ.

        The print functions supply the lowest print control sequence to the
        printer.  It adjusts the line spacing due to printing its
        characters in what to the printer is two separate lines.  Other
        than that, you may initialize the printer beforehand to whatever
        characteristics are desired.  This in fact is actually recommended.
        The base draft mode on these printers drops a pixel if two adjacent
        pixels are both set, (i.e. print a dot).  The /n option on the IBM
        Proprinter, NLQ mode, is easier to read than the /p, draft mode,
        since it keeps this from happening.

        The default mode for printing on these dot matrix printers uses two
        down load font buffers in the printer in order to increase the
        speed of printing.  Character sets down loaded to the second buffer
        are mapped to the high ASCII range (x'80'-x'FF').  Early models of
        the IBM Proprinter for the U.S. market do not have both buffers and
        require the usage of the /1 command line option.  The /1 option
        should also be used when using embedded escape (ESC) sequences in
        your document.  This is because the printer will not recognize the
        sequence when it is mapped to the high ASCII range.

        Most printer escape sequences in your document should work when
        using the /1 option.  Keep in mind that each line is printed twice,


                                                    Printing with Zedit  36






        top then bottom, so if a control is turned on and not turned off in
        the current line, the total bottom half would consider it on.  Note
        also that you must use another editor, after creating the document
        with Zedit, to construct escape sequences.

        Note: The Latin character set middledot which is placed on the
        letter L will not print with the dot matrix printer settings,
        (default, /p, /n).

        Note: When printing in OS/2 change the default print driver to
        IBMNULL before doing Zedit font down load printing.


        GENERIC GRAPHIC PRINT OPTION



        PRINT DESCRIPTION

        Generic graphic print is chosen from the command line with the /g,
        /g+, or /gx option.  Most of the discussion in section "Print
        Description" under "Download Font Options" on page 35 applies to
        this section also.  The one exception is that under OS/2, Zedit
        does not create a separate thread for graphic image print.

        The control codes used to print bit mapped graphic images are
        common among a broad range of printers available from most printer
        manufacturers.  IBM refers to to these control codes as IBM PPDS
        and previously referred to them as IBM ASCII control codes.

        Because an image of the data is being printed, rather than the
        normal method of printing characters in a printer font, there are
        some limitations on what may be done.  The bit image printed
        conforms to Zedit screen width dimensions.  The default browse
        width is also the maximum dimension that may be selected.  The
        default dimensions are 72 columns for edit mode and 80 columns for
        browse mode.  The dimension may be shortened by using the /r=
        option on Zedit invocation.  The minimum value that may be selected
        is 16.

        Left margin indentation is automatically provided when the options
        selected allow the output together with the indentation to fit on a
        standard letter size sheet of paper.  To explain further, it is
        easiest to start with what does not provide left margin
        indentation.

          If you specify the /2 option with any of /g, /g+, or /gx there
           will be no indentation.

          If you specify /r= with a value greater than 72 there will be no
           indentation.

          The default value for the print command while in browse mode is
           /r=80 so there will be no indentation provided.



                                                    Printing with Zedit  37






        /g and /g+ will otherwise indent 8 character widths.

        /gx will otherwise indent 5.3 character widths.

        These indentation values need to be factored in with any
        indentation you set up with the printer.  The left margin or
        starting column can be set up on the printer before invoking Zedit.
        Zedit will then use that as the starting point for the line using
        further indentation as stated above.

        Note: Any data in the file being printed that would not be
        displayed on the screen (i.e. such as a line greater than 80
        columns) is not included in the printed output.  The same routines
        that are used to create the Zedit screen display are used to create
        the image which is printed.










































                                                    Printing with Zedit  38






        COMMAND LINE SUMMARY

        Note: Command line options must be coded separately on the command
        line.  Zedit parsing of the command line expects each switch letter
        following a / or - character.


        SCREEN DISPLAY FUNCTIONS

        One of the following screen options, besides /w, which will work
        with the computer display, must be chosen to invoke the Zedit
        panels.

        Option    DESCRIPTION

        /c        640h X 200v CGA resolution, 80 X 14 lines.

        /h        720h X 348v Hercules-type monochrome graphics, 80 X 25
                  lines.

        /m        640h X 480v MCGA resolution, 80 X 25 lines.

        /e        640h X 350v EGA resolution, 80 X 25 lines.

        /v        640h X 480v VGA resolution, 80 X 25 lines.

        /i        720h X 350v text resolution graphics on VGA, 80 X 25
                  lines.

        /i+       720h X 480v text resolution graphics on VGA, 80 X 25
                  lines.

        /t        Non-graphic display in text mode, 80 X 25 lines,
                  primarily used for testing.

        /w        Does not use default colors, white text on black screen
                  display.  This option may be used with any of the screen
                  options.

        /x        1024h X 768v text resolution graphics on 8514/XGA, 80 X
                  25 lines.



        MISCELLANEOUS FUNCTIONS

        Option    DESCRIPTION

        /k        Allow PF11/PF12 usage on enhanced keyboards.  This only
                  is necessary under DOS.  The default is to support ten
                  PFkeys under DOS.

        /z=editdsn Menu bypass to edit on data set "editdsn" (replace with
                  name).  If no screen option is selected, Zedit will print
                  the data set indicated with the /z= option and not


                                                   Command Line Summary  39






                  display any panels.



        PRINTER OPTIONS

        Note: These options are independent of the screen display options.
        Comparisons to screen modes are for illustrative purposes.

        Option    DESCRIPTION

        (none)    The default print mode is for Epson FX print control
                  codes if no other option (/g, /g+, /gx, /n, /p, or /s) is
                  coded.

        /a        When used in combination with one of the generic graphic
                  print modes (/g, /g+, /gx) this option selects alternate
                  PPDS codes for the print stream.  If the /3 option is not
                  also selected then the codes are those required by the
                  IBM 5182 color printer or compatible printers.

                  Together with the /3 option it switches the type of
                  24-pin graphics printers that are supported (e.g. use
                  with Epson, NEC).

        /g        Use PPDS/ASCII generic graphic printer codes (no font
                  download).  The print matches the /i display mode
                  dimensions with a 9 X 14 pixel character box.

        /g+       Use PPDS/ASCII generic graphic printer codes (no font
                  download).  The print matches the /i+ display mode
                  dimensions with a 9 X 19 pixel character box.

        /gx       Use PPDS/ASCII generic graphic printer codes (no font
                  download).  The print matches the /x display mode
                  dimensions with a 12 X 30 pixel character box.

        /n        Use IBM Proprinter, 9-pin, NLQ control codes.

        /p        Use IBM Proprinter, 9-pin, control codes.

        /s        Produce PostScript output.

        /1        Use only normal font down load buffer, no mapping is done
                  to high ASCII codes.  This option is required if the
                  print file contains embedded escape (ESC) sequences.

        /2        The generic graphic print modes (/g, /g+, /gx) ordinarily
                  print in the printer's dual density graphic mode.  This
                  option changes the print to single density graphic mode.
                  In single density mode the letters are wider than in dual
                  density mode, so using /2 for the option kind of makes
                  sense as a multiplication factor, even though dual in
                  most contexts might otherwise imply 2.



                                                   Command Line Summary  40






        /3        Convert the generic graphic print modes (/g, /g+, /gx) to
                  support some 24-pin graphic printers that cannot print in
                  9-pin compatibility mode.  May also be used in
                  conjunction with the /a option for other incompatible
                  24-pin printers.



        AUXILARY OPTIONS

        Option    DESCRIPTION

        /o=outdsn The output file name is "outdsn" (replace with name).
                  The default file is PRN.

        /l=maxlrecl The maximum logical record length is "maxlrecl"
                  (replace with a number).  The default maximum is 258.  In
                  low memory environments, (i.e. DOS) files with additional
                  lines may be edited by lowering this value.  See
                  "Internal Data Representation" on page 3 for information
                  on selecting an adequate value.

        /r=rmar   The right margin from which to begin printing Hebrew
                  right to left printing is "rmar" (replace with number).
                  The default right margin is 72 for edit and 80 for
                  browse.  The minimum value allowed is 16.  When used with
                  the generic graphic print modes (/g, /g+, /gx) the
                  maximum value allowed is 80, otherwise the maximum is
                  whatever your printer will allow.  See the discussion in
                  the section "Generic Graphic Print Option" on page 37 for
                  more information on /g, /g+, and /gx.

        /b        Applies the value of /r= to the display screen as well as
                  to any print file.  The values that are allowed are the
                  same as with the generic graphic print modes.  (See
                  /r=rmar directly above).

                  When used with any of those modes (/g, /g+, /gx) and the
                  corresponding display modes (/i, /i+, /x) you obtain
                  approximate WYSIWYG (what you see is what you get) aside
                  from differing pixel dimensions and aspect ratios between
                  your display screen and your printer.















