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