home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / sun / volume1 / lpqtool / README < prev   
Encoding:
Text File  |  1989-07-20  |  3.5 KB  |  78 lines
  1. /************************************************************************/
  2. /*    Copyright 1988 by Chuck Musciano and Harris Corporation        */
  3. /*                                    */
  4. /*    Permission to use, copy, modify, and distribute this software    */
  5. /*    and its documentation for any purpose and without fee is    */
  6. /*    hereby granted, provided that the above copyright notice    */
  7. /*    appear in all copies and that both that copyright notice and    */
  8. /*    this permission notice appear in supporting documentation, and    */
  9. /*    that the name of Chuck Musciano and Harris Corporation not be    */
  10. /*    used in advertising or publicity pertaining to distribution    */
  11. /*    of the software without specific, written prior permission.    */
  12. /*    Chuck Musciano and Harris Corporation make no representations    */
  13. /*    about the suitability of this software for any purpose.  It is    */
  14. /*    provided "as is" without express or implied warranty.        */
  15. /************************************************************************/
  16.  
  17.  
  18.      Lpqtool is a windowed version of lpq.  It will periodically poll the
  19. print queue (using lpq) and display the results in a little window.  You can
  20. adjust the polling rate to suit yourself.  Lpqtool has two rates: one for an 
  21. active queue (with jobs in it) and another for an idle (empty) queue.  
  22. Normally, it polls an active queue more rapidly than an idle queue, to deliver 
  23. up to the minute information about the state of the queue.  Lpqtool can also
  24. be configured (via command line options) to close when the queue is idle,
  25. and pop open when it becomes active.  This is handy, because you can pop it
  26. open when you submit a job, and it will watch the queue until it becomes
  27. empty, and then it will go away.  See the man page for all the details.
  28.  
  29.      Installing lpqtool is easy.  You'll need to check the Makefile and
  30. lpqtool.c to make sure some pathnames and such are correct.  These items
  31. are:
  32.  
  33.     In Makefile:
  34.         BINDIR        Where the executable will go, normally
  35.                 /usr/local/bin
  36.         MANDIR        Where the man page will go, normally
  37.                 /usr/man/manl
  38.         MANEXT        The man page extension, usually 'l',
  39.                 for local man pages.  You may want to
  40.                 make MANDIR /usr/man/man1, in which case
  41.                 MANEXT should be '1'.
  42.  
  43.     In lpqtool.c
  44.         LPQ        The full pathname of the lpq command on
  45.                 your system.  Normally, this is
  46.                 /usr/ucb/lpq.  You may have it in a 
  47.                 different place, or might use a different
  48.                 queue display command.  Be warned: lpqtool
  49.                 depends on the format of the output of lpq,
  50.                 so other commands may not work right.
  51.         ICON_PATH    Where the laserwriter icon can be found.
  52.                 Normally, it is in the directory that you
  53.                 created lpqtool in, but you might want to move
  54.                 it to a more global place.  We keep all our
  55.                 icons in /usr/local/images, for example.
  56.                 Fix this path to match where you put the icon.
  57.         NORMAL_FONT
  58.         BOLD_FONT    Point to the fonts used by lpqtool, which should
  59.                 be in the standard Sun font place,
  60.                 /usr/lib/fonts/fixedwidthfonts.  If you have moved
  61.                 them, fix up these paths.  You should always use
  62.                 screen.r.14 and screen.b.14, since lpqtool depends
  63.                 on the font widths to make its windows look good.
  64.  
  65. Everything else is system independent.  Just type "make lpqtool" or "make install"
  66. and give it a whirl!
  67.  
  68.      Comments, bugs, to me, please.  I would be very interested in your impressions
  69. of lpqtool and any suggestions you might have to make it better.  By the way,
  70. there are a few convenient untility routines in misc.c you might find useful in
  71. other programs you are writing.
  72.  
  73. Chuck Musciano
  74. Advanced Technology Department
  75. Harris Corporation
  76. (407) 727-6131
  77. ARPA: chuck@trantor.harris-atd.com
  78.