******************************************

     Manual for EWIPE (Extended WIPE)

******************************************

                                                  Hiromasa Sekishita
                                               <sekisita@jnet-jp.to>
                                         first edition  Dec.20, 1998
                                          last updated  Mar.12, 2000

*** Introduction

  EWIPE is a presentatin tool for UNIX based on Tcl/Tk.
  You can make and edit data by use of GUI.


*** Required environment

  EWIPE requires Tcl7.6/Tk4.2 or later for UNIX.

  (It also works on Windows95.)


*** Install

  At first, confirm a path for wish.

  Next, copy uncompress files to a adequate directory.
  When I explain a way of install, I consider a target directory for 
  copying as /usr/local/lib/ewipe.

  If you use EWIPE on the other directory of one which files are 
  installed, you need to set a environment parameter or change a 
  file of ewipe.


  * The case of setting a environment parameter

    For example, if you use csh, set as follows.

        % setenv EWIPEPATH /usr/local/lib/ewipe


  * The case of changing a file of ewipe

    Change the 30th line of ewipe as follows.
    from

        set PATH .

    to (a absolute path)

        set PATH /usr/local/lib/ewipe
                 ^^^^^^^^^^^^^^^^^^^^

    * If you don't find tclIndex in the directory which includes ewipe,
      or if you want to make tclIndex again, execute tclsh or wish, and
      command as follows.

               % auto_mkindex . *.tcl
               % exit


*** Way of starting

  EWIPE starts working when you command as folows.

      ewipe [filename for editing]

  EWIPE Viewer also starts working directly when you command as follows.

      ewipe -v [filename]
      ewipe -view [filename]


*** Options for starting

  There are options as follows.

      -V, -Version, -version : showing a version information of EWIPE
      -e                     : for English
      -h, -help              : showing a easy help message


*** How to use

  * Editing

    * Menu

      File  : concerned with files
        New         : makeing a new file
        Load        : loading a file
        Save        : saving a file
        Save as HTML: saving a file as HTML format
        Save as MGP : saving a file as MagicPoint format
        About EWIPE : showing a version information of EWIPE
        Exit        : exiting
                      You are asked whether you save the file before 
                      EWIPE exits.

      Option: various setting
        Language          : changing a language
            Japanese      : Japanese
            English       : English

        Path type         : selecting shown path in selecting files
            absolute path : absolute path
            relative path : relative path

        Page number       : setting for showing page number on EWIPE Viewer
            off           : not shown
            on            : shown

        Pointer           : choosing a cursor which is used as a pointer 
                            on Viewer

        Select background : choosing a background of Viewer

        Background type   : selecting a way of showing background
            normal        : showing on center of view
            tiled         : showing as tiled

        Title type        : selecting a way of showing title
            box           : showing box around title text
            line          : showing title with underline

        HTML color        : setting for a text color in HTML
            Mono          : monochrome
            Color         : color

        HTML size         : setting for a text size in HTML
            Normal        : normal (<FONT SIZE=3>)
            Large         : large  (<FONT SIZE=5>)

        Viewer size       : selecting a window size of Viewer
                          : 640x480
                          : 800x600

        Viewer redraw     : validateing the function of auto redraw on 
                            EWIPE Viewer
            off           : off
            on            : on

        View mode         : EWIPE Viewer is displayed, 
                            Editor is not displayed

        Save options      : saving options
            off           : options are not saved
            on            : options are saved

    * Buttons on top of view (from leftside)

      label : changing a label on a cursor position
              Choose a label from the menu.
      insert: inserting new line previous to a cursor
      add   : inserting new line next to a cursor
      cut   : removing a line pointed by a cursor
              The line is temporarily stored.
      paste : inserting the stored line previous to a cursor
      edit  : editing a text pointed by a cursor
              If a label is "pict", input a filename.
              If it is "table", edit a table.
      up    : moving a line pointed by a cursor up
      down  : moving a line pointed by a cursor down
      color : changing a text color of a line pointed by a cursor
              Choose a color from the menu. You can change other color 
              by choosing "etc". Input a color name or a code as #RRGGBB.
      font  : changing a text font of a line pointed by a cursor
              Choose a font sizr from the menu. You can change other 
              font by choosing "etc".
      attr  : setting a line pointed by a cursor as "moving text"


    * Buttons on bottom of the view (from leftside)

      Viewer     : EWIPE Viewer window is opened
                   If it has already opened, the preview on it is 
                   updated.
      contents   : showing the table of contents
      page No.   : the current page number
                   You can input a page number directly.
      prev       : showing previous page
      next       : showing next page
      insertpage : making new page previous to the current page
      addpage    : making new page next to the current page


    * Editing pages by using a mouse

      left button  : pointing a line order to edit 
      right button : canceling to point

      double-clicking left button :
          for label      : changing a label
          for text       : editing a text
                           input a file name if the label is "pict".
                           edit a table if the label is "table".
          for background : making new line in the position pointed by 
                           the cursor 

    * Editing a table of contents by using a mouse

      left button                 : pointing a page
      double-clicking left button : changing the page
      center button               : moving the page pointed by cursor 
                                    previous to the page clicked now

  * Editing a table

    Adjusting location for each column is set by entering following 
    charactor to top input box.

      l : left adjust
      c : centering
      r : right adjust

    If the other charactor is entered, "c" is set as default. 

    The size of table can be adjusted by buttons on bottom.
    Maximum size is 10x10. Input Spaces are output directly.

    * Buttons

      addrow    : Adding a row on last row
      delrow    : Deleting a last row
      addcolumn : Adding a column on last column
      delcolumn : Deleting a last column

  * Choosing a pointer

    pointer          : The shape of cursor used for pointer of Viewer
    forground color  : Foreground color of pointer (inside color of cursor)
    background color : Background color of pointer (edge color of cursor)
    left pen color   : Drawn line color by clicking left button
    right pen color  : Drawn line color by clicking right button

    * Buttons

      Select : Showing the menu for setting
      Test   : Testing the setting

    You can set a color by inputting to input box directly, in addition 
    to selecting from menu.


  * How to use EWIPE Viewer

    * Operation on Page View Mode

      Next page            : n, Right cursor, Space, Clicking left button
      Previous page        : p, Left cursor, Delete, Backspace, 
                             Clicking right button
      Title list           : Enter, Clicking center button
      Showing help         : h
      Show/Hide editor     : e
      Showing page number  : s
      Showing time         : t
      Resetting time       : r
      Closing EWIPE Viewer : q
 
    * Operation on Title View Mode

      Selecting page   : Double clicking left button, Enter
      Cancel           : Clicking right button, ESC

      pen   : Drawing line mode (same as "Shift")
      page  : Showing page number (same as "s")
      help  : Showing help (same as "h")
      cancel: Cancel

    * Drawing Line Mode

      When you hit Shift key on Page View Mode or push "Pen" button on 
      Title View Mode, the shape of cursor changes to pen and you can 
      draw free line on page. You can draw it by left or right button 
      and delete by center button (or "clear" button on bottom of 
      page). You can finish this mode by hitting Shift key again (or 
      "Return" button on bottom of page).


