Return to learn.1 CVS log

Up to [local] / src / usr.bin / learn / src

- remove trailing white space
- remove arguments from .Os macros
- remove arguments from .Nm macros, where appropriate
- some more Dq/Sq/Ql insanity
- still lots to do in the usr.bin tree... :/

.\" $OpenBSD: learn.1,v 1.4 1999/06/05 01:21:36 aaron Exp $
.\"
.\" Copyright (c) 1998 Ian Darwin
.\"
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"		This product includes software developed by Ian Darwin.
.\" 4. The author's name may not be used to endorse or promote products
.\"    derived from this software without specific prior written permission.
.\"
.\" 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 January 30, 1979
.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 OpenBSD 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.