update from John Kunze (jak@opal)

SCCS-vsn: usr.bin/learn/learn/learn.1 6.2

diff --git a/usr/src/usr.bin/learn/learn/learn.1 b/usr/src/usr.bin/learn/learn/learn.1
index efafcac..7286da8 100644 (file)
--- a/usr/src/usr.bin/learn/learn/learn.1
+++ b/usr/src/usr.bin/learn/learn/learn.1
@@ -1,4 +1,4 @@
-.\"    @(#)learn.1     6.1 (Berkeley) %G%
+.\"    @(#)learn.1     6.2 (Berkeley) %G%

 .\"
 .TH LEARN 1 ""
 .AT 3
 .\"
 .TH LEARN 1 ""
 .AT 3


@@ -17,8 +17,14 @@ practice in the use of UNIX, the C Shell,
 and the Berkeley text editors.
 To get started simply type
 .BR learn .
 and the Berkeley text editors.
 To get started simply type
 .BR learn .

-The program will ask questions to find out what
-you want to do.
+If you had used
+.I learn
+before and left your last session without completing a subject,
+the program will use information in $HOME/.learnrc to start you up
+in the same place you left off.
+Your first time through,
+.I learn
+will ask questions to find out what you want to do.

 Some questions may be bypassed by naming a
 .IR subject ,
 and more yet by naming a
 Some questions may be bypassed by naming a
 .IR subject ,
 and more yet by naming a


@@ -47,13 +53,15 @@ presently handled are
 .if n .sp 1v
 .if t .sp .5v
 .nf
 .if n .sp 1v
 .if t .sp .5v
 .nf

-           files
-           editor
-           vi
-           morefiles
-           macros
-           eqn
-           C
+.in +0.5i
+files
+editor
+vi
+morefiles
+macros
+eqn
+C
+.in -0.5i

 .fi
 .PP
 There are a few special commands.
 .fi
 .PP
 There are a few special commands.


@@ -64,17 +72,29 @@ with `where\0m' telling you more.
 The command `again' re-displays the text of the lesson
 and `again\0\fIlesson\fP' lets you review
 .IR lesson .
 The command `again' re-displays the text of the lesson
 and `again\0\fIlesson\fP' lets you review
 .IR lesson .

+There is no way for
+.I learn
+to tell you the answers it expects in English, however,
+the command `hint' prints the last part of the lesson script
+used to evaluate a response, while `hint m' prints the
+whole lesson script.
+This is useful for debugging
+lessons and might possibly give you an idea about what it expects.

 .PP
 The
 .BI \- directory
 option allows one to exercise a script in
 a nonstandard place.
 .SH FILES
 .PP
 The
 .BI \- directory
 option allows one to exercise a script in
 a nonstandard place.
 .SH FILES

-.nf

 /usr/lib/learn subtree for all dependent directories and files
 /usr/lib/learn subtree for all dependent directories and files

+.br

 /usr/tmp/pl\(**        playpen directories
 /usr/tmp/pl\(**        playpen directories

+.br
+$HOME/.learnrc startup information

 .SH SEE ALSO
 csh(1), ex(1)
 .SH SEE ALSO
 csh(1), ex(1)

+.br
+B. W. Kernighan and M. E. Lesk, \fILEARN \- Computer-Aided Instruction on UNIX\fR

 .SH BUGS
 The main strength of
 .I learn,
 .SH BUGS
 The main strength of
 .I learn,


@@ -86,9 +106,10 @@ sessions.
 .PP
 Occasionally lessons are incorrect, sometimes because the local version
 of a command operates in a non-standard way.
 .PP
 Occasionally lessons are incorrect, sometimes because the local version
 of a command operates in a non-standard way.

+Occasionally a lesson script does not recognize all the different
+correct responses, in which case the `hint' command may be useful.

 Such lessons may be skipped with the `skip' command,
 Such lessons may be skipped with the `skip' command,

-but it takes some sophistication to recognize
-the situation.
+but it takes some sophistication to recognize the situation.

 .PP
 To find a
 .I lesson
 .PP
 To find a
 .I lesson


@@ -102,3 +123,6 @@ of subject indexing is better than none.
 .PP
 Spawning a new shell is required for each of many
 user and internal functions.
 .PP
 Spawning a new shell is required for each of many
 user and internal functions.

+.PP
+The `vi' lessons are provided separately from the others.
+To use them see your system administrator.