manual page distributed with 4.2BSD

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

diff --git a/usr/src/usr.bin/learn/learn/learn.1 b/usr/src/usr.bin/learn/learn/learn.1
index 3c14496..36c140a 100644 (file)
--- a/usr/src/usr.bin/learn/learn/learn.1
+++ b/usr/src/usr.bin/learn/learn/learn.1
@@ -1,6 +1,6 @@
-.\"    @(#)learn.1     4.1 (Berkeley) %G%
+.\"    @(#)learn.1     5.1 (Berkeley) %G%

 .\"
 .\"

-.TH LEARN 1
+.TH LEARN 1 "26 April 1983"

 .AT 3
 .SH NAME
 learn \- computer aided instruction about UNIX
 .AT 3
 .SH NAME
 learn \- computer aided instruction about UNIX


@@ -9,69 +9,96 @@ learn \- computer aided instruction about UNIX
 [
 .BR \- directory
 ]
 [
 .BR \- directory
 ]

-[ subject [ lesson  [ speed ] ] ]
+[ subject [ lesson ] ]

 .SH DESCRIPTION
 .I Learn
 .SH DESCRIPTION
 .I Learn

-gives CAI courses and practice in the use of UNIX.
-To get started
-simply type `learn'.
+gives Computer Aided Instruction courses and
+practice in the use of UNIX, the C Shell,
+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.
 The program will ask questions to find out what
 you want to do.

-The questions may be bypassed by naming a
-.I subject,
-and the last
+Some questions may be bypassed by naming a
+.IR subject ,
+and more yet by naming a
+.IR lesson .
+You may enter the

 .I lesson
 .I lesson

-number that
+as a number that

 .I learn
 .I learn

-told you in the previous session.
-You may also include a
-.I speed
-number that was given with the lesson number
-(but without the parentheses that
+gave you in a previous session.
+If you do not know the lesson number,
+you may enter the
+.I lesson
+as a word, and

 .I learn
 .I learn

-places around the speed number).
-If
+will look for the first lesson containing it.
+If the

 .I lesson
 .I lesson

-is `\-', 
+is `\fB\-\fP',

 .I learn
 prompts for each lesson;
 this is useful for debugging.
 .PP
 The
 .I learn
 prompts for each lesson;
 this is useful for debugging.
 .PP
 The

-.I subjects
+.IR subject \|'s

 presently handled are
 presently handled are

-.sp
+.if n .sp 1v
+.if t .sp .5v

 .nf
 .nf

-      editor
-      eqn
-      files
-      macros
-      morefiles
-      C
+           files
+           editor
+           vi
+           morefiles
+           macros
+           eqn
+           C

 .fi
 .PP
 .fi
 .PP

-The special command
-`bye' terminates a 
+There are a few special commands.
+The command `bye' terminates a 

 .I learn
 .I learn

-session.
+session and `where' tells you of your progress,
+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 .

 .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

-/usr/learn and all dependent directories and files
+.nf
+/usr/lib/learn subtree for all dependent directories and files
+/usr/tmp/pl\(**        playpen directories
+.SH SEE ALSO
+csh(1), ex(1)

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

-that it asks the student to use the real
-UNIX, also makes possible baffling mistakes.
+that it asks the student to use the real UNIX,
+also makes possible baffling mistakes.

 It is helpful, especially for nonprogrammers,
 to have a UNIX initiate near at hand during the first
 sessions.
 .PP
 Occasionally lessons are incorrect, sometimes because the local version
 of a command operates in a non-standard way.
 It is helpful, especially for nonprogrammers,
 to have a UNIX initiate near at hand during the first
 sessions.
 .PP
 Occasionally lessons are incorrect, sometimes because the local version
 of a command operates in a non-standard way.

-Such lessons may be skipped,
+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
+given as a word,
+.I learn
+does a simple
+.IR fgrep (1)
+through the lessons.
+It is unclear whether this sort
+of subject indexing is better than none.
+.PP
+Spawning a new shell is required for each of many
+user and internal functions.