home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 1 / FFMCD01.bin / bbs / libdisks / d700t799 / disk750.lha / SaveW / SaveW.doc < prev    next >
Encoding:
Text File  |  1992-10-13  |  5.8 KB  |  197 lines
  1.  
  2.  
  3.  
  4.                         Documentation SaveW Version 1.3
  5.  
  6.                                written 1992
  7.  
  8.                                 by H.P.G
  9.  
  10.                              FREEWARE Version
  11.  
  12.  
  13.  
  14. INDEX:
  15.  
  16.             Index
  17.             General Description
  18.             System
  19.             Legal Stuff
  20.             Start Parameters
  21.             Using SaveW
  22.             Last
  23.             Address
  24.             List of Files
  25.  
  26.  
  27.  
  28.  
  29. General Description:
  30.  
  31. SaveW is a little Cli-programm, which saves  the  settings  (LeftEdge,TopEdge,
  32. Width and Height) of the current window to  a  file  or  alternatively  writes
  33. them to the Cli-window.
  34.  
  35. Later this setting-file can be used  to  change  a  window  to  its  contents.
  36.  
  37. SaveW is a companion program to SizeW, which should  be  also  on  this  Disk.
  38.  
  39. SaveW saves the window-settings and SizeW sizes and moves the Window.
  40.  
  41. SaveW ist only useful if you`re also using SizeW.
  42.  
  43. System:
  44.  
  45. You need at minimum Kickstart 2.0 Version 37.xx .
  46.  
  47. Under Version 1.2 and 1.3 SaveW couldn`t run because of calling a  lot  a  new
  48. library functions and features.
  49.  
  50.  
  51. Legal Stuff:
  52.  
  53.  
  54.         This  program  and  all files come with it, also the docfiles, are
  55.         released as FREEWARE.
  56.  
  57.         this means:
  58.  
  59.             everybody may use SaveW,
  60.  
  61.             everybody may copy SaveW, if:
  62.  
  63.                 1. You copy all included files, see list at the end of the
  64.                    doc file.
  65.                 2. No changes are made,  this  means  the  program and all
  66.                    included files must stay in the original form.
  67.                    Exception: you  may  archieve  it; but in this case you
  68.                               must also archieve the whole package.
  69.                 3. If  you  recompile  it, you have to include a notice to
  70.                    the original author. If you also want to (re)distribute
  71.                    in any new form you have to send me a copy.
  72.                 4. You may not sell SaveW.
  73.                    Execption: you`re  allowed  to  take  a  small copy fee
  74.                               which should not extend 5US$.
  75.                 5. If you want to include SaveW
  76.                    or one of the  included files as a part of a commercial
  77.                    package,  you  must  have  written  permission  of  the
  78.                    author (address see below).
  79.  
  80.  
  81.         I take no warranty or garanty for the function of this program.
  82.         The whole risk of using SaveW stays only by the user.
  83.  
  84.  
  85. Start Parameters:
  86.  
  87. SaveW can be called only from Cli and has the following SYNTAX:
  88.  
  89.  
  90. SYNOPSIS:        SaveW [Config|INFO/S]
  91.  
  92. with:
  93.  
  94.  
  95.         Config    String          for Config you  should  specify  a  filename
  96.                                   in which the settings of the current  active
  97.                                   window will be written.
  98.                                   If you donot specify any configuration  file
  99.                                   SaveW uses its default file:
  100.                                   's:Window.config'.
  101.  
  102.                                   This is also the dafault file of  SizeW.  So
  103.                                   you are enabled  to  use  SaveW  with  SizeW
  104.                                   without the need to specify any  commandline
  105.                                   parameter.
  106.  
  107.         INFO                      if you type INFO instead of  a  config  file
  108.                                   SaveW writes the  settings  of  the  current
  109.                                   active window in the Cli-window.
  110.                                   So you are able to improve  different  sizes
  111.                                   and   settings   before   saving   anything.
  112.  
  113.  
  114.         If you specify Config and INFO the config file will be ignored.
  115.  
  116.  
  117.  
  118. Using SaveW:
  119.  
  120. The useful thing with SaveW and SizeW  is,  to  use  different  sizes  of  cli
  121. windows without the need to type everytime the settings by yourown.
  122. Therefor you can create some Aliases or write Batch-Scripts.
  123.  
  124. E.g.:
  125. here is a Batch-Script that replaces the  Endcli  command.  Before  the  Shell
  126. terminates the current window settings will be written  to  's:LastShell.cfg'.
  127.  
  128. ( Therefor I assume, that this Batch-Script is placed in the s: Directory with
  129.   the name 'End' and its S-Bit is set by typing 'Protect s:End +s'. )
  130.  
  131.  
  132. _____________________________________________________________________________
  133.  
  134.     .key NONE             ; no Parameters
  135.  
  136.     SaveW s:LastShell.cfg ; save the window settings
  137.     Wait 1                ; wait for the end of the write-request
  138.     Endcli                ; closing the Shell-window
  139.  
  140. _____________________________________________________________________________
  141.  
  142. Now you should close a Shell always by calling 'End'.
  143.  
  144. Now you have to insert the following line to you s:shell-startup file:
  145.  
  146.  
  147.     'SizeW F s:LstShell.cfg'
  148.  
  149.  
  150. So you get each time you start a NewShell the  window  settigns  you  had  the
  151. last time you finished a shell by calling End.
  152.  
  153.  
  154. NOTICE:
  155.  
  156.        Bacause of saving always the current window settings, you  should  take
  157.        care that only the Shell-window is the active one. Else the settings of
  158.        another window will be saved.
  159.  
  160.        You can also use SaveW and SizeW to change settings from other  windows
  161.        as cli-windows. But you should realize that there are some programs that
  162.        react a little critical by trying to size their windows
  163.        (that means GURU).
  164.  
  165.        Certainly SizeW only sizes windows that have a SizeGadget.
  166.  
  167.  
  168. Last:
  169.  
  170.        I hope many people use SizeW and SaveW.
  171.  
  172.        If you find any bugs please let me know.
  173.  
  174.        Also serious critic and/or ideas are wellcomed.
  175.  
  176. Address:
  177.  
  178.        Send all Messages to:
  179.  
  180.               Hans-Peter Guenther
  181.               Grueener Weg 5
  182.               W-3501 Fuldatal 2
  183.               GERMANY
  184.  
  185.  
  186. List of Files:
  187.  
  188. SaveW           : the binary
  189. SaveW.info
  190. Ende            : batch file
  191. Ende.info
  192. SaveW.doc       : english manual
  193. SaveW.doc.info
  194. SaveW.dok       : german manual
  195. SaveW.dok.info
  196.  
  197.