*** labels

  title           title and sub title
  item            * item
  subitem           # item
  subsubitem          - item
  subsubsubitem         + item

  left            left adjust
  center                       centering
  right                                   right adjust

  pict            show of picture (gif format)
  symbol          symbol
  text            A text including space, tab and enter is showed 
                  directly.
  textbox         A text is showd in the box on the center.
  table           show of table
  animation       show of animation

  pause           pause


*** configurating environment

  You can define states of options in starting EWIPE and well used format 
  as configuration file.

  The configuration file has to be placed in home directory as named 
  ".ewipe". "dot.ewipe" is its sample. So you can use it by copying.

  More details are described in "dot.ewipe".


*** New version of EWIPE

  You can download a new version of EWIPE from

      http://www.jnet-jp.to/~sekisita/ewipe/


*** Copyright

  EWIPE complies with GNU GENERAL PUBLIC LICENSE Version 2.

  The copyright of this document is belong to me. You can distribute 
  it freely. But if you have any trouble by it, I am not in charge 
  of that.
  

*** Acknowledgement

  I thank Mr.Fukuda for his cooperation.

  I thank members of wipe-ml, Mr.Ueki, Mr.Umeshima, Mr.Ishioka, 
  Mr.Yakuwa, Mr.Ishii, Mr.Mutoh, Mr.Itojin, Mr.Tange for their 
  advices, and thank everyone who use EWIPE.

  WIPE provides my making EWIPE with useful information. I thank 
  Mr.Utashiro for his agreeing about an announcement of EWIPE.

  EWIPE has improved by cooperation of WIPE-ML members. I hope it 
  will continue to be improved by them.


(*) WIPE (Wide Instant Presentation Environment) is a presentation 
    tool which is made by Mr.Utashiro.

(*) WIPE2 is a improved program based on WIPE which is made by 
    Mr.Ishioka.



















