xref: /csrg-svn/usr.bin/learn/README (revision 11269)
1*11269Smckusick@(#)README	4.1	(Berkeley)	83/02/24
2*11269Smckusick
3*11269SmckusickThe C script is not complete; use at your own risk.
4*11269Smckusick
5*11269SmckusickLessons are in
6*11269Smckusick	/usr/lib/learn/*
7*11269SmckusickSource is in
8*11269Smckusick	/usr/src/cmd/learn
9*11269SmckusickMiscellaneous supporting code is also in source.
10*11269Smckusick
11*11269SmckusickMake a learn by
12*11269Smckusick	make
13*11269SmckusickWhen this seems right, extract the lessons by
14*11269Smckusick	make lessons
15*11269SmckusickThis extracts the lesson archives
16*11269Smckusickfor each course.  You can also do this one step at a
17*11269Smckusicktime with "make files", "make editor", etc.,
18*11269Smckusickif you don't want all courses.
19*11269SmckusickIf you do things separately, you must also say
20*11269Smckusick	make play; make log
21*11269Smckusick
22*11269SmckusickFinally, check that it's sensible with
23*11269Smckusick	make check
24*11269SmckusickIf that doesn't print any messages,
25*11269Smckusickyou're probably in good shape.
26*11269Smckusick
27*11269SmckusickLearn requires general write permission on the user playpen
28*11269Smckusickdirectory .../lib/play.  Lesson directories may be protected.
29*11269Smckusick
30*11269SmckusickLearn collects a log file for each script in the .../lib/log
31*11269Smckusickdirectory, with a file for each script (files,
32*11269Smckusickeditor, etc.) containing an entry for each lesson
33*11269Smckusickattempted. These files will grow without bound,
34*11269Smckusickunless they are periodically truncated.
35*11269SmckusickThe log files should have general write permission.
36*11269SmckusickIf you don't want logging (a sensible position to take),
37*11269Smckusickset the variable "logging" to zero in source/lrndef
38*11269Smckusickbefore making learn.
39*11269Smckusick
40*11269SmckusickLearn requires about 1500 blocks to make itself,
41*11269Smckusickand about 1000 when completely made.
42*11269Smckusick
43*11269SmckusickPlease report problems, bad lessons, etc., to
44*11269SmckusickBrian Kernighan, MH 6021, 2C-518, or
45*11269SmckusickMike Lesk, MH 6377, 2C-572.  Thanks.
46