Return to README CVS log

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

Annotation of 43BSDTahoe/usr.bin/learn/README, revision 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.