\begindata{text,537644044}
\textdsversion{12}
\template{help}
\define{global
}
\define{helptopic
}
\chapter{Gendemo: A Program that Generates an AMS Demonstration Folder

}
\section{What gendemo is

}\leftindent{
Gendemo is a shell script that will creat a new \helptopic{AMS} folder that 
is designed to serve as an introductory demonstration of the Andrew Message 
System.

}
\section{Starting gendemo

}\leftindent{
Gendemo is typically installed in /usr/andrew/etc.  It generally takes only 
one argument, the name of a directory that will hold your demo folder.  As 
with all AMS folders, this needs to be in a tree somewhere under a 
directory with a name starting with ".MESSAGES".  Thus, to create it as a 
top-level mail folder named "amsdemo", for example, you could simply type:


\programexample{/usr/andrew/etc/gendemo ~/.MESSAGES/amsdemo

}
(Note that all the fixed face sections in this document are one line, they 
may wrap on screen however.  Also substitute the real path to the AUIS 
installation directory in place of /usr/andrew in all these examples.)


For this to work, the directory ~/.MESSAGES must already exist.  The 
subdirectory "amsdemo"  itself does not need to already exist, but if it 
does already exist, \italic{all of its previous contents will be 
destroyed}.


When you run gendemo, it will ask you for confirmation before it overwrites 
any existing contents of the directory you have specified; simply answer 
"y" to overwrite the directory.  


Gendemo has two options, "-force", which can be used to suppress the 
confirmation question and simply go right ahead with destroying the old 
contents of the directory:


\programexample{/usr/andrew/etc/gendemo -force ~/.MESSAGES/amsdemo

}
and, "-DESTDIR", which can be used to set where AUIS has been installed:


\programexample{/alt/andrew/etc/gendemo -force -DESTDIR /alt/andrew 
~/.MESSAGES/amsdemo}



}\section{Warnings

}\leftindent{
If you create a demo folder that is not in a folder tree that is included 
in your "*.mspath" preference, the AMS programs will not be able to find it 
by its short name (e.g. "amsdemo"), and will only be able to identify the 
folder if you type its full path name.

}
\section{Program Author}

\leftindent{
Nathaniel S. Borenstein}


\section{Related tools}  


\leftindent{Select (highlight) one of the italicized names and choose "Show 
Help on Selected Word" from the pop-up menu to see the help file for:


\italic{\helptopic{cui}

\helptopic{ams}

\helptopic{messages}

\helptopic{preferences}}		(includes a description of the \italic{mspath} 
preference)}


\begindata{bp,537465088}
\enddata{bp,537465088}
\view{bpv,537465088,0,0,0}
Copyright 1992 Carnegie Mellon University and IBM.  All rights reserved.

\smaller{\smaller{$Disclaimer: This software is part of version 6.1 of the 

Andrew User Interface System and is 

the property of IBM, Carnegie Mellon University, 

and the other copyright holders.  The source 

code of this version is for the sole use of 

the individual named in ./config/allsys.h.  

This source code is not to be redistributed.  

Binary object code compiled or derived from 

these sources is not to be distributed to non-

members.  Members may have additional 

distribution rights granted by prior written 

permission of Carnegie Mellon University.



IBM, CARNEGIE MELLON UNIVERSITY, 

AND THE OTHER COPYRIGHT HOLDERS

 DISCLAIM ALL WARRANTIES WITH 

REGARD TO THIS SOFTWARE, INCLUDING 

ALL IMPLIED WARRANTIES OF MERCHANT-

ABILITY AND FITNESS. IN 

NO EVENT SHALL  IBM, CARNEGIE 

MELLON UNIVERSITY, OR ANY OTHER 

COPYRIGHT HOLDER BE LIABLE FOR 

ANY SPECIAL, INDIRECT OR CONSE-

QUENTIAL DAMAGES OR ANY DAMAGES 

WHATSOEVER RESULTING FROM LOSS OF

USE, DATA OR PROFITS, WHETHER IN AN

ACTION OF CONTRACT, NEGLIGENCE OR

OTHER TORTIOUS ACTION, ARISING OUT 

OF OR IN CONNECTION WITH THE USE OR

PERFORMANCE OF THIS SOFTWARE.

 $

}}\enddata{text,537644044}
