.\" $OpenBSD: learn.1,v 1.7 2007/05/31 19:20:12 jmc Exp $
.\"
.\" Copyright (c) 1998 Ian Darwin
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd $Mdocdate: May 31 2007 $
.Dt LEARN 1
.Os
.Sh NAME
.Nm learn
.Nd computer based learning
.Sh SYNOPSIS
.Nm learn
.Op lesson
.Sh DESCRIPTION
This is a resurrection of the learn command from V7 UNIX, circa 1979.
The program works fine, but many of the lessons are quite antiquated.
It remains for others to write new lessons describing current
versions of UNIX-like systems.
.Sh FILES
.Bl -tag -width "/usr/libdata/learn/*" -compact
.It Pa /usr/libdata/learn/*
lesson files
.It Pa /tmp/pl*
playground directory created for each invocation, removed at end of run
.El
.Sh SEE ALSO
Learn \- Computer-Aided Instruction on UNIX,
(Second Edition), Brian W. Kernighan and Michael E. Lesk.
January 30, 1979
.Pp
The version described there created the "play" directory for each
user under the lesson file directory; this version creates
a directory under
.Pa /tmp
for each user.
.Sh HISTORY
The program originated in Seventh Edition UNIX.
A lightly revised version of the program was released by
Lucent/Bell Laboratories in 1997, and
modernized for
.Ox 2.4
by Ian Darwin, who also wrote this man page, and Paul Janzen.
.Sh BUGS
The lessons need updating. There should be lessons on awk, sed,
perl, shell, and other scripting languages.
.Pp
There is no way to drive a screen-based program such as vi or emacs.
.Pp
Could do a better job of displaying the text. Maybe curses?
Or maybe the text should be re-written in HTML?
.Pp
Perhaps the lesson file should be reorganized so that all the lessons
for each topic are in one large file instead of so many tiny ones.