# Readme file for Frame Demo account.
# $Header: /xdim/dim40/fmhome/fminit/samplehome/RCS/README,v 1.2 1993/05/29 00:18:40 ras Exp $

This directory contains files that can be used to start X11 and/or start
default X11 clients.  Some files are set up for specific platforms, but
are included as examples.  The 'user_data' directory is for Apollo only.

To use these files you should review them and merge them into your own
home directory.  First you must either run 'demo_install' or manually
edit the .login file so that the environment variable 'FMHOME' is set
to the directory in which a Frame product is installed on your system.
Then if you merge the files into your home directory, log out and log
in again.  If you want to run them where they are, start a C-shell and
then source both the .cshrc and .login files.  Then execute the
appropriate x11 or xsetup alias.  (For example to start X11 and the
default environment type: /bin/csh <ret> source .cshrc; source .login;
x11)

The procedure for starting X11 with these files is as follows:

From a C-shell:
LOGIN
  the .cshrc file is read.
  then the .login file is read.
EXECUTE
  the appropiate alias to start up X11 and/or the default clients.


From a Bourne or Korn shell:
LOGIN
  the .profile file is read.
EXECUTE
  ~/Xup to start X11 and/or the default clients.



X11setup	: This script starts all default X11 clients.  Edit this
		  file to start all X11 clients that you want running by
		  default.  (Warning: If you don't have lots of available
		  memory, start only a minimum set of X11 clients.)
		  Rename this file to .X11setup before using it.

Xdefaults	: This file contains the X11 resources suggested by Frame
		  for use when running a Frame product.  Many
		  resources are commented out because they are the same as
		  the defaults used by Frame products; use them to
     		  customize your Frame product environment.  For an
     		  explanation of the resources, see the online manual
     		  "Changing Setup Files."  Rename this file to
     		  .Xdefaults before using it.

Xkbconfig	: Apollo only.  This file sets up the Xapollo share
		  mode server so it passes to X11 all keystrokes that
		  a Frame product uses.  If you start Xapollo at boot
		  time, merge this file into your system's
		  /usr/lib/X11/keyboard/keyboard.config file.  Without
		  these changes some Apollo keyboard keys will NOT be
		  passed to the X11 server and the Frame product.
		  Rename this file to .Xkbconfig before using it.

Xmodmap		: This file contains keyboard mapping definitions used by
		  the xmodmap program.  Use this file to change the
		  meanings of keys.  For example, the file contains the
		  commands to remap the 'REPEAT' key on Apollo keyboards
		  so that it can be used as a 'META' key.  (Warning: It is
		  possible that the current settings in this file could
		  interfere with a key on another vendor's keyboard.
		  Therefore you may need to alter this file to match your
		  keyboard.)  Rename this file to .Xmodmap before using it.

cshrc		: This file defines some useful aliases for starting X11.
		  This file is accessed only if you use the C-shell.
		  The aliases that start with 'x11' are for starting X11
		  when it is not already running.  They use xinit to
		  start the X11 server process.  The aliases that start
		  with 'xsetup' assume that X11 is already running.  This
		  is the case if you use 'xdm' on your system, or if you
		  are running in share mode on an Apollo and the X server
		  was started at boot time.   Append the contents to your
		  existing .cshrc if you wish to use it.

login		: This file defines the FMHOME environment variable and
		  the PATH variable.  This file is accessed only if you
		  use the C-shell.  Append the contents to your existing
		  .login if you wish to use it.

mwmrc		: This file is used by the Motif window manager (mwm).
		  There are key and menu definitions for mwm.  Modify this
		  file and rename it to .mwmrc to suit your needs.

profile		: This file defines the FMHOME environment variable and
		  the PATH variable.  This file is accessed only if you
		  use the Bourne or Korn shell.  Append your existing 
		  .profile with its contents if you wish to use it.

README		: This file.

Xup		: Shell script for use with the Bourne or Korn shell to
		  start the X11 server and/or the default clients.  Edit
		  this file to select the appropiate X11 start-up command
		  for your system.  (Note: By default, none are selected.)

demo_install	: This file edits both the .login and .profile files for
		  the demo account.  You can also edit the two files
		  manually.


user_data/			: Apollo only directory.

user_data/frame_dm_keys		: Sample Display Manager (DM) key bindings.
				  Edit as you like.

user_data/startup_dm		: DM startup file for all monitors.

user_data/startup_dm.1280bw	: DM startup file for 1280x1024 B/W monitors.

user_data/startup_dm.1280color	: DM startup file for 1280x1024 color monitors.

user_data/startup_dm.19l	: DM startup file for 1024x800 monitors.
