home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / mac / unix / textmstr.shr / README < prev    next >
Text File  |  1991-06-26  |  5KB  |  96 lines
  1.  
  2.                           TextMaster -- Version 1.4
  3.  
  4. By: Donald Burr
  5.     INTERNET: dburr@ocf.berkeley.edu, 72540.3071@compuserve.COM
  6.     Compu$erve: 72540,3071         America Online: DonaldBurr
  7.  
  8. This is version 1.4 of TextMaster, a UNIX- and Macintosh-end program to
  9. convert text file formats between UNIX and Macintosh.
  10.  
  11. This release fixes a MAJOR bug in the Macintosh end.  The Mac end will now
  12. correctly convert files from Mac -> UNIX.
  13.  
  14. TextMaster will convert between UNIX newlines and Macintosh end-of-line
  15. characters.  The direction of conversion can be specified at the command
  16. line, and thus files can be converted in any direction.
  17.  
  18. This is useful if your UNIX -> Mac downloads, or uploads, of text files
  19. are failing miserably.  White Knight has a tendency to do this, and other
  20. comm programs may as well.
  21.  
  22. Please send all comments, bug reports, feature requests, etc. to the
  23. Internet address listed above.
  24.  
  25. This software is being donated to the public domain.  Permission is hereby
  26. granted to freely copy and distribute this source code, as long as no fees
  27. are charged for such duplication.  Permission is also granted to modify
  28. this source code at will, providing that you insert a notice in the dist-
  29. ribution that this source is NOT the original TextMaster source, and that you
  30. not remove my name from the program and accompanying documentation.
  31.  
  32. WHAT IS TEXTMASTER?
  33.  
  34.     It is a utility I hacked together to convert between Macintosh end-
  35. of line characters, and UNIX newlines.  I downloaded a mess of text files
  36. one day to my Mac, and found they all came out on one line, with weird char-
  37. acters (represented by "boxes") between where "line breaks" should have been.
  38. Since I really couldn't download those files again, I decided to write a
  39. utility to help me convert and salvage them.  Thus was born TextMaster, which
  40. was released (up to version 1.3) as "Macify".  Since then, I have found out
  41. that there already is a product called Macify, so in this release, I change
  42. the name to TextMaster.  Nuff said.
  43.  
  44. HOW TO COMPILE IT
  45.  
  46.     First, edit the Makefile.  It is fully commented, and should be
  47. self-explanatory.
  48.  
  49.     Next, edit "tm.h".  The first segment of this file is to set up what
  50. #include file your system uses for string functions.  On SysV, this typically
  51. is <string.h>.  However, if you're on a BSD system, this typically is
  52. <strings.h>.  If you are on MSDOS, Mac, or some other platform, find out
  53. what #include file your string routines are in, or if there is NO include
  54. for string functions, and edit this accordingly.
  55.  
  56.     Next, check over the definitions for characters for EOL's.  These
  57. should remain constant, but just check them over just in case.
  58.  
  59.     Now, simply typing "make" will compile an executable in the current
  60. directory.  Test it out some, and if it seems to work, type "make install",
  61. and a copy of the binary and man pages will be placed in the appropriate
  62. places.
  63.  
  64. USAGE
  65.  
  66.     The man page explains how to use the program, as does the screen
  67. that appears when invoking TextMaster without any arguments.  There isn't
  68. any space here in the README to fully describe it.
  69.  
  70. LAST WORDS
  71.  
  72.     Certainly hope you enjoy this program.  It took a bit of work, es-
  73. pecially the Mac portion of it, but I find it useful.
  74.  
  75.     I am charging no shareware fee or anything for this.  It's free.
  76. Take it, use it in good health.  Modify it at will.  However, when modify-
  77. ing the program, leave the version number intact; just tack on your own
  78. version number after mine.  Example, if the version # of TextMaster is 1.4,
  79. and your name is Bill Smith, and this is the second revision to my code
  80. you have done, change the version number to something like "1.4/BS-2",
  81. the "BS" symbolizing this is Bill Smith's version, and the '2' signifying
  82. this is Bill Smith's 2nd version.  Now you can redistribute the program;
  83. this way, we can keep track of which is the "genuine" version, and so
  84. forth.
  85.  
  86.     Two things I ask if you redistribute this work are, (a) my credit
  87. (name, copyright, etc.) MUST remain in all documentation and program
  88. displays, and (b) You not charge for distribution or shareware fees.
  89.  
  90.     Please email me with all bug reports, suggestions for changes, and
  91. so on.  Better yet, if you have a suggestion for a change or a bug fix or
  92. whatnot, and you can program in C, make the patch yourself, and mail me a
  93. copy of the resultant source code.  If it's good, and I like it, I'll be
  94. sure to include it in my next version, with your name in the credits!  My
  95. email addresses can be found at the beginning of this document.
  96.