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