BSD 4_4 release

[unix-history] / usr / src / usr.bin / learn / learn / learn.1

diff --git a/usr/src/usr.bin/learn/learn/learn.1 b/usr/src/usr.bin/learn/learn/learn.1
index 9467eab..6165c28 100644 (file)
--- a/usr/src/usr.bin/learn/learn/learn.1
+++ b/usr/src/usr.bin/learn/learn/learn.1
@@ -1,27 +1,29 @@
-.\" Copyright (c) 1990 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1990, 1993
+.\"    The Regents of the University of California.  All rights reserved.

 .\"
 .\"

-.\"     @(#)learn.1    6.5 (Berkeley) %G%
+.\" This module is believed to contain source code proprietary to AT&T.
+.\" Use and redistribution is subject to the Berkeley Software License
+.\" Agreement and your Software Agreement with AT&T (Western Electric).

 .\"
 .\"

-.Dd 
+.\"    @(#)learn.1     8.1 (Berkeley) 6/6/93
+.\"
+.Dd June 6, 1993

 .Dt LEARN 1
 .Os ATT 7th
 .Sh NAME
 .Nm learn
 .Dt LEARN 1
 .Os ATT 7th
 .Sh NAME
 .Nm learn

-.Nd computer aided instruction about UNIX
+.Nd computer aided instruction about
+.Ux

 .Sh SYNOPSIS
 .Nm learn
 .Sh SYNOPSIS
 .Nm learn

-.Oo

 .Op Fl Ar directory
 .Op Fl Ar directory

-.Oo
-.Ob Ar subject
-.Op Ar lesson
-.Oe
+.Op Ar subject Op Ar lesson

 .Sh DESCRIPTION
 .Nm Learn
 gives Computer Aided Instruction courses and
 .Sh DESCRIPTION
 .Nm Learn
 gives Computer Aided Instruction courses and

-practice in the use of UNIX, the C Shell,
+practice in the use of
+.Tn UNIX ,
+the C Shell,

 and the Berkeley text editors.
 To get started simply type
 .Nm learn  .
 and the Berkeley text editors.
 To get started simply type
 .Nm learn  .


@@ -59,10 +61,9 @@ prompts for each lesson;
 this is useful for debugging.
 .Pp
 The
 this is useful for debugging.
 .Pp
 The

-.Sf Ar subject  \'s
+.Ar subject 's

 presently handled are
 presently handled are

-.Pp
-.Ds I
+.Bd -unfilled -offset indent

 files
 editor
 vi
 files
 editor
 vi


@@ -70,54 +71,71 @@ morefiles
 macros
 eqn
 C
 macros
 eqn
 C

-.De
+.Ed

 .Pp
 There are a few special commands.
 .Pp
 There are a few special commands.

-The command `bye' terminates a
+The command
+.Ql bye
+terminates a

 .Nm learn
 .Nm learn

-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
-.Sf Ar lesson \&'
+session and
+.Ql where
+tells you of your progress,
+with
+.Ql where m
+telling you more.
+The command
+.Ql again
+re-displays the text of the lesson
+and
+.Ql again Ar lesson

 lets you review
 .Ar lesson  .
 There is no way for
 .Nm learn
 to tell you the answers it expects in English, however,
 lets you review
 .Ar lesson  .
 There is no way for
 .Nm 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
+the command
+.Ql hint
+prints the last part of the lesson script
+used to evaluate a response, while
+.Ql 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
 whole lesson script.
 This is useful for debugging
 lessons and might possibly give you an idea about what it expects.
 .Pp

-Normally, lesson scripts are found in the directory /usr/lib/learn.
+Normally, lesson scripts are found in the directory
+.Pa /usr/libata/learn.

 The
 .Fl  directory
 option allows one to specify a nonstandard place to look for scripts.
 .Sh FILES
 The
 .Fl  directory
 option allows one to specify a nonstandard place to look for scripts.
 .Sh FILES

-.Dw /usr/libdata/learn
-.Di L
-.Dp Pa /usr/lib/learn
-subtree for all dependent directories and files
-.Dp Pa /usr/tmp/pl\(**
-playpen directories
-.Dp $HOME/.learnrc
-startup information
-.Dp
+.Bl -tag -width /usr/libdata/learn -compact
+.It Pa /usr/lib/learn
+Subtree for all dependent directories and files.
+.It Pa /usr/tmp/pl\(**
+Playpen directories.
+.It $HOME/.learnrc
+Startup information.
+.El

 .Sh SEE ALSO
 .Xr csh 1 ,
 .Xr ex 1
 .Sh SEE ALSO
 .Xr csh 1 ,
 .Xr ex 1

-.br
-B. W. Kernighan and M. E. Lesk,
-.Em LEARN \- Computer-Aided Instruction on UNIX
+.Rs
+.%A B. W. Kernighan
+.%A M. E. Lesk
+.%T "LEARN \- Computer-Aided Instruction on UNIX"
+.Re

 .Sh BUGS
 The main strength of
 .Nm learn ,
 .Sh BUGS
 The main strength of
 .Nm learn ,

-that it asks the student to use the real UNIX,
+that it asks the student to use the real
+.Ux ,

 also makes possible baffling mistakes.
 It is helpful, especially for nonprogrammers,
 also makes possible baffling mistakes.
 It is helpful, especially for nonprogrammers,

-to have a UNIX initiate near at hand during the first
+to have a
+.Ux
+initiate near at hand during the first

 sessions.
 .Pp
 Occasionally lessons are incorrect, sometimes because the local version
 sessions.
 .Pp
 Occasionally lessons are incorrect, sometimes because the local version


@@ -140,8 +158,12 @@ of subject indexing is better than none.
 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.
+The
+.Xr \&vi
+lessons are provided separately from the others.

 To use them see your system administrator.
 .Sh HISTORY
 To use them see your system administrator.
 .Sh HISTORY

-.Nm Learn
-appeared in Version 32 AT&T Unix.
+The
+.Nm learn
+command appeared in
+.At 32v .