Commit | Line | Data |
---|---|---|
d9d7a9f0 CL |
1 | .\" Copyright (c) 1990 Regents of the University of California. |
2 | .\" All rights reserved. The Berkeley software License Agreement | |
3 | .\" specifies the terms and conditions for redistribution. | |
f738e190 | 4 | .\" |
1c15e888 | 5 | .\" @(#)learn.1 6.5 (Berkeley) 7/24/90 |
d9d7a9f0 | 6 | .\" |
1c15e888 | 7 | .Dd July 24, 1990 |
d9d7a9f0 CL |
8 | .Dt LEARN 1 |
9 | .Os ATT 7th | |
10 | .Sh NAME | |
11 | .Nm learn | |
12 | .Nd computer aided instruction about UNIX | |
13 | .Sh SYNOPSIS | |
14 | .Nm learn | |
15 | .Oo | |
16 | .Op Fl Ar directory | |
17 | .Oo | |
18 | .Ob Ar subject | |
19 | .Op Ar lesson | |
20 | .Oe | |
21 | .Sh DESCRIPTION | |
22 | .Nm Learn | |
29d6d0c7 KM |
23 | gives Computer Aided Instruction courses and |
24 | practice in the use of UNIX, the C Shell, | |
25 | and the Berkeley text editors. | |
26 | To get started simply type | |
d9d7a9f0 | 27 | .Nm learn . |
a2fdb40b | 28 | If you had used |
d9d7a9f0 | 29 | .Nm learn |
a2fdb40b | 30 | before and left your last session without completing a subject, |
d9d7a9f0 CL |
31 | the program will use information in |
32 | .Pa $HOME/.learnrc | |
33 | to start you up | |
a2fdb40b JB |
34 | in the same place you left off. |
35 | Your first time through, | |
d9d7a9f0 | 36 | .Nm learn |
a2fdb40b | 37 | will ask questions to find out what you want to do. |
29d6d0c7 | 38 | Some questions may be bypassed by naming a |
d9d7a9f0 | 39 | .Ar subject , |
29d6d0c7 | 40 | and more yet by naming a |
d9d7a9f0 | 41 | .Ar lesson . |
29d6d0c7 | 42 | You may enter the |
d9d7a9f0 | 43 | .Ar lesson |
29d6d0c7 | 44 | as a number that |
d9d7a9f0 | 45 | .Nm learn |
29d6d0c7 KM |
46 | gave you in a previous session. |
47 | If you do not know the lesson number, | |
48 | you may enter the | |
d9d7a9f0 | 49 | .Ar lesson |
29d6d0c7 | 50 | as a word, and |
d9d7a9f0 | 51 | .Nm learn |
29d6d0c7 KM |
52 | will look for the first lesson containing it. |
53 | If the | |
d9d7a9f0 CL |
54 | .Ar lesson |
55 | is | |
56 | .Sq Fl , | |
57 | .Nm learn | |
f738e190 KM |
58 | prompts for each lesson; |
59 | this is useful for debugging. | |
d9d7a9f0 | 60 | .Pp |
f738e190 | 61 | The |
d9d7a9f0 | 62 | .Sf Ar subject \'s |
f738e190 | 63 | presently handled are |
d9d7a9f0 CL |
64 | .Pp |
65 | .Ds I | |
a2fdb40b JB |
66 | files |
67 | editor | |
68 | vi | |
69 | morefiles | |
70 | macros | |
71 | eqn | |
72 | C | |
d9d7a9f0 CL |
73 | .De |
74 | .Pp | |
29d6d0c7 | 75 | There are a few special commands. |
d9d7a9f0 CL |
76 | The command `bye' terminates a |
77 | .Nm learn | |
29d6d0c7 KM |
78 | session and `where' tells you of your progress, |
79 | with `where\0m' telling you more. | |
80 | The command `again' re-displays the text of the lesson | |
d9d7a9f0 CL |
81 | and `again\0 |
82 | .Sf Ar lesson \&' | |
83 | lets you review | |
84 | .Ar lesson . | |
a2fdb40b | 85 | There is no way for |
d9d7a9f0 | 86 | .Nm learn |
a2fdb40b JB |
87 | to tell you the answers it expects in English, however, |
88 | the command `hint' prints the last part of the lesson script | |
89 | used to evaluate a response, while `hint m' prints the | |
90 | whole lesson script. | |
91 | This is useful for debugging | |
92 | lessons and might possibly give you an idea about what it expects. | |
d9d7a9f0 | 93 | .Pp |
64349855 | 94 | Normally, lesson scripts are found in the directory /usr/lib/learn. |
f738e190 | 95 | The |
d9d7a9f0 | 96 | .Fl directory |
64349855 | 97 | option allows one to specify a nonstandard place to look for scripts. |
d9d7a9f0 CL |
98 | .Sh FILES |
99 | .Dw /usr/libdata/learn | |
100 | .Di L | |
101 | .Dp Pa /usr/lib/learn | |
102 | subtree for all dependent directories and files | |
103 | .Dp Pa /usr/tmp/pl\(** | |
104 | playpen directories | |
105 | .Dp $HOME/.learnrc | |
106 | startup information | |
107 | .Dp | |
108 | .Sh SEE ALSO | |
109 | .Xr csh 1 , | |
110 | .Xr ex 1 | |
a2fdb40b | 111 | .br |
d9d7a9f0 CL |
112 | B. W. Kernighan and M. E. Lesk, |
113 | .Em LEARN \- Computer-Aided Instruction on UNIX | |
114 | .Sh BUGS | |
f738e190 | 115 | The main strength of |
d9d7a9f0 | 116 | .Nm learn , |
29d6d0c7 KM |
117 | that it asks the student to use the real UNIX, |
118 | also makes possible baffling mistakes. | |
f738e190 KM |
119 | It is helpful, especially for nonprogrammers, |
120 | to have a UNIX initiate near at hand during the first | |
121 | sessions. | |
d9d7a9f0 | 122 | .Pp |
f738e190 KM |
123 | Occasionally lessons are incorrect, sometimes because the local version |
124 | of a command operates in a non-standard way. | |
a2fdb40b JB |
125 | Occasionally a lesson script does not recognize all the different |
126 | correct responses, in which case the `hint' command may be useful. | |
29d6d0c7 | 127 | Such lessons may be skipped with the `skip' command, |
a2fdb40b | 128 | but it takes some sophistication to recognize the situation. |
d9d7a9f0 | 129 | .Pp |
29d6d0c7 | 130 | To find a |
d9d7a9f0 | 131 | .Ar lesson |
29d6d0c7 | 132 | given as a word, |
d9d7a9f0 | 133 | .Nm learn |
29d6d0c7 | 134 | does a simple |
d9d7a9f0 | 135 | .Xr fgrep 1 |
29d6d0c7 KM |
136 | through the lessons. |
137 | It is unclear whether this sort | |
138 | of subject indexing is better than none. | |
d9d7a9f0 | 139 | .Pp |
29d6d0c7 KM |
140 | Spawning a new shell is required for each of many |
141 | user and internal functions. | |
d9d7a9f0 | 142 | .Pp |
a2fdb40b JB |
143 | The `vi' lessons are provided separately from the others. |
144 | To use them see your system administrator. | |
d9d7a9f0 CL |
145 | .Sh HISTORY |
146 | .Nm Learn | |
147 | appeared in Version 32 AT&T Unix. |