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