home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD2.bin / bbs / text / xmore-1.4.lha / xMore / xMore.doc < prev    next >
Text File  |  1994-04-11  |  24KB  |  682 lines
  1.  
  2.                                  xMore 1.4
  3.                                10 April 1994
  4.  
  5.       Copyright (c) 1993,1994 by Jorma Oksanen. All rights reserved.
  6.  
  7. xMore is a freely distributable, copyrighted piece of software.
  8.  
  9. Since xMore is free, it comes with NO WARRANTIES.  The author is not
  10. responsible for any loss or damage arising from the use or inability to use
  11. xMore; the user takes all such responsibility.
  12.  
  13. No charge may be made for xMore, other than a nominal copy fee.  xMore may
  14. not be distributed with a commercial product without the author's prior
  15. consent.  xMore must be distributed with all documentation intact and
  16. unaltered.  Permission is expressly granted to Fred Fish to distribute on
  17. his fine collection of disks.
  18.  
  19. Although xMore is freeware, DONATIONS WOULD BE GLADLY ACCEPTED, either
  20. money or stuff you've written yourself.
  21.  
  22.  
  23. What is it?
  24. -----------
  25.  
  26. Yet another file reader, you might think, and you are right.  I missed
  27. small XPK-understanding file reader with reasonable feature list, but there
  28. was none available.  Most ( (c) 1992 by Uwe Röhm) can hardly be called
  29. small (but it surely has 'reasonable' feature list!).  I have to admit that
  30. xMore is currently bigger than I planned it to be, but people don't seem to
  31. want small programs, they want features!  So, what do you get?
  32.  
  33.     + light speed search! No loss of speed even if case insensitive
  34.       and/or backwards!
  35.     + wildcard search. Searching doesn't slow down if only "?" is
  36.       used (in fact it is FASTER when "?" is used).
  37.     + hex mode.
  38.     + FAST scrolling. Should beat Most (pun intended) textreaders
  39.       using customized Text() function with custom screen.
  40.     + displays ANSI styles (no colors) and some backspace-styles
  41.     + variable TAB size! (now you can read those funny #?.c
  42.       files with too much TABs ;)
  43.     + can start one of the four possible editors.
  44.     + freely definable keys!
  45.     + font sensitivity, user definable font.
  46.     + definable window dimensions, defaults to display size.
  47.     + opens on any public screen or opens it's own screen.
  48.     + multiple files from shell, Workbench and file requester.
  49.     + pipe support.
  50.     + clipboard support.
  51.     + Support for Directory Opus compatibility.
  52.     + character conversion.
  53.     + lots of small details like default zoomed size exactly one
  54.       line high. Small things make the difference!
  55.     + can be made resident (has been pure from day one, but who
  56.       remembers to mention everything)
  57.     + OS 2.04 required (sorry, v36 users. There just is too much
  58.       functions in RKMs with text 'this function is broken in V36'
  59.       that I didn't bother dodging them. To pre-2.0 users xMore is
  60.       Yet Another Reason To Update. Come on guys, do you use CP/M
  61.       at work or what ? ;)
  62.     + Can read files containig more than 65535 lines! With hex mode
  63.       this is MUST (256K+ file in narrow window = lots of lines!).
  64.       (This would be suitable place to mention certain well-known
  65.       directory utility and another XPK-supporting reader which both
  66.       assume no-one has REALLY big files, but that could give offence
  67.       to JP and UR, so I won't)
  68.  
  69.     - wildcard search only supports "?"
  70.     - reads whole file into memory (EVERYBODY has min. 1 Meg today)
  71.  
  72.  
  73. Installation
  74. ------------
  75.  
  76. Just copy it!  If you want to get Most of it, check that you have in your
  77. LIBS:  drawer the following libraries:
  78.  
  79.   asl.library        needed for file requester
  80.   commodities.library    needed for defining keys (more about that later)
  81.   diskfont.library    needed if you use disk-based font
  82.   iffparse.library    needed for clipboard cut/copy/paste
  83.   xpkmaster.library    reason for xMore's existence!
  84.  
  85. You also need clipboard.device in DEVS:  if you intend to use clipboard
  86. (makes sense or what ?).
  87.  
  88. xMore works just fine (althought slightly limited) without any disk-based
  89. libraries, so it's easy to use with floppy systems and distribution disks.
  90.  
  91.  
  92. Usage
  93. -----
  94.  
  95.   From workbench:
  96.  
  97.     Just double-click on xMore's icon and it will open the file requester.
  98.     Alternatively you can select one or more text files with extended
  99.     selection (RTM) and then double-click on xMore.  And ofcourse it works
  100.     fine as default tool, too.
  101.  
  102.     If you give a drawer to xMore as one of the arguments, xMore will open
  103.     file requester in that drawer.
  104.  
  105.  
  106.  
  107.   From shell:
  108.  
  109.     Type "xMore" followed with zero or more file names.  xMore acts just as
  110.     it would from Workbench:  without arguments it opens file requester, if
  111.     you give it a directory name, file requester opens there.  It makes no
  112.     sense to give more than one drawer to xMore.
  113.  
  114.  
  115.   You can use multiple selection from file requester too.  xMore does not
  116.   close it's window until you quit the last file you gave to it, but you
  117.   can force it to quit without reading rest of files using control-esq (or
  118.   whatever key you have binded FORCEQUIT to).
  119.  
  120.  
  121. Options
  122. -------
  123.  
  124. Abbreviations for options (only from shell) are in parenthesis.
  125. xMore silently discards lines it can't parse in settings file.
  126.  
  127. ¹ FILES
  128.     Specify files to read (what else?)
  129.  
  130. ² DEFAULTDIR
  131.     Specifies directory where xMore opens it's initial filerequester.
  132.  
  133. ³ SETTINGS
  134.     Specifies settings file to read. Default is "ENV:xMore/xMore".
  135.  
  136. ³ NOSETTINGS
  137.     Inhibits settings file reading.  From shell, also inhibits tooltype
  138.     parsing.
  139.  
  140.   PUBSCREEN (S)
  141.     Name of public screen where xMore opens its windows.  xMore will open
  142.     screen if it isn't already open.  This screen will be closed when xMore
  143.     quits.  If you have open windows on xMore's screen you will get
  144.     requester telling you to close all windows to allow xMore to quit.
  145.  
  146.   SCREENMODE (SM)
  147.     Screenmode used to open new public screen.  If mode is not specified,
  148.     xMore tries to open screen with same screen mode that Workbench uses.
  149.  
  150.   FONT (F)
  151.     Name of the font used.  Given with format <fontname>/<fontsize>, where
  152.     fontname may contain path.  xMore does not accept proportional fonts,
  153.     fonts higher than 64 points or fonts that are written from right to
  154.     left (sorry about that last one ;).  If font is not given or it's not
  155.     within above limits, system default font will be used.
  156.     If you have 68020 or better and the font is 8*8 pixel font, xMore uses
  157.     it's own Text() routine whenever possible.  On bog standard
  158.     A1200/030/50MHz with 10Mb Fast memory this means 200000 chars/second
  159.     raw rendering speed.
  160.  
  161.   WINDOW (W)
  162.     Position and dimensions of window.  Given as left/top/width/height.  If
  163.     you omit any of the parameters, default will be used.  Note that
  164.     intuition may move and/or shrink the window to make it fit to screen.
  165.  
  166.   UNIT
  167.     Clipboard unit to use. Default is 0.
  168.  
  169.   RMBQUIT
  170.     If this switch is given xMore will do FORCEQUIT when right mouse button
  171.     is pressed below title bar.  To access menus you have to position the
  172.     pointer at (or above) title bar.
  173.  
  174. ¹ TEXT/ASCII & HEX
  175.     Force filetype to text or hex.  If filetype is not given, xMore will
  176.     determine type by first bytes of file.
  177.  
  178. ² FILETYPE
  179.     Tooltype/setting equivalent of above. Can be TEXT/ASCII or HEX.
  180.  
  181.   TABSIZE (TAB)
  182.     Sets TAB size.  Default is 8. Maximum is 32.
  183.  
  184.   SPACING (SPC)
  185.     Number of extra pixels to insert between lines. Default is 0. Maximum
  186.     is 32.
  187.  
  188.   FASTSCROLL
  189.     Specifies how many lines SCROLLUP/SCROLLDOWN will scroll at once. This
  190.     can be used to speed up scrolling of large windows. Lines scrolled at
  191.     once is calculated as MIN(1,(visible_lines-1)*FASTSCROLL/100), so
  192.     FASTSCROLL 0 scrolls one line at time, while FASTSCROLL 100 forces
  193.     SCROLLUP/SCROLLDOWN to act like PAGEUP/PAGEDOWN. Default is 0.
  194.  
  195.   CONVERT
  196.     Specifies conversion file to read. Default is "ENV:xMore/convert".
  197.  
  198.   NOCONVERT
  199.     Inhibits conversion file reading.
  200.  
  201. ² EDITOR/XEDITOR/XPKEDITOR/XPKXEDITOR
  202.  
  203.     Specifies program to run when you try to run editor. If window is in
  204.     hex mode, XEDITOR is started insted of EDITOR.  If current file is
  205.     compressed, XPKEDITOR or XPKXEDITOR is used instead, allowing you to
  206.     have different editors for packed and non-packed files.
  207.  
  208.     If needed editor is not specified in icon tooltypes or settings file,
  209.     one of ENV:Editor, ENV:XEditor, ENV:xMore/Editor or ENV:xMore/XEditor
  210.     is tried instead.
  211.  
  212.     Note that you can't start editor if the data ca