home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / os2 / list1_28.arj / LIST2.ASC < prev    next >
Text File  |  1994-04-19  |  7KB  |  170 lines
  1.                   LIST2 a freeware file viewer, Release 1.28.
  2.              Brought to you by John J.Allen a member of Team OS/2.
  3.  
  4.  Feature list release 1.28
  5.   ·    Case-sensitive/insensitive regular expression and plain text searches.
  6.   ·    Horizontal scrolling using CTRL key to jump 10 chars at a time.
  7.   ·    Page up & down.
  8.   ·    Go to top or bottom of file.
  9.   ·    Go to a specific line.
  10.   ·    Go to previous or next file.
  11.   ·    Load OS/2, MAC & Unix text files.
  12.   ·    Supports redirected stdin. (i.e. acts as a filter)
  13.   ·    Command help with ? or F1. (list2.hlp must be in same dir as list2.exe)
  14.   ·    Toggleable sound
  15.   ·    Toggleable tab expansion
  16.   ·    User configurable tab size
  17.   ·    Customisable colours
  18.   ·    Configuration saving
  19.   ·    NEW! Quick file select using keys 1 to 9
  20.   ·    NEW! DOS 16 & 32 bit versions
  21.   ·    NEW! Buffer selection list
  22.  
  23.  Future stuff
  24.   LIST2  is  still incomplete and further enhancements will be made  as  time
  25.   permits.  The following is a list of fairly immediate requirements  that  I
  26.   hope  to complete by the end of April or early May 94. These dates are only
  27.   hopefuls, I'm not making any commitments so don't depend on them.
  28.   
  29.   ·    File selection popup.
  30.   ·    Hex mode.
  31.   ·    Option to use standard OS/2 or DOS wildcards.
  32.   ·    Word wrap in text mode.
  33.  
  34.  Backgrounder
  35.   I  wrote LIST2 for OS/2 mainly because after looking at other shareware and
  36.   freeware  equivalents was left with a feeling that the  free  apps  were'nt
  37.   much  good  and the shareware stuff just was'nt worth what was being  asked
  38.   for  it.  I also wanted something that provided the features that  I  liked
  39.   from Vernon D. Beurgs LIST.COM for DOS.
  40.  
  41.  Additonal Backgrounder
  42.   Vernon  D. Beurg has a LIST for OS/2, however it is only a 16bit  app  with
  43.   no  long filename support and it is not as complete as DOS version  is.  At
  44.   this stage it is nearly three years old and I doubt we can expect to see  a
  45.   revamped  version for OS/2 2.x anytime soon. Even the DOS version  is  this
  46.   old.
  47.  
  48.  Justification
  49.   I  wanted  long filename support, regular expression text searches  and  so
  50.   on.  Now that I have looked at the OS/2 port of LIST I'm pretty sure  LIST2
  51.   has  a place in the OS/2 fileviewer world and may even have a place in  the
  52.   DOS world once I get around to porting using DJGPP. (now done)
  53.  
  54.  DOS Support (IBM, Novell, Microsoft)
  55.   There  is  now a DOS version of LIST2. There are both 16 & 32 bit versions.
  56.   The  DOS  16 bit version is compiled with Borland C++ 4.0 and only supports
  57.   loading  files up to 64k, anything greater and it bombs out. Unless  you've
  58.   got  a  286  or a 386 with limited memory I would not recommend  using  the
  59.   16bit version.
  60.   
  61.   The  32  bit version is compiled with DJ's GPP and uses his GO32  extender.
  62.   This  extender supports Unix style globbing which will defeat the  wildcard
  63.   expansion  in  LIST2.  To  control GO32's globbing  you  need  to  set  the
  64.   environment variable GO32. Set it to GO32=noglob to turn off globbing.
  65.   
  66.   In  accordance with the GNU General Public License agreement the  following
  67.   information  is provided to allow you access to the sources comprising  the
  68.   GO32 dos extender and gcc compiler for DOS.
  69.   
  70.   The   GO32  extender  (go32.exe)  is  available  for  anonymous  ftp   from
  71.   oak.oakland.edu in the directory /pub/msdos/djgpp, which is where I got  it
  72.   from.  This  FTP server allows a large number of anonymous  logins  and  is
  73.   quite    fast.    The   extender   and   sources   are    also    available
  74.   omnigate.clarkson.edu in the same directory.
  75.  
  76.  Video Mode support
  77.   LIST2  does  not have any built in mode switching abilities, but  will  use
  78.   whatever  text mode you happen to be in. Personally I prefer 34  line  mode
  79.   as  the text looks so much smoother. To change text mode just use the  OS/2
  80.   (or  DOS) mode command. (eg. mode co80,34). I may add the ability to switch
  81.   modes within LIST2 in a future release.
  82.  
  83.  Memory requirements
  84.   LIST2  loads  the currently viewed file into memory in it's  entireity  and
  85.   therefore  your  system will have to have enough available memory  to  load
  86.   the  largest file you wish to view. LIST2 only actually keeps one  file  in
  87.   memory  at a time and this can cause delays when jumping about between  two
  88.   or more large files.
  89.  
  90.  Using LIST2 as a filter
  91.   When  piping  or  redirecting from stdin LIST2 will  not  display  anything
  92.   until  the  input has closed. This means that when using LIST2  to  display
  93.   the  results of a long process you will not be able to see any output until
  94.   that  long  process has finished. I will endeavour to remove  this  in  the
  95.   next major release.
  96.  
  97.  Help
  98.   Help  is available by pressing ? or F1. The help is very basic and is  only
  99.   a list of keys and their functions.
  100.  
  101.  Configuration
  102.   LIST2  stores  the  configuration  options  into  LIST2.INI  in  the   same
  103.   directory  as  LIST2.EXE  is  run from. Use  CTRL+S  to  save  the  current
  104.   options. The LIST2.INI file is not shipped with the .ZIP file and  is  only
  105.   created  the  first time you save the configuration. Renaming  LIST2.*  You
  106.   can  rename  LIST2.EXE  to  anything  you  want  and  the  help  and  saved
  107.   configuration  will still work provided you rename LIST2.HLP and  LIST2.INI
  108.   also.(eg. ren LIST2.* L.*)
  109.  
  110.  Known Bugs
  111.     Id  Description                                 Release    OS's
  112.      1  Found text will not always scroll into      1.27+      ALL
  113.         view when TAB size is greater than 1. The
  114.         tab size is not being taken into account
  115.         when setting the left column position.
  116.  
  117.  Screwups
  118.   I  hope  you have many pleasant experiences using LIST2, but just  in  case
  119.   anything goes wrong follow these instructions.
  120.   
  121.   1.   Write down the register dump.
  122.   2.   Turn off all the lights.
  123.   3.   Press CTRL+ALT+DEL and head for the air-raid shelter.
  124.  
  125.  Copyright
  126.   LIST2  for  OS/2  2.x is copyright John J. Allen and is freeware,  i.e.  no
  127.   payment is required to use this software and no charge may be made  for  it
  128.   with the exception of a cover charge applied for any distribution media.
  129.  
  130.  Acknowledgements
  131.   D.J. Delorie for his excellent GO32 extender with virtual memory support.
  132.   J. Alan Eldrige & D. Buerssner for the gppconio library.
  133.   All the users who have mailed me with suggestions and really encouraged  me
  134.   to do so much so fast.
  135.   
  136.   Thanks.
  137.  
  138.  Disclaimer
  139.   This  software  is  provided as-is WITHOUT ANY WARRANTY  without  even  the
  140.   implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  141.   
  142.   The  author may not under any circumstances be held liable for any damages,
  143.   consequential or otherwise that may result from the use of this software.
  144.   
  145.   Aldus  Corporation are in no way connected with this software and  may  not
  146.   under  any  circumstances be held liable for any damages, consequential  or
  147.   otherwise that may result from the use of this software.
  148.  
  149.  Author info
  150.   Comments, bug reports etc... to john.allen@aldus.com
  151.   
  152.   Just  in  case  you're mad enough to send me money or if  you  can't  email
  153.   bugs/suggestions, my home address is given below.
  154.   
  155.   NOTE: Sending money by email is not recommended. {:-)
  156.   
  157.   John Allen,
  158.   121 Moyville,
  159.   Rathfarnham,
  160.   Dublin 16,
  161.   Ireland.
  162.   
  163.   
  164.   
  165.   
  166.   
  167.   
  168.   
  169.   
  170.