| 1 | ?RCS: $Id: Instruct.U,v 3.0.1.3 1997/02/28 15:02:55 ram Exp $ |
| 2 | ?RCS: |
| 3 | ?RCS: Copyright (c) 1991-1993, Raphael Manfredi |
| 4 | ?RCS: |
| 5 | ?RCS: You may redistribute only under the terms of the Artistic Licence, |
| 6 | ?RCS: as specified in the README file that comes with the distribution. |
| 7 | ?RCS: You may reuse parts of this distribution only within the terms of |
| 8 | ?RCS: that same Artistic Licence; a copy of which may be found at the root |
| 9 | ?RCS: of the source tree for dist 3.0. |
| 10 | ?RCS: |
| 11 | ?RCS: $Log: Instruct.U,v $ |
| 12 | ?RCS: Revision 3.0.1.3 1997/02/28 15:02:55 ram |
| 13 | ?RCS: patch61: logname / whoami sequence rewritten to use case |
| 14 | ?RCS: |
| 15 | ?RCS: Revision 3.0.1.2 1995/02/15 14:11:34 ram |
| 16 | ?RCS: patch51: author name now appears at the end of the paragraph (WED) |
| 17 | ?RCS: |
| 18 | ?RCS: Revision 3.0.1.1 1995/01/11 15:12:05 ram |
| 19 | ?RCS: patch45: now documents the & escape to turn -d on at the read prompt |
| 20 | ?RCS: |
| 21 | ?RCS: Revision 3.0 1993/08/18 12:05:04 ram |
| 22 | ?RCS: Baseline for dist 3.0 netwide release. |
| 23 | ?RCS: |
| 24 | ?X: |
| 25 | ?X: This unit spew out the directions that we want everyone to read. I try to |
| 26 | ?X: keep the first "pagefull" much less than a page since they don't know it |
| 27 | ?X: isn't going to go shooting off the top of the screen, and we don't want |
| 28 | ?X: to panic them yet. |
| 29 | ?X: |
| 30 | ?MAKE:Instruct: Myread Configdir Devel contains |
| 31 | ?MAKE: -pick wipe $@ %< |
| 32 | ?T:user needman firsttime |
| 33 | : general instructions |
| 34 | needman=true |
| 35 | firsttime=true |
| 36 | user=`(logname) 2>/dev/null` |
| 37 | case "$user" in |
| 38 | '') user=`whoami 2>&1`;; |
| 39 | esac |
| 40 | if $contains "^$user\$" ../.config/instruct >/dev/null 2>&1; then |
| 41 | firsttime=false |
| 42 | echo " " |
| 43 | rp='Would you like to see the instructions?' |
| 44 | dflt=n |
| 45 | . ./myread |
| 46 | case "$ans" in |
| 47 | [yY]*) ;; |
| 48 | *) needman=false;; |
| 49 | esac |
| 50 | fi |
| 51 | if $needman; then |
| 52 | cat <<EOH |
| 53 | |
| 54 | This installation shell script will examine your system and ask you questions |
| 55 | to determine how the <PACKAGENAME> package should be installed. If you get |
| 56 | stuck on a question, you may use a ! shell escape to start a subshell or |
| 57 | execute a command. Many of the questions will have default answers in square |
| 58 | brackets; typing carriage return will give you the default. |
| 59 | |
| 60 | On some of the questions which ask for file or directory names you are allowed |
| 61 | to use the ~name construct to specify the login directory belonging to "name", |
| 62 | even if you don't have a shell which knows about that. Questions where this is |
| 63 | allowed will be marked "(~name ok)". |
| 64 | |
| 65 | EOH |
| 66 | rp='' |
| 67 | dflt='Type carriage return to continue' |
| 68 | . ./myread |
| 69 | cat <<'EOH' |
| 70 | |
| 71 | The prompter used in this script allows you to use shell variables and |
| 72 | backticks in your answers. You may use $1, $2, etc... to refer to the words |
| 73 | in the default answer, as if the default line was a set of arguments given to a |
| 74 | script shell. This means you may also use $* to repeat the whole default line, |
| 75 | so you do not have to re-type everything to add something to the default. |
| 76 | |
| 77 | Every time there is a substitution, you will have to confirm. If there is an |
| 78 | error (e.g. an unmatched backtick), the default answer will remain unchanged |
| 79 | and you will be prompted again. |
| 80 | |
| 81 | If you are in a hurry, you may run 'Configure -d'. This will bypass nearly all |
| 82 | the questions and use the computed defaults (or the previous answers if there |
| 83 | was already a config.sh file). Type 'Configure -h' for a list of options. |
| 84 | You may also start interactively and then answer '& -d' at any prompt to turn |
| 85 | on the non-interactive behaviour for the remainder of the execution. |
| 86 | |
| 87 | EOH |
| 88 | . ./myread |
| 89 | cat <<EOH |
| 90 | |
| 91 | Much effort has been expended to ensure that this shell script will run on any |
| 92 | Unix system. If despite that it blows up on yours, your best bet is to edit |
| 93 | Configure and run it again. If you can't run Configure for some reason, |
| 94 | you'll have to generate a config.sh file by hand. Whatever problems you |
| 95 | have, let me (<MAINTLOC>) know how I blew it. |
| 96 | |
| 97 | This installation script affects things in two ways: |
| 98 | |
| 99 | 1) it may do direct variable substitutions on some of the files included |
| 100 | in this kit. |
| 101 | 2) it builds a config.h file for inclusion in C programs. You may edit |
| 102 | any of these files as the need arises after running this script. |
| 103 | |
| 104 | If you make a mistake on a question, there is no easy way to back up to it |
| 105 | currently. The easiest thing to do is to edit config.sh and rerun all the SH |
| 106 | files. Configure will offer to let you do this before it runs the SH files. |
| 107 | |
| 108 | EOH |
| 109 | ?X: In case they played with the prompter... |
| 110 | dflt='Type carriage return to continue' |
| 111 | . ./myread |
| 112 | case "$firsttime" in |
| 113 | true) echo $user >>../.config/instruct;; |
| 114 | esac |
| 115 | fi |
| 116 | |