home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / telix / t310sort.arc / TLXSORT.DOC < prev    next >
Text File  |  1988-10-19  |  3KB  |  80 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.           TlxSort v1.1 by Paul Roub
  8.           Sort Telix v3.0-3.1 phone directories
  9.  
  10.           This program  and its sources are Copyright (C) 1988 by Paul Roub and
  11.           may not be sold for profit without the express written consent of the
  12.           author.  Redistribute them (in their entirety) as you wish,  provided
  13.           no fee is charged and all materials are present and unmodified.
  14.  
  15.           O.K.,  enough legal crap.  By the way,  I didn't write ALL  of this -
  16.           the  header   formats  are   copied  verbatim  from  the  description
  17.           distributed by Exis,  makers of  Telix.   Thanks for  circulating it,
  18.           Colin.
  19.  
  20.           If you  find bugs in the source,  or ideas for improvements (of which
  21.           I have a few),  let me know.  If you find  the program  really useful
  22.           and otherwise  wonderful for some reason,  a $5 contribution wouldn't
  23.           hurt anyone.  Not that I'll  starve  without  it,    but  you'll feel
  24.           better  <grin>,    and  I  can  continue  my valiant effort to pay my
  25.           MasterCard bill.
  26.  
  27.           TlxSort sorts Telix v3.0-3.1  phone  directories  (currently  by name
  28.           only).    Note  that  leading  blanks  and/or  the  word 'the' at the
  29.           beginning of  an entry  name will  be ignored,   and  blank or 'null'
  30.           entries will be put at the end.  The simplest syntax is:
  31.  
  32.                tlxsort
  33.  
  34.           which will  sort TELIX.FON,   and  write the  sorted directory to the
  35.           same file.  Up to three parameters may be given,  which are:
  36.  
  37.                tlxsort [-d] [input file name] [output file name]
  38.  
  39.           If both file names are given,  the first is used as  the name  of the
  40.           input file,   and  the second is used as the name of the output file.
  41.           If only one is  given,   it is  the input  file and  TELIX.FON is the
  42.           output file.
  43.  
  44.           The  '-d'  switch  tells  TlxSort  to eliminate null entries (entries
  45.           whose 'BBS name' fields  are  all  blank-filled  or  empty)  from the
  46.           output file.
  47.  
  48.           Note  that  the  source  is  included  for your viewing pleasure.  As
  49.           before,  I only ask that you send bug fixes or comments to me.   It's
  50.           written for  Microsoft C  5.0+ or Quick C.  The pack() #pragma should
  51.           be the only  big  portability  problem  --  it  makes  sure  that the
  52.           compiler doesn't  pad structure  definitions with filler bytes.  That
  53.           is to say,  a structure with,  say,  3 characters and an integer will
  54.           take up  PRECISELY 5  bytes   --  by default,  MSC will pad things so
  55.           that integers appear at even addresses.  If compiler doesn't do this,
  56.           you can just delete the #pragmas.
  57.  
  58.           Under Microsoft C,  just say:
  59.  
  60.                cl -Ox -AC tlxsort.c read_fon.c writefon.c misc.c
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.           or for Quick C
  68.  
  69.                qcl -Ox -AC tlxsort.c read_fon.c writefon.c misc.c
  70.  
  71.           contributions should be sent to:
  72.  
  73.                Paul Roub
  74.                690 Anderson Court
  75.                Satellite Beach, FL  32937
  76.  
  77.           I can also be reached through the FidoNet TELIX echo,  or by
  78.           NetMail to me at 1:135/47.
  79.  
  80.