FILES for Greg J. Badros's Desktop Configuration Contest Entry
--------------------------------------------------------------
Updated 6/11/96


FILES
- this file

DESKTOP
- A description of the applications show in ../Greg.Badros.0.gif

README
- general information

.xinitrc
- Sample .xinitrc stressing the need for an environment before
  starting fvwm, gives example start lines, loads .Xdefaults.

.xsession
- Symlink to .xinitrc, in case it gets run instead of .xinitrc

.Xdefaults
- X Resources.  Should be read in by .xinitrc using xrdb. Gets pre-processed
  with cpp, per normal xrdb execution, eg.
         xrdb -merge .Xdefaults

.Xdefaults-fvwm-defines
- Contains #define's for the .Xdefaults file.  This should get edited
  along with .fvwm2rc.defines

.zshrc.m4
- Main zsh configuration, used to create .zshrc by makezshrc.  It includes
  .aliases, .zshrc-compctl, .zshrc-zle, .zshrc, below.

.aliases
- Alias definitions for zsh.  Gets m4-included by .zshrc.m4

.zshrc-compctl
- ZShell completion control commands, including rpm support.  Gets
  m4-included by .zshrc.m4.  Try typing "rpm -" then hit [TAB] using
  my zshrc configuration (does not require my zsh patch).

.zshrc-zle
- ZShell Line Editor commands.  Works in conjunction with .Xdefaults
  to give some improved line editing.  Ctrl-Left, Ctrl-Right move word
  left, right, etc.  Gets m4-included by .zshrc.m4

.zshrc
- The output of makezshrc-- just the postprocessed output of zshrc.m4.  It
  is imperative that .zshrc get parsed quickly since it gets read for every
  interactive shell

makezshrc
- A simple script to run m4 on .zshrc.m4 and remove comments before saving
  the output in .zshrc, to be read at startup by zsh

Sample.Xmodmap
- The Xmodmap I use with my Gateway AnyKey keyboard.  My emacs configuration
  is nicer if you've got an Alt_L modifier key-- I use the "*" key on the
  bottom left, between Ctrl and the key labelled "Alt", which is my Meta key.

.fvwm2rc.m4
- The m4 source for .fvwm2rc.  Gets run by .xinitrc using FvwmM4 module.
  See .xinitrc.  It includes all the other .fvwm2rc.* files, below.
  Note that this is unlike .zshrc.m4 in that it gets parsed everytime by
  FvwmM4, while .zshrc should get updated by a makefile or by hand whenever
  .zshrc-* or .aliases gets updated.

.fvwm2rc.buttondefs
- Various button definitions (just the graphics)

.fvwm2rc.buttons
- The button decoration bindings for title bars.

.fvwm2rc.defines
- The user-configurable file for this fvwm configuration.  Users not familiar
  with m4 should probably only edit this file (carefully), or become 
  familiar with m4.

.fvwm2rc.forms
- Various forms for use by the FvwmForm module

.fvwm2rc.functions
- Various complex FVWM functions.

.fvwm2rc.hostmenus
- Provides for the construction of the host menus.

.fvwm2rc.init
- This is where the stuff done at startup and restart times gets executed.
  Users can edit this file, too.

.fvwm2rc.keys
- The keybindings to actions.

.fvwm2rc.menus
- Provides for the construction of all the menus (includes other files)

.fvwm2rc.modules
- Settings for modules, other than the FvwmForm module.

.fvwm2rc.mouse
- The mouse bindings to actions.

.fvwm2rc.programs
- The list of known applications, with a mapping to a mini icon, a full-size
  icon, its action, and its type.  This should get edited by the system 
  administrator to add applications for the site.

.dir_colors

control-panel-icons/README
- Description of the directory

control-panel-icons/*
- Files to be copied to /usr/lib/rhs/control-panel to improve the appearance
  of the control-panel

icons/README
- Description of the directory

icons/README.gjb.originals
- List of the icons that I drew (recognizable since they're often not as
  pretty as the rest :-) )

icons/*
- Files to be copied to /usr/include/X11/pixmaps/.  These are all files
  referenced by my FVWM configuration, some original (see README.gjb.originals).
  ImageMagick's "mogrify" command was run on the 3d icons to reduce
  their color usage to 32 colors with the command:
	mogrify -verbose -colors 32 *.xpm

docs/*
- HTML documentation for users using the configuration

docs/man/*
- HTML conversions of the Fvwm2 man pages, converted using man2html,
  from ftp.redhat.com's contributed rpm section.

emacs/*
- See emacs/README.  Various support files for setting up a nice emacs
  configuration that integrates with the desktop well.

patches/*
- Patches for fvwm, zsh, to add useful features.  See README.fvwm, README.zsh
  Confirmed with Mr. Erik Troan <ewt@redhat.com> that the patches were okay
  alone, and didn't need to build rpm-s (via email June 10).  Fvwm2 is a work
  in progress, so I'm still hoping to get my patches to be a part of the
  real thing.  ZShell has a new version which is a work in progress, so 
  same goal there.

zsh-misc/*
- Help files, gzipped, for my zshelp command.  Some of these are original
  cutups from the man pages, most of them came with zsh-2.5.03 in the
  help subdirectory.  ".aliases" sets up an alias for zh to zshelp, and
  ".zshrc-compctl" completes zh smartly-- try "zh [tab]" (The variable
  ZSH_HELP_DIRECTORY must be set properly (and exported) for completion 
  control or the zshelp command to work correctly.

zsh-misc/keymap.gjb
- A keymap for loadkeys(1) which makes special characters like control arrows
  output strings similar to those that XTerm gives to ZShell's line editor, so
  editing your command lines in a console is more like editing command lines
  in an (N)XTerm.

zsh-misc/zsh
- My patched version of zsh, ELF binary for Linux.

xdm/*
- Files for a nicer looking xdm startup screen, using the Linux-2 penguin logo.

bin/*
- Supplemental executables. tcolor is a program I hacked up that allows for selection
  of a color, and prints the selected color on stdout.

Enjoy!
Greg J. Badros
<gjb@cs.duke.edu>
