home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 411a.lha / TextPlus_v2.2E / TextPlus2.2E.doc < prev    next >
Text File  |  1990-09-08  |  16KB  |  436 lines
  1. *****************************************************************************
  2. *                                                                           *
  3. *            Text Plus V2.2E (c) Copyright 1990 by Martin Steppler          *
  4. *                                                                           *
  5. *  Text Plus V2.2E is SHAREWARE. It is freely distributable, although all   *
  6. *  rights remain with the author. If you like Text Plus and use it  regu-   *
  7. *  larly,  you  should  send  me a donation ($15). This will make you get   *
  8. *  the latest update.                                                       *
  9. *  Advice for all PD-distributors:                                          *
  10. *  Text Plus V2.2E must not be added to a PD-library without my consent.    *
  11. *  The price must not exceed the costs of disk, package and mailing.        *
  12. *                                                                           *
  13. *  Please send bug-reports, suggestions, comments, and MONEY (!!!) to:      *
  14. *                                                                           *
  15. *  Martin Steppler                        Roermonder Str. 112a              *
  16. *  Dr.-Danzebrink-Str. 11                 D-5100 Aachen, FRG                *
  17. *  D-6400 Fulda, Fed. Rep. of Germany     (I study in Aachen)               *
  18. *                                                                           *
  19. *****************************************************************************
  20.  
  21.  
  22. CREDITS
  23.  
  24.          First    I    want  to  thank  JUSTIN  V.  McCORMICK,  whose
  25.          FileRequester (Fish #245) I've  implemented.  He  wrote  the
  26.          best  and  most comfortable filerequester, I've seen so far.
  27.          Thanks JUSTIN!
  28.  
  29.  
  30. CONTENTS
  31.  
  32.          0     CHANGES
  33.          I     INSTALLATION
  34.  
  35.                Descrption of menus and their items:
  36.  
  37.          II    PROJECT
  38.          III   EDIT
  39.          IV    PREFS
  40.          V     STYLE
  41.          VI    FIND
  42.  
  43.          VII   KEYMAP AND SHORTCUTS
  44.  
  45.  
  46.                                   0) CHANGES
  47.  
  48. V2.2E  06.08.1990
  49.  
  50.        - The old file-requester has been replaced by Justin's PATHMASTER.
  51.        - The block-opearations mark, copy, delete, and delete mark can now
  52.          directly be executed with the mouse. (--> III)
  53.        - The keymap has almost entirely changed. Now you can delete single
  54.          words, or skip them, move blocks to the left or right etc...
  55.        - Iconfy
  56.        - Backup-mode for saving files from overwriting them.
  57.        - Some new gadgets. Just have a look at the right border! Wow, 8-)
  58.        - Smaller enhancements (e.g. the main window now starts 1 pixel lower
  59.          than before. So you can easily switch back to the WB-screen.)
  60.        - TextPlus creates an own process. You no longer need to type 'run
  61.          TextPlus' to start it the background.
  62.  
  63. V2.1E  01.05.1990
  64.  
  65.        - TP opens an own screen.
  66.        - A mouse-click now positions the cursor.
  67.        - Blocks are now formatted correctly. (When encountering spaces
  68.          while formatting TP doens't get confused anymore.)
  69.        - 2 bugs of the load-loop have been eliminated
  70.          - Command sequence in letters are no longer handled as regular
  71.            characters.
  72.          - The suffix ".txp" needn't to be typed anymore, in order to
  73.            load a letter correctly.
  74.       - Busy-wait-loop deleted. (How did it get in my program 8-( ?)
  75.  
  76.  
  77.                                I) INSTALLATION
  78.  
  79.  
  80.          Text Plus V2.2E (from now on refered to as TP) can be run
  81.          from both, Workbench and CLI.
  82.  
  83.          USAGE: TextPlus2.2E [-i] [filename]
  84.  
  85.          If  the  i-flag is set, TP only opens an iconized window. If
  86.          you also type a filename, the file will not be loaded  until
  87.          you  activate TP by pressing the MENU BUTTON. Without the i-
  88.          flag set TP will load the respective  file  or  nothing,  if
  89.          nothing was specified.
  90.  
  91.          After a succesful start, TP tries to load its configuration-
  92.          file  'TxP.  Config',  and  if  TP  fails  to find it in the
  93.          current directory, TP  will  search  for  it  in  the  's:'-
  94.          directory. The configuration-file enables the user to create
  95.          a  personal  environment  according to his own requirements,
  96.          i.e. to set the  text-width,  page-length,  tabulators  etc.
  97.          TxP.Config    is  an  ASCII- file, which can be changed very
  98.          easily. This is why I think  the remarks in TxP.Config fully
  99.          suffice for  understanding,  how  to  change  the  settings.
  100.          Anyway, TP runs without TxP.Config, too.
  101.  
  102.  
  103.                                  II) PROJECT
  104.  
  105.  
  106. 1) LOAD
  107.  
  108.          After  clicking  on this menu-point a filerequester pops up,
  109.          the current function of which  -  here:  'Load  file'  -  is
  110.          displayed  in  the    window-title-bar.    The  selector  is
  111.          completely  dynamic  and  asynchronous;  you   may    change
  112.          directories, select files, scroll the file list, etc., while
  113.          the selector is scanning a directory.
  114.  
  115.          The  three  Sort  Gadgets  (Alpha, Size, and Date) work like
  116.          switches. For instance, if you click  on  the  "Alpha"  Sort
  117.          Gadget,  the  gadget will remain highlighted ("On") when you
  118.          release  the  mouse  button.  The  File  Selector  will  now
  119.          alphabetize  directories  automatically  until  you turn the
  120.          Sort Gadget "off" by  clicking  it  again,  or  click  on  a
  121.          differnt Sort Gadget.
  122.  
  123.          Clicking  the  Menu Button activates the FILE or PATH String
  124.          Gadget, allowing you to type  in  a  new  file  or  pathname
  125.          without  having to click inside of the string gadgets first.
  126.          Also, some keyboard shortcuts are available:
  127.  
  128.          ESCAPE        -   Same as clicking on the "Cancel!" gadget.
  129.          Cursor-Up     -   Same as clicking on the Up Arrow gadget.
  130.          Cursor-Down   -   Same as clicking on the Down Arrow gadget.
  131.          Shift-RETURN  -   Toggle between FILE and PATH gadget.
  132.  
  133.          Note  that  if the PATH, FILE, or PATTERN String Gadgets are
  134.          in use, the keyboard shortcuts are  disabled.  The  selector
  135.          has a software path length limit of 344 characters. You will
  136.          receive  a  warning  message   in the titlebar if you try to
  137.          exceed this limit.
  138.  
  139.          After a file has been chosen as described  above,  TP  loads
  140.          either an ASCII- file (letter-mode switched off) or a letter
  141.          (letter-mode switched on; suffix '.txp').
  142.  
  143. 2) APPEND FILE
  144.  
  145.          A  file  will be appended to the end of the already existing
  146.          file.
  147.  
  148. 3) DELETE FILE
  149.  
  150.          The file will be deleted in memory.
  151.  
  152. 4) SAVE
  153.  
  154.          The file is saved with its current  name  depending  on  the
  155.          letter-mode either in letter-format or as an ASCII-file. The
  156.          filerequester won't pop up.
  157.  
  158. 5) SAVE AS ...
  159.  
  160.          After  a  filename has been chosen, it is saved depending on
  161.          the letter-mode either in letter-format or as an ASCII-file.
  162.  
  163. 6) SAVE & QUIT
  164.  
  165.          The file is saved with its current name and then  TP  quits.
  166.  
  167. 7) PRINT
  168.  
  169.          A  requester  appears,  in  which you can choose one of four
  170.          print-modes (NLQ, Pica, Elite  or  Condensed)  and  set  the
  171.          pages  to  be printed, left and right margin, and the paper-
  172.          length.  Furthermore  you  can  switch  on/off  the    page-
  173.          numbering-mode  (at  the  end  of  every  page its number is
  174.          printed) and the line-numbering-mode.
  175.          At the beginning of every page the user  is  asked,  whether
  176.          he  wants  to  skip  over  the  respective page, print it or
  177.          abort. If an error occurs, you are  requested,  whether  you
  178.          want to try again or abort.
  179.  
  180. 8) ICONIFY
  181.  
  182.          TP closes its window and its screen and opens up an iconized
  183.          window  on  the  Workbench.  You  will  get back to the main
  184.          program by pressing the MENU  BUTTON  while  the  window  is
  185.          activated.  The coordinates of the iconify-window can be set
  186.          in the config-file. Using iconify instead  of  dropping  the
  187.          screen to the background will free 42KB of memory.
  188.  
  189. 9) HELP
  190.  
  191.          Show the keymap.
  192.  
  193. 10) ABOUT
  194.  
  195.          Informations about the author.
  196.  
  197. 11) QUIT
  198.  
  199.          Quit TP without saving changes.
  200.  
  201.  
  202.                                   III) EDIT
  203.  
  204. 1) MARK BLOCK
  205.  
  206.          The  current position of the cursor determines the beginning
  207.          and after another click on MARK BLOCK the end of the  block.
  208.          Now  the  block-mode  is  switched  on,  which  can  only be
  209.          switched off by clicking on 'Delete Mark' or 'Delete Block'.
  210.  
  211. 2) COPY BLOCK
  212.  
  213.          Insert  previously  defined block at the current position of
  214.          the cursor.
  215.  
  216. 3) DELETE BLOCK
  217.  
  218.          The marked block is deleted.
  219.  
  220. 4) DELETE MARK
  221.  
  222.          The block-mode is switched off.
  223.  
  224.          Those four block-operations can be done very easily with the
  225.          mouse:
  226.  
  227.          DOUBLECLICK    Mark begin of block.
  228.  
  229.                         If  the  mouse-pointer  is in the first or in
  230.                         the last line TP will scroll respectively. Of
  231.                         course, you can  use the prop gadget and  the
  232.                         arrow gadgets, too.
  233.  
  234.          DOUBLECLICK    Mark end of block.
  235.  
  236.          DOUBLECLICK           Copy block
  237.          DOUBLECLICK + SHIFT   Delete block
  238.          DOUBLECLICK + ALT     Delete mark
  239.  
  240. 5) LOAD BLOCK
  241.  
  242.          An  previously  selected  file  is  inserted  at the current
  243.          position of the cursor.
  244.  
  245. 6) SAVE BLOCK
  246.  
  247.          The marked block is saved on disk.
  248.  
  249. 7) PRINT BLOCK
  250.  
  251.          The print-out takes  place  as  described  above  ->  PRINT.
  252.  
  253.  
  254.                                   IV) PREFS
  255.  
  256. 1) LENGTH OF PAGE
  257.  
  258.          The  new  page-length  is set which must range from 10 to 72
  259.          lines.
  260.  
  261. 2) WIDTH OF TEXT
  262.  
  263.          The width must range from 10 to 255. If  a  block  has  been
  264.          marked, it will formatted according to the new width.
  265.  
  266. 3) INSERT ON/OFF
  267.  
  268.          The  insert-mode  is  either switched on or off. If switched
  269.          on the 3 letters 'INS' above  the  ruler  indicate  it,  and
  270.          characters  are  inserted  in  the already existing text and
  271.          don't overwrite the text.
  272.  
  273. 4) LETTER ON/OFF
  274.  
  275.          The state of the letter-mode is displayed  above  the  ruler
  276.          (LETTER/ASCII).  Every  time  when a file is loaded or saved
  277.          the letter-mode determines whether an ASCII-file or  a  file
  278.          in letter-format is loaded or saved. You can identify a file
  279.          in letter-format by its suffix '.txp'.
  280.  
  281. 5) AUTO-DIV ON/OFF
  282.  
  283.          Text Plus V2.2E was originally designed to be a German word-
  284.          processor.  Due  to  the  occurrence  of ultra-long words in
  285.          German a function called Auto-Div which  divides  ultra-long
  286.          words  in  accordance  with German grammar has been provided
  287.          in order to decrease the number of ultra-long  gaps  in  the
  288.          text.  Auto-Div  divides  English  words  in accordance with
  289.          German grammar, too. This is why you better keep it switched
  290.          off. If there is someone who  wants  TP  to  divide  English
  291.          words  according  to  English grammar then don't hesitate to
  292.          send me first the  share  and  then  the  rules  of  English
  293.          grammar.
  294.          If Auto-Div is switched on and if a block is marked and then
  295.          formatted   (left/right-aligned,  centered,  justification),
  296.          words which are too long for the respective line are divided
  297.          in order to avoid large gaps. Auto-Div is not perfect.  This
  298.          is  why  you should always check the division. Words divided
  299.          by TP end with this dash '­' and only this dash is  accepted
  300.          by TP in case of reformatting to indicate a division.
  301.  
  302.  
  303. 6) BACKUP ON/OFF
  304.  
  305.          If switched on TP checks the disk for the same filename  you
  306.          want to save. Providing the file exists the suffix '.bak' is
  307.          added  to  this  file  in  order  to  protect  it from being
  308.          overwritten.
  309.  
  310. 7) GO TO ...
  311.  
  312.          After  the  string  which  is  to  be  searched for has been
  313.          entered, TP is searching for it at the  beginning  of  every
  314.          line  and  only  finds  the string if it starts in the first
  315.          column.
  316.          This routine is quite useful for C-programmers, because  one
  317.          can find modules, e.g. main() , very fast especially in long
  318.          sourcecodes.
  319.  
  320. 8) GO TO LINE X
  321.  
  322.          TP  jumps  to  line  x.  This  routine,  too,  is useful for
  323.          programmers, because compilers tell the  user  the  line  in
  324.          which an error has occurred.
  325.  
  326.  
  327.                                   V) STYLE
  328.  
  329.  
  330. 1-4) NORMAL, UNDERLINE, BOLD, ITALIC
  331.  
  332.          The  new style is set, and if a block has been marked, it is
  333.          displayed in the new style.
  334.  
  335. 5-8) LEFT ALIGNED, RIGHT ALIGNED, CENTERED, JUSTIFICATION
  336.  
  337.          The line  in  which  the  cursor  is  located  is  formatted
  338.          according  to  the  new  alignment,  or  if a block has been
  339.          marked, the block is formatted.
  340.  
  341.  
  342.                                   VI) FIND
  343.  
  344.  
  345. 1-3) FIND, NEXT, PREVIOUS
  346.  
  347.          After the search-string has been entered  and  found  it  is
  348.          displayed  in  the  top  line  and  the cursor is set to the
  349.          beginning of the word. NEXT and PREVIOUS search for the next
  350.          or previous occurrence of the already entered string.
  351.  
  352. 4-6) REPLACE, NEXT, PREVIOUS
  353.  
  354.          After the search-string and  the  replace-string  have  been
  355.          entered  and the search was successful, the user is asked if
  356.          he really wants  to  replace  the  found  string.  NEXT  and
  357.          PREVIOUS  search  for the next or previous occurrence of the
  358.          search-string.
  359.  
  360.  
  361.                           VII) KEYMAP AND SHORTCUTS
  362.  
  363.  
  364. 1) KEYMAP
  365.  
  366.       CONTROL
  367.                        -b   mark begin/end of block
  368.                        -c   insert block at position of cursor
  369.                        -d   delete mark
  370.                        -x   delete block
  371.                        -q   save and Quit
  372.                        -t   display length and end of Text
  373.               -n/-u/-o/-k   style: Normal / Underline / bOld / italiK
  374.               -e/-r/-a/-p   insErt / letteR / Auto-div / backuP on/off
  375.  
  376.       SHIFT-DEL             delete line
  377.       SHIFT-CR              insert last deleted line
  378.       CTRL -BS/DEL          delete begin / rest of line
  379.       ALT  -BS/DEL          delete previous / next word
  380.       SHIFT-BS              delete spaces
  381.       CTRL/ALT-TAB          move line to the previous/next tab-stop or
  382.                             move block to the previous/next tab-stop
  383.       CTRL -CRSR-LFT/RGT    move block left/right
  384.       SHIFT-CRSR-UP/DOWN    jump to top/bottom of window or 18 lines up/down
  385.       ALT  -CRSR-UP/DOWN    jump to begin/end of text
  386.       CTRL -CRSR-UP/DOWN    jump to begin of previous/next page
  387.       SHIFT-CRSR-LFT/RGT    jump to begin/end of line
  388.       ALT  -CRSR-LFT/RGT    jump to previous/next word
  389.  
  390.       HELP     show keymap
  391.       ESC      quit without saving changes
  392.  
  393. 2) SHORTCUTS
  394.  
  395.          RIGHT AMIGA
  396.  
  397.          -g       load file
  398.          -a       append file
  399.          -d       delete file in memory
  400.          -w       save
  401.          -s       save as ...
  402.          -q       save and quit
  403.          -p       print
  404.          -y       iconify
  405.  
  406.          -k       load block
  407.          -m       save block
  408.          -z       print block
  409.  
  410.          -t       page-length
  411.          -w       text-width
  412.  
  413.          -n       style:  normal
  414.          -u               underline
  415.          -b               bold
  416.          -i               italics
  417.          -l       alignment: left
  418.          -e                  right
  419.          -c                  centered
  420.          -j                  justification
  421.  
  422.          -f       find
  423.          -1        ""  next
  424.          -2        ""  previous
  425.          -r       replace
  426.          -3        ""  next
  427.          -4        ""  previous
  428.  
  429.  
  430. IS THIS THE END OF THE DOC-FILE! OH, YES!
  431.  
  432. Keep on using Text Plus V2.2E, bye bye and tschuess
  433.  
  434.  
  435. 08.08.1990                       Martin
  436.