home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume26 / maint / part01 / README < prev    next >
Text File  |  1992-05-13  |  7KB  |  137 lines
  1. Last update:  01/24/90
  2.  
  3. INTRODUCTION
  4.    Maint is a full-screen file and directory maintenance program.  It will
  5. allow you to do all sorts of things to files and directories with just a few
  6. keystrokes.  It also makes it easier to scan a bunch of directories and sub-
  7. directories very quickly.  It has a number of different startup options for
  8. formatting the information on the screen and the a whole slew of commands
  9. that may be specified.
  10.  
  11.    I know the above paragraph seems a little sketchy but after you start using
  12. Maint, I think that you will find that it can be a very useful tool.  We have
  13. been using it for quite a while here and I have gotten a lot of positive feed-
  14. back on it, including many suggestions for improving it.
  15.  
  16.    I also realize that there are things like Open Window's filemgr and
  17. DECwindows user executive for managing files and directories.  They are
  18. both nice but I personally find maint to be much faster and easier to use
  19. when I'm dealing with *lots* of files and directories.  I'm sure that some
  20. people won't agree with this but hey it's a free country, right? :-)
  21.  
  22. DISTRIBUTION
  23.    The source code is included so feel free to redistribute it.  I don't
  24. mind as long as the copyright notice (COPYRIGHT) stays with it and you don't
  25. claim you wrote it or try to make money from it.
  26.  
  27. REQUIREMENTS
  28.    About the only thing that is really needed to build and run maint is a
  29. good version of curses.  System V comes with them by default.  ULTRIX docu-
  30. mentation calls theirs X/Open curses and you have to link with a different
  31. curses library.  I've also heard them called the Terminfo curses.  Basically,
  32. if your curses library has the keypad() routine, you have a pretty good chance
  33. of making maint work.  Maint depends on it and won't build without it.  Systems
  34. that I *know* maint will build and run on are:
  35.  
  36.     o ULTRIX (3.0 or higher; 2.X doesn't have keypad)
  37.  
  38.     o SunOS 3.X, 4.X - you must have the System V software installed
  39.       because needs the some header files and libraries that contain
  40.       the necessary curses stuff.  You can use gcc to compile as long
  41.       as you specify the right include directory and link with the
  42.       necessary SysV libraries.  Check the Makefile for details.
  43.  
  44.       If you're building on a 3.X system, you need to define -DSUNOS3;
  45.       it's in the Makefile.
  46.  
  47.     o System V Release 3
  48.  
  49.    I would like to say that maint will work on HP/UX, AIX, etc., but I
  50. can't because I don't have access to them.  If you make it work on a system
  51. not listed above, let me know what you had to do and I'll see what I can do
  52. about including your fixes in the next release.
  53.  
  54.    I'm also pretty anxious to get it ported to Xenix.  If anyone out there
  55. wants to take the time to port it and send me the diffs, I'll be more than
  56. happy to include them.
  57.  
  58. INSTALLATION
  59.   1.  Copy Makefile.dist to Makefile and copy maint.h.dist to maint.h.
  60.  
  61.   2.  Look at maint.h and change the #defines for MAX_SCREEN_ROWS and
  62.       MAX_SCREEN_COLS maximum number of rows/columns for the screens at
  63.       your site.  The default values are for terminals that are 24x80.  If
  64.       you use workstations with big windows, adjust them accordingly.  For
  65.       example, on a Sun 3/60 with a fullscreen window, 60 for MAX_SCREEN_ROWS
  66.       and 140 for MAX_SCREEN_COLS is nice.  Making them larger than what
  67.       you need won't cause any problems but might make the executable a
  68.       little bigger.
  69.  
  70.       Other things that you might want to change in maint.h:
  71.  
  72.       - DEFAULT_PAGER - the default is more; make it whatever you want
  73.       - DEFAULT_EDITOR - default is vi
  74.       - DEFAULT_SHELL - default is csh
  75.  
  76.   3.  Look at Makefile and pick what CC, LIBS, and CFLAGS should be used for
  77.       your site.  Also, set the BINDIR, BINMODE, etc., if you want to use
  78.       the Makefile to install maint for you.  Make sure to add -DSUNOS3
  79.       to the CFLAGS definition if you're building on a Sun and you are
  80.       running SunOS 3.X; this turns on a few typedefs that maint needs.
  81.  
  82.   4.  Type "make" to build maint.
  83.  
  84.   5.  Type "make install" if you feel like it.
  85.  
  86.   6.  That's it.....
  87.  
  88. If you have problems building/installing maint, feel free to call me or send
  89. me some e-mail and let me know how I blew it.  I'll do what I can to make sure
  90. that maint can be installed at your site.
  91.  
  92. HACKING ON THE CODE
  93.    Since the source is distributed, feel free to hack on the code.  There is
  94. nothing that is real complicated in maint; the code itself is pretty straight-
  95. forward (at least I think so! :^).  You might want to look at the comments at
  96. the top of main.c to get an idea about some of the data structures.
  97.  
  98.    If you find a bug, you can either 1) fix it yourself, contact me, and
  99. send me the fix, or 2) let me know about it and I'll see what I can do.  I'll
  100. be sending out patches when appropriate.
  101.  
  102. THANKS
  103.    To Dory Leifer and Mark Knopper @ Merit for letting me borrow a System V
  104. machine for testing and to Dan Bidwell @ Andrews University for doing the
  105. final System V testing.  Also to Steve Simmons at ITI for his suggestions and
  106. code improvements.
  107.  
  108. CONCLUSION
  109.    I put a lot of work into maint and I would appreciate any comments/
  110. suggestions/flames that you might have.  If you get maint up and running, I
  111. would appreciate it if you would either send me e-mail or phone me, letting
  112. me know that you installed maint and what your thoughts are about it.
  113.  
  114.    Also, if you port maint to a machine that wasn't listed above and you'd
  115. like the changes encorporated in the next release, send me e-mail describing
  116. what you did.  *DON'T* just send me the diffs.  First describe what you had
  117. to do and THEN send me the diffs.  I get a lot of mail and it is very easy
  118. for me delete the diffs by accident but if I know they're coming, I'll be
  119. especially careful.
  120.  
  121.    There are a lot of things that I have planned but I haven't implemented
  122. them yet because I felt like maint was suffering from what someone once called
  123. "creeping featurism."  Thus, if I waited until I had every possible option
  124. and nicety installed it would be quite a while before I could unleash this
  125. on the world.  I feel that in it's current state that it can be quite helpful.
  126. If you have a suggestion feel free to send me e-mail.
  127.  
  128. While I'm sure maint doesn't do everything that everyone could ever want,
  129. I still feel that you will find it useful.  At any rate, I use it quite a
  130. bit, even if no one else does. :-)
  131.  
  132. --
  133. Leonard J. Peirce               Internet:  peirce@mickey.acs.wmich.edu
  134. Western Michigan University                peirce@gw.wmich.edu
  135. Academic Computing Services
  136. Kalamazoo, MI  49008            Voice:     (616) 387-5469
  137.