# # kl-scripts version 1.7 # # kl-scripts $Id: README,v 1.5 1999/07/14 02:43:22 knight Exp $ # # # README -- introductory documentation # kl-scripts is a package of account login scripts and files (.profile, .xinitrc, and so on). To be precise, it's a package of *my* account login scripts and files... I created the package and accompanying installation scripts so I'd have a convenient way of transporting my preferred login methodology to all the systems I need. Once the package was created, I figured there wasn't any harm in letting others peak at it. The scripts here are supposed to be portable as is, with no local tweaking necessary. At least, I've done my best to ensure that *I* don't have to tweak them on any of the systems on which I use them. Consequently, the emphasis is on generalizing what I'm doing as often as possible, and using lowest-common-denominator methods of doing things in the shell (like GNU autoconf does, where possible). INSTALLATION The easiest way to install the kl-scripts is to use the kl-extract wrapper script. This is a Perl script that knows how to extract and prepare the kl-scripts for your system using the normal "configure-make-make install" logic familiar to anyone who has installed GNU software. The kl-extract script also knows how to fetch the archive from my repository on the web, which means the cleanest and easiest way to install this release of kl-scripts is: $ perl kl-extract --web 1.7 target (The kl-extract script does not yet have support for fetching the release through a proxy server; sorry.) You may, of course, specify a different version number (provided the version you specify is available, of course). You must specify one or more of the following targets: all Install all login scripts and files. non-x Install scripts and files not related to X Windows. x Install X Windows scripts and files. Any copies of the files in the kl-scripts package that already exist in your home directory will be moved to "file.OLD". There are options to control this, and most other aspects of its behavior. Execute: $ perl kl-extract --help for a complete list of available options. INSTALLATION BY HAND Unfortunately, a few of the configuration files here couldn't be written completely portably. (Specifically, the internal .xloadres script requires executable permission, and .fvwmrc requires running through m4--yes, fvwm has an m4 option for this sort of thing, but not every system is guaranteed to compile it into fvwm...) Consequently, to install this package of login scripts by hand, you need to go through the normal routine of unpacking the .tar.gz file and executing: $ ./configure $ make all $ make install You must specify a target to make, there is no default. Available targets are as specified above. Any copies of the files in this package that already exist in your home directory will be moved to "file.OLD". The Makefile uses an internal "kl-install" script for installation. This script has options to control most aspects of its behavior. Execute: $ kl-install -h to get help text that explains these options. If you actually use this package, or any parts of it, I welcome feedback. Steven Knight knight@baldmt.com