home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / mac / source / macify13.shr / README < prev    next >
Text File  |  1991-05-20  |  4KB  |  88 lines
  1.  
  2.                                MACIFY v1.3
  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. released into the public domain
  9.  
  10. PURPOSE:
  11.  
  12.     I was getting sick and tired of getting corrupted ASCII downloads,
  13. using Zmodem.  White Knight has an odd way of downloading, no matter what
  14. protocol you're using (X, Y, or Zmodem).  I couldn't find a comparable
  15. program on the Macintosh that does UNIX newline -> Mac CR translations, so
  16. I wrote one for UNIX.  This will convert both from UNIX -> Mac and also
  17. Mac -> UNIX, so you can upload text from your machine as well.  If used in
  18. a shell script or a shell alias, this, combined with zmodem, can, in one
  19. fell swoop, convert and download files.
  20.  
  21. COMPILING:
  22.  
  23.     I wrote this in fairly standard C, so it should compile on even
  24. non-ANSI systems.  There are no system variables to change at all!  Just
  25. type "cc -O macify.c -o macify" and you're set.  If you don't want the
  26. output file stripped of debugging info, symbol table, etc. then eliminate
  27. the "-O" flag.  Of course, you'll get a larger codefile, but.. if you're
  28. one of those paranoid folk that think every program will coredump on them,
  29. then this is for you. :)
  30.  
  31.     You must edit the "Makefile", to set up things specific for your
  32. system, like what directory to install the binaries and man pages in,
  33. etc.  It is self-explanatory; just read the comments, and follow what
  34. they have to say.
  35.  
  36.     You must also edit "macify.c" and "convert.c".  The only line
  37. you'll probably have to change is the line that #include's the string
  38. handling header file.  It is currently set up for a SysV machine, which
  39. uses <string.h>.  If you are compiling on BSD, change this to <strings.h>.
  40. If you're compiling on another system (MsDos, Mac, etc.), find out what
  41. header file you use for strings, and substitute its name in the brackets.
  42.  
  43.     Then, all you have to do is type "make", and you're set!  The pro-
  44. gram will compile in the current directory; this is so that you can test
  45. it out to see if it works.  Once you're satisfied that it works, typing
  46. "make install" will move the binary and man page to the directories you
  47. specified.  Typing "make clean" will erase any extraneous files (.o files,
  48. etc.).
  49.  
  50. USAGE:
  51.  
  52.     Running the program with no arguments will print out how to use it.
  53. But here is how to use it anyways.
  54.  
  55. MACIFY (tm) v1.3, (c)1991 Donald Burr
  56. Usage: macify [um or mu] [inputfile or -] [outputfile or -]
  57.     um = UNIX -> Macintosh
  58.     mu = Macintosh -> UNIX
  59.     inputfile = file to convert FROM, - for stdin
  60.     outputfile = file to convert TO, - for stdout
  61.  
  62. MACIFY takes three arguments.
  63.  
  64.     The first is a switch -- it lets the program know whether you want
  65.     to do UNIX -> Mac, or Mac -> UNIX translation.  This is done by
  66.     giving it either "mu" (Mac -> UNIX), or "um" (UNIX -> Mac).
  67.  
  68.     The second argument is the filename you wish to use as INPUT.
  69.     It can be a file on disk, or if you supply "-" (a hyphen),
  70.     input will be taken from stdin.  This is helpful for rediretion.
  71.  
  72.     The third argument is the filename you wish to use as OUTPUT.
  73.     It can be a file on disk; if this file already exists, it will be
  74.     overwritten.  If you supply a hyphen (-), output will be sent
  75.     to stdout.  This is useful with redirection.
  76.  
  77. CONCLUSION:
  78.  
  79.     Well, that's about it.  I'm working on a port of this to Macintosh,
  80. so you can convert files on the Mac end.  This will probably be distributed
  81. with the next version.
  82.  
  83.     If you have any bug reports, suggestions, questions, etc. about this
  84. program, please contact me via one of the E-Mail addresses listed at the
  85. beginning of this document.
  86.  
  87.     Enjoy!
  88.