treese@CRL.DEC.COM (Win Treese) (04/02/90)
Archive-name: xdir/v1.2
Original-posting-by: treese@CRL.DEC.COM (Win Treese)
Original-subject: Xdir version 1.2 now available
Archive-site: crl.dec.com [192.58.206.2]
Archive-directory: pub/X11/contrib
Archive-files: xdir.tar.Z
Reposted-by: emv@math.lsa.umich.edu (Edward Vielmetti)
Xdir version 1.2 is now available for anonymous FTP from crl.dec.com in
pub/X11/contrib/xdir.tar.Z.
Xdir is a toy directory browser written as an exercise in learning about
the Athena widget set.
The README file and the manual page are enclosed below.
It will be available in the contrib directory on expo when it becomes
reachable again.
Win Treese Cambridge Research Lab
treese@crl.dec.com Digital Equipment Corp.
README
------
This is Xdir, a simple X-based directory browser. It was written as an
exercise in learning to work with the Athena widget set and the X toolkit.
Comments and suggestions for future versions are welcome.
At this time, it has been built and tested on DECstations and VAX systems
running Ultrix 3.1 with MIT X11 Release 4. It should be straightforward to
build and run on any BSD-based system with X11R4, and I have tried to keep
it vanilla enough to easily port to System V. I would appreciate being sent
a copy of any changes necessary to port to other systems, although X11R4
will still be a requirement.
INSTALLATION
If possible, use the Imakefile provided. A sample Makefile full of
incorrect pathnames is provided in case it is necessary. The binary and
manual page can be installed anywhere. The application defaults file
(Xdir.ad) should be installed in the system-wide application defaults file,
or somewhere where Xdir can find it -- it doesn't gracefully handle not
having its defaults now. The help files are typically installed in
$LIBDIR/xdir, where LIBDIR is wherever the other X library files are
(typically /usr/lib/X11).
Send comments, suggestions, and bug reports to:
Win Treese
Cambridge Research Lab
Digital Equipment Corp.
treese@crl.dec.com
Happy hacking!
---------------------------------------------------------------
NAME
xdir - X Directory Browser
SYNOPSIS
xdir [-toolkitoption ...]
DESCRIPTION
Xdir is a simple directory browser for perusing the UNIX
file system. It provides an easy way to look at files and
directories in the system.
When Xdir starts, it displays a listing of the files in the
current directory. The user can select a file by pointing
at it with the mouse and clicking the left mouse button.
Once selected, a file may be viewed (in a separate window)
by selecting the View File item from the File menu. If the
file is a directory, its contents may be listed (in the same
window) by selecting the Change Directory item from the File
menu. Alternatively, a file or directory may be browsed by
clicking twice on its name in the current directory.
Help is available by clicking on the Help button in the top
row of the Xdir display.
FILE MENU
The File menu contains the following items:
View File View the selected file.
Change Directory
Changes to the selected directory.
Parent Directory
Changes to the parent directory. Alterna-
tively, the right mouse button can be used as
a short-cut for this.
About Xdir Displays a brief message about the program.
Quit Exits Xdir.
OPTIONS MENU
The options menu allows the user to customize parts of
Xdir's display. There are two options available:
Hide/Show Dot Files
Hide or show files beginning with a dot
('.'). The default is selectable by a
resource (see below).
Hide/Show Backup Files
Hide or show files ending with a tilde ('~').
The default is selectable by a resource (see
below).
COMMAND LINE OPTIONS
Xdir supports all standard X Toolkit command line arguments
(see X(1)). No additional arguments are supported.
WIDGETS
In order to specify resources, it is useful to know the
hierarchy of the widgets which compose Xdir. In the nota-
tion below, indentation indicates hierarchical structure.
The widget class name is given first, followed by the widget
instance name.
Xdir xdir (This widget is never used)
Paned pane
Label dirname
Box box
SimpleMenu fileMenu
SmeBSB view
SmeBSB chdir
SmeBSB parentdir
SmeBSB about
SmeBSB update
SmeBSB quit
SimpleMenu configMenu
SmeBSB dotfiles
SmeBSB backupfiles
Viewport vport
List list
TopLevelShell TextShell
Paned text-pane
Label textname
Text ViewText
Box text-box
Command close
Command help
TopLevelShell HelpShell
Paned pane
Label helplabel
Text text
Box box
Command close
TransientShell ErrorShell
Dialog ErrorDialog
Command close
APPLICATION RESOURCES
xdir has the following application-specific resources which
allow customizations unique to xdir.
libDir (Class File)
Directory used to hold auxiliary files
(normally /usr/lib/X11/xdir).
helpFile (Class File)
Name of file containing help information
(relative to libDir).
viewhelpFile (Class File)
Name of file containing help information
for viewing window (relative to libDir).
aboutFile (Class File) Name of file
describing xdir (relative to libDir).
showDotFilesMsg (Class String)
Menu label used to indicate option to show
dot files.
hideDotFilesMsg (Class String)
Menu label used to indicate option to hide
dot files.
showBackupFilesMsg (Class String)
Menu label used to indicate option to show
backup files (i.e., those ending in '~').
hideBackupFilesMsg (Class String)
Menu label used to indicate option to hide
backup files.
showDotFiles (Class Boolean)
Whether or not to show dot files ini-
tially.
showBackupFiles (Class Boolean)
Whether or not to show backup files ini-
tially.
FILES
/usr/lib/X11/app-defaults/Xdir
specifies required resources.
/usr/lib/X11/xdir
contains various auxiliary files, including the help
files. The location may vary from site to site; it may
be changed using a resource (see above).
SEE ALSO
X(1), ls(1)
ENVIRONMENT
DISPLAY the default host and display to use.
XENVIRONMENT to get the name of a resource file that over-
rides the global resources stored in the
RESOURCE_MANAGER property.
XAPPLRESDIR A string that will have "Xdir" appended to
it. This string will be the full path name
of a user application defaults file to be
merged into the resource database after the
system application defaults file, and before
the resources that are attached to the
display.
BUGS
Probably. In particular, Xdir does not gracefully handle
not having its resource file available.
COPYRIGHT
Copyright 1990 by Digital Equipment Corp.
See X(1) for a full statement of rights and permissions.
AUTHOR
Win Treese, Cambridge Research Lab, Digital Equipment Corp.
QUESTIONS, COMMENTS, AND COMPLAINTS
treese@crl.dec.com