home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / x / volume19 / xbmbrowser / part01 / README < prev    next >
Encoding:
Text File  |  1993-04-28  |  3.1 KB  |  90 lines
  1. README file for xbmbrowser, By Ashley Roll                          Version 1.0
  2.  
  3. xbmbrowser is a program to let you easily manipulate Bitmap files.
  4.  
  5. This program has only been tested on Suns.
  6.  
  7. ******************************************************************************
  8. ** xbmbrowser is Public Domain. However it, and all the code still belong to me.
  9. ** I do, however grant permission for you to freely copy and distribute it on
  10. ** the condition that this and all other copyright notices remain unchanged in
  11. ** all distributions.
  12. **
  13. ** This software comes with NO warranty whatsoever. I therefore take no
  14. ** responsibility for any damages, losses or problems that the program may
  15. ** cause.
  16. ******************************************************************************
  17.  
  18. FILES:  README           - this file.
  19.         Imakefile
  20.         Makefile.std     - the standard make file.
  21.         xbmbrowser.c     \ 
  22.         xbmbrowser.h      -
  23.         callbacks.c      - the 'C' code.
  24.         misc.c          /
  25.         xbmbrowser.man    - a simple manual page.
  26.         xbmbrowser.help   - the help file that the program uses - see below.
  27.  
  28.  
  29. There are three things that you must setup for your site:
  30.  
  31. EDITOR constant:
  32. In the file 'xbmbrowser.h' you must set the name (and possibly the full path 
  33. if it is not in the normal path) of the bitmap editor you wish to use.
  34. The editor MUST accept the command line of:
  35.  
  36. bitmapeditor <bitmap file to edit>
  37.  
  38. where bitmapeditor is the editor you select and <bitmap file to edit>
  39. is a bitmap file name (passed to it by xbmbrowser)
  40.  
  41. NOTE: If you wish to pass arguments to the editor, then put them into this
  42.       define, and the filename will be appended to the end.
  43.  
  44. SETROOT constant:
  45. And also in the file 'xbmbrowser.h' you must set the name (and possibly the 
  46. full path if it is not in the normal path) of the program to set a bitmap 
  47. as the decoration for the root window. The default is 'xsetroot' and all
  48. the things that you can do to the EDITOR setting apply to this.
  49.  
  50. SETROOTINV constant:
  51. This is the name and options of the program to set a bitmap as the root window
  52. decoration inverted (colors inverted).
  53.  
  54.  
  55. If you put and empty set of quotes ("") for any of these variables, then the
  56. corresponding selection in the menu will be insensitive so it won't run. 
  57.  
  58. This is already setup to use 'bitmap' when it is in the path that the 
  59. program gets.
  60.  
  61. Installation:
  62.  
  63. With Imake:
  64.  
  65.    type:
  66.      xmkmf
  67.      make
  68.      make install
  69.      make instal.man
  70.  
  71. With normal make:
  72.  
  73.    type:
  74.      mv Makefile.std Makefile
  75.      make
  76.    then you will have to manually move the executable and man page to where
  77.    you want to put them.
  78.  
  79. For information on how to use xbmbrowser, look at xbmbrowser.help, or press the 
  80. [Help] button when it is running.
  81.  
  82. If you wish to change the program, then please feel free. However You must
  83. leave the copyright notices unchanged but add one detailing your changes, you
  84. should also not just increment the version number, but add something unique
  85. to it (like your name or something).
  86.  
  87. If you have any problems, then please feel free to drop me a line, my E-mail
  88. address (internet) is aroll@gucis.cit.gu.edu.au
  89.  
  90.