Return to README CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / learn

Annotation of 43BSDReno/usr.bin/learn/README, revision 1.1.1.1

1.1       root        1: Important changes since 4.2:
                      2:        Now uses 4.2 filesystem correctly and removes files between lessons.
                      3:        Tee'd output to the .ocopy file works.  No more infinite loop on EOF.
                      4:        Now maintains a .learnrc file to start you where you left off last
                      5:        session.  The undocumented and dubious "xyzzy" command has become
                      6:        the documented and dubious "hint" command.  Miscellaneous typos.
                      7: 
                      8: Note that play directories are created in /tmp, no longer
                      9: in /usr/lib/learn/play.  The C script is not complete;
                     10: use at your own risk.  The editor script still smacks of ed.
                     11: 
                     12: Lessons are in (vi lessons are on user-contributed-software tape)
                     13:        /usr/lib/learn/*
                     14: and auxilliary programs are in
                     15:        /usr/lib/learn/bin
                     16: 
                     17: Lesson directories may be protected.
                     18: 
                     19: Learn keeps a log file for each script in the .../learn/log
                     20: directory (files, editor, etc.) containing an entry for each
                     21: lesson attempted.  These files will grow without bound,
                     22: unless they are periodically truncated. 
                     23: The log files should have general write permission.
                     24: If you don't want logging (a sensible position to take),
                     25: set the variable "logging" to zero in source/learn.c
                     26: before making learn, or remove the log directory, or just
                     27: turn off write permission for a particular log file.
                     28: 
                     29: Learn requires about 1500 blocks to make itself,
                     30: and about 1000 when completely made.
                     31: 
                     32: The best way to get ex to prompt within learn was to modify
                     33: the user's environment variables PATH and EXINIT.
                     34: 
                     35: Due to inane assumptions in the VAX versions of csh -i and ex
                     36: when stdin and stdout are not terminals, kludges have been
                     37: added with #if's.  In particular, I use the old terminal driver
                     38: to keep #copyout working and make sh -i masquerade as
                     39: a csh -i (by setting PS1=% ) to keep #pipe working.
                     40: 
                     41: "#create" can now end in an incomplete last line by making '#'
                     42: the last character on the line.  On input the string %s is
                     43: converted to the lesson directory (useful for debugging).
                     44: On output with "#copyout", prompt signs ("% ") are removed.
                     45: "#cmp" now takes a trailing NUMBER specifying that only NUMBER
                     46: many lines are to be compared.
                     47: 
                     48: The new command "hint" prints the "answer" (i.e. the last part
                     49: of the lesson).  With an argument it prints the whole lesson text.
                     50: A new routine called getlesson tries to construct a valid
                     51: lesson number from in invalid one before giving up.
                     52: The commands "where", "skip", and "again" are also new.
                     53: Greeting, closing, and reminder messages have been expanded.
                     54: 
                     55: The "vi" lessons are packaged separately as part of the user-
                     56: contributed software.  Ask the system administrator to install them.
                     57: 
                     58: Please report problems, bad lessons, contributions, etc.,
                     59: to John Kunze, [email protected].  Thanks.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.