README
1 __ ___ ____
2 \ \/ / |__ _ __ ___ | __ ) _ __ _____ _____ ___ _ __
3 \ /| '_ \| '_ ` _ \| _ \| '__/ _ \ \ /\ / / __|/ _ \ '__|
4 / \| |_) | | | | | | |_) | | | (_) \ V V /\__ \ __/ |
5 /_/\_\_.__/|_| |_| |_|____/|_| \___/ \_/\_/ |___/\___|_|
6 __ __ _ ___ _
7 \ \ / /__ _ _ __(_)___ _ _ | __| / |
8 \ V / -_) '_(_-< / _ \ ' \ |__ \_| |
9 \_/\___|_| /__/_\___/_||_| |___(_)_|
10
11
12XbmBrowser (version 5.1)
13 A program to allow the user to view a complete directory of X bitmaps
14and X pixmaps all in one go, and to perform user defined actions on
15these images. If you don't think this is usful, you have never dealt with
16a directory of small icon images.
17
18 Copyright Ashley Roll and Anthony Thyssen
19
20Original Program: Ashley Roll ash@cit.gu.edu.au upto version 3.2
21Current Programmer: Anthony Thyssen anthony@cit.gu.edu.au version 4.0 on
22
23This program while available in the X windows Contrib Area, still belongs
24to the programmers. Permission is however given for you to freely copy,
25distribute and modify it on the condition that this and all other
26copyright notices remain unchanged in all distributions. Modifications
27should be forwarded to the Current Programmer (anthony) for inclusion into
28the next release.
29
30This software comes with NO warranty whatsoever and no responsibility for
31any damages, losses or problems that the program may cause will be taken.
32
33Please also send any interesting user menu additions you come up with to
34the current programmer :-
35
36 Anthony Thyssen <anthony@cit.gu.edu.au>
37 http://www.cit.gu.edu.au/~anthony/anthony.html
38 http://www.cit.gu.edu.au/~anthony/
39
40-------------------------------------------------------------------------------
41
42WHERE TO GET IT
43
44 XbmBrowser
45 ftp.x.org /contrib/utilities/xbmbrowser5.1.tar.gz
46 archie.au /X11/R6/contrib/utilities/xbmbrowser5.1.tar.gz
47
48and all the X archive mirrors. You may also like to get and install the
49package before tring to build this program so that it can read and display
50Xpixmap files too.
51
52 XPM (X Pixmap Library) Coordinator: Arnaud Lehors <lehors@x.org>
53 ftp.x.org /contrib/libraries/xpm-3.4f.tar.gz
54
55
56DISTRIBUTED FILES
57
58 Documentation
59 README - You are reading it!
60 Changes - History of changes made to xbmbrowser
61 OtherUses - Other Uses people have used xbmbrowser for!
62 xbmbrowser.man - Online manual for xbmbrowser
63
64 Sources
65 Imakefile - imake file
66 Makefile.std - the standard make file.
67 patchlevel.h - the current patchlevel.
68 xbmbrowser.h \
69 xbmbrowser.c |
70 callbacks.c |
71 user_menu.c > the 'C' source for xbmbrowser.
72 user_functs.c |
73 images.c |
74 misc.c /
75 IconLabel.c \
76 IconLabel.h > IconLabel Widget -- shaped icons with label
77 IconLabelP.h /
78
79 Images
80 icon.xbm - default icon -- resource `pixmap' can override.
81 tickbox_on.xbm \_ menu option tick boxes
82 tickbox_off.xbm /
83 filesyms/ - directory of file symbols for non-icon files
84 test_icons/ - directory of icons used for testing purposes
85
86 Menus & Application Defaults
87 XbmBrowser-color.ad.sed - application defaults source file
88 xbmbrowser.menu.sed - The default user menu file (source).
89 xbmbrowser.menu.tut.sed - Default User menu with comments and suggestions
90 xbmbrowserrc.anthonys - My own personal RC file (using AIcons scripts)
91
92 Support Scripts
93 xbm-cmd \_ Scripts to filter bitmaps and pixmaps
94 xbm-resize / using the pbmplus filters in your path
95
96 You can download more such support from Anthony's Icon Library
97 http://www.cit.gu.edu.edu/~anthony/icons/support/
98
99
100DEFAULT AND PERSONAL USER MENUS.
101
102 The man page and the file "xbmbrowser.menu.tut" contains information on
103the syntax of the new user menu configuration file format. NOTE: The
104Default user menus assume that PbmPlus is available on the users path.
105
106 You can change the default location at which the program expects to find
107the default user menu file, either via an appropriate resource setting, or
108through the hardcorded resource default in the "Imakefile" or
109"xbmbrowser.h". The default setting is to place the global menu
110configuration into normal X11 library directory for your system.
111
112 A personal menu configuration file can be defined by the user, in the
113file ".xbmbrowserrc" in the users home directory. I suggest that users
114copy the global library file to thier personal rc file, and then make
115changes as required. I myself use a file very simular rc file to the
116default global file provided, but using various shell scripts to do
117complexe tasks, and with all the rescan()'s removed as I prefer to use the
118main button when I want to do a rescan.
119
120
121SUPERUSER INSTALLATION
122
123 With Imake execute:
124 xmkmf
125 make
126 make install
127 make install.man
128
129 With normal make execute:
130 Edit xbmbrowser.h or the resource file XbmBrowser.ad to suit your
131 machines setup.
132 cp Makefile.std Makefile
133 make
134 then manually install the xbmbrowser, support scripts, manual, and
135 the default user menu, as you require.
136
137
138USER INSTALLATION
139
140 So Xbmbrowser works correctly your will have to tell it where it can
141 find its Menu Defaults. This can be done in a number of ways. Only one
142 of these methods is required but you can do any and any as desired.
143
144 Before Making --
145 * Edit the Imakefile to specify the directory to find the default
146 library menus.
147 After Makeing --
148 * Specify in the XbmBrowser resources where to find the library
149 file.
150 * Copy the "xbmbrowser.menu" file into your home directory as
151 ".xbmbrowserrc". If xbmbrowser finds this it will use it instead
152 of the library default menus.
153
154 I think the last method is the easiest as it does not change the executable.
155 Thus if and when xbmbrowser can be installed in the normal X directories
156 You do not need to rebuild the executable.
157
158 Build the "xbmbrowser" executable using ``xmkmf; make;'' commands.
159 But DO NOT run the "make install" or ``make install.man'' commands.
160
161 Install the XbmBrowser resource (.ad) files into your personal
162 application resources directory (renaming without the .ad on the end).
163 This directory is pointed to with the Environment variable XAPPRESDIR.
164
165 If this variable is not set then it defaults to your home directory,
166 or install the resources into your .Xdefaults or other resource files.
167 For more information on resources look at the following WWW document.
168
169 http://www.cit.gu.edu.au/~anthony/info/X/hints.Resources
170
171 That file is in my ``Tower of Computational Sorcery'' which is part
172 of a my ``Medievil Castle Home Page''
173
174 http://www.cit.gu.edu.au/~anthony/
175
176PROBLEMS
177
178Ultrix Machines (Decstations)
179 A number of memory faults seems to occur. Both in user menu
180 configuration and also in the X Pixmap library. The solution that works
181 is to recompile both xbmbrowser AND the X Pixmap library with gcc.
182
183 NOTE: to compile Xpm with gcc, your must set the following Imakefile
184 define in the Xpm libraries sub-directory's Imakefile. Or better still
185 add it to the /usr/lib/X11/config/Imake.tmpl file with.
186
187 #define LibraryCcCmd gcc
188
189 Noramlly these X Pixmap errors are of no concern to most applications.
190 They seem to only happen when a xpm is being freed, either by a call
191 from the client program or because the xpm file is invalid. Most
192 programs using the Xpm library never free X pixmaps or try to referance
193 non-pixmap files.
194
195 Xbmbrowser does both and as such has discovered many faults in the
196 X Pixmap Library which has since been corrected.
197
198Linix (PC Unix)
199 Linix machine have the same problems with the pixmap library. In this
200 case however the problem seems to do with the Xpm library 3.3,
201 distributed with the linux system. Users can get a replacement copy of
202 the Xpm library from the linux archive...
203
204 sunsite.unc.edu:/pub/Linux/libs/X/libXpm-????.tar.gz
205
206 Place in the /usr/X11/lib directory with the old library and recompile
207 xbmbrowser.
208
209
210BETA TESTERS
211
212 The following people returned bugs and suggestions for this release
213of xbmbrowser. Many thanks to all of them.
214
215 Steve Kinzler <kinzler@cs.indiana.edu> :Recursive Directory Tests
216 Shane Watts <swatts@me.gu.edu.au> :Linix PC
217 Thomas Cooke <cooke@newice.stortek.com> :Zero Width/Heigth Xpm Bug
218 Bjorn P. Brox <brox@corena.no> :Stupid Memory Faults
219 Jan Sandquist <etxquist@iqa.ericsson.se>
220 Detlef Schmier <detlef@mfr.dec.com> :Simple fix to "None" colors
221 Brian Dowling <bdowling@ccs.neu.edu> :Dec Ultrix -- symlinks
222 Robert Paulus <rbg.informatik.th-darmstadt.de> :HP9000/400
223 Richard Lloyd <R.K.Lloyd@csc.liv.ac.uk> :HP-UX -- Imake changes
224 Bob Friesenhahn <bfriesen@iphase.com> :Solaris -- Memory Faults
225 Heiko Schroeder <heiko@pool.informatik.rwth-aachen.de> :List widget bug
226 John Polstra <jdp@polstra.com> :SVR4 symlinks
227 Amir J. Katz <winter@datasrv.co.il> :Double Click Fault
228 Steven Chaplin <S.F.Chaplin@uel.ac.uk> :Imake problem on linux
229 Reinhard Sy <rsy@gras.de> :Sony -- include file
230 Paul Provost <paulp@buzzimage.com> :README Correction
231 Michael Weller <eowmob@exp-math.uni-essen.de> :making global menu global!
232 Michael Meissner<meissner@cygnus.com> :new sub var %D
233 Jim Spath <jspath@mail.bcpl.lib.md.us> :NetBSD changes
234 Peter Klingebiel <klin@mlap-bb.uni-paderborn.de> :MIPs changes
235
236