home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / TOP / USR / MAN / notes.man < prev    next >
Text File  |  2009-11-06  |  9KB  |  331 lines
  1.  
  2.  
  3.  
  4.      NOTES(1)       University of Illinois (May 10, 1986)      NOTES(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.       notes, autoseq, readnotes - a    news system
  10.  
  11.      SYNOPSIS
  12.       notes    [ -sxin    ] [ -o date-spec ] [ -a    subsequencer ] [ -t
  13.       termtype ] [ -f file ] topic1    [ ... ]
  14.  
  15.       autoseq [ -a subsequencer ]
  16.  
  17.       readnotes [ -a subsequencer ]
  18.  
  19.      DESCRIPTION
  20.       Notes    supports computer managed discussion forums.  It
  21.       coordinates access to    and updates of data bases of notes and
  22.       their    responses.  A single notesfile contains    an ordered
  23.       list of base notes, each of which may    have an    ordered    list
  24.       of responses associated with it.  A note string consists of
  25.       a base note and all of its responses.     Separate notesfiles
  26.       contain discussions on separate subject matters;
  27.       microcomputers might be discussed in a ``micronotes''
  28.       notesfile while bicycling enthusiasts    make their comments in
  29.       a ``bicycle''    notesfile.
  30.  
  31.       The -s option    signals    notes to use the automatic sequencer.
  32.       With the sequencer enabled, notes shows the new notes    and
  33.       responses since your last entry into that notesfile.    With
  34.       the sequencer    enabled    by -s the notes    program    will not enter
  35.       notesfiles which have    no new text.  Specify -x to use    the
  36.       sequencer and    enter notesfiles even if they have no new
  37.       text.     The -i    and -n options are still more sequencing
  38.       modes, -i is similar to -s but shows the index page instead
  39.       of the first modified    note.  -n turns    the sequencer off.
  40.  
  41.       The -o option    helps users find articles that are vaguely
  42.       remembered with terms    such as    ``some note in the last    3 days
  43.       in one of several notesfiles''.  These can be    found with a
  44.       command like:
  45.  
  46.            notes -o    "3 days    ago" nf1 nf2 nf3
  47.  
  48.       which    sequences past all articles written in notesfiles
  49.       ``nf1'', ``nf2'', and    ``nf3''    in the last 3 days.  The
  50.       user's timestamps are    not updated.
  51.  
  52.       The -a option    specifies a subsequencer.  This    allows several
  53.       people sharing the same signon to maintain their own
  54.       sequencer file.  The actual sequencer    name is    generated by
  55.       concatenating    the user name and the subsequencer name.  It
  56.       is recommended that subsequencer names be unique within the
  57.       first    6 characters.
  58.  
  59.       Specify -t termtype to override the TERM environment
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 2/25/88)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      NOTES(1)       University of Illinois (May 10, 1986)      NOTES(1)
  71.  
  72.  
  73.  
  74.       variable.  This switch is primarily for V6 systems.
  75.  
  76.       The -f option    directs    notes to read the contents of a    file
  77.       for a    list of    notesfiles to scan.  This file and the
  78.       directories must be readable by the notesfile    user id.
  79.  
  80.       The topic list specifies which notesfiles are    to be scanned.
  81.       The notesfiles are scanned from left to right; upon
  82.       finishing the    first topic, the second    is entered.  The
  83.       shell's meta-characters are recognized within    a topic    but
  84.       must be escaped to prevent shell interpretation.  Specifying
  85.       ``net.*'' will yield all the notesfiles with the prefix
  86.       ``net.''.  Specify ``*unix*''    to read    all notesfiles with
  87.       the string ``unix'' in their names.  Bracket and question
  88.       mark constructs are also recognized.
  89.  
  90.       Notesfile names are parsed such that a notesfile will    be
  91.       entered only once no matter how many times it    is listed on
  92.       the command line and in any files specified by the -f
  93.       option.  Notesfiles can also be excluded by prefixing    their
  94.       names    with a `!'.  Thus to see all notesfiles    except
  95.       ``general'', one might type:
  96.  
  97.            notes "*" !general
  98.  
  99.  
  100.       The autoseq and readnotes commands allow sequencing through
  101.       a list of notesfiles with the    sequencer enabled using    with a
  102.       single command.  Autoseq and Readnotes function identically.
  103.       They are syntactically equivalent to ``notes -s $NFSEQ''.
  104.       The environment variable NFSEQ contains a comma separated
  105.       list of notesfile specifications.  A typical NFSEQ
  106.       definition for the Bourne shell looks    like:
  107.  
  108.       NFSEQ=``general,announce,net.*,bicycle,srg,:/usr/essick/nflist''.
  109.  
  110.       Specifications beginning with    a `:' specify a    file to    read
  111.       for more notesfile names.  In    the previous example, the last
  112.       specification    reads the contents of the file
  113.       `/usr/essick/nflist' for more    notesfile specifications.
  114.       Many of these    can appear in the NFSEQ    variable.
  115.  
  116.       Notes    and responses are entered by using an editor. The
  117.       default editor is ed(1).  This can be    changed    by setting one
  118.       of the environment variables NFED or EDITOR. Notes looks for
  119.       NFED before looking for EDITOR, allowing users to use
  120.       different editors for    writing    notes and for other tools.
  121.  
  122.       Some commonly    used commands within the notesfile system are
  123.       listed below:
  124.  
  125.       space        Show the next page of the note/response.
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 2/25/88)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      NOTES(1)       University of Illinois (May 10, 1986)      NOTES(1)
  137.  
  138.  
  139.  
  140.       ;        Go the next    response, if there are no more
  141.             responses go to the    next note.
  142.  
  143.       -        Go to the previous page of the current
  144.             note/response.  From the first page    of a response,
  145.             go to the previous response    (or the    base note from
  146.             the    first response).  From the first page of a
  147.             base note, go to the previous note.
  148.  
  149.       newline   Go to the next note.
  150.  
  151.       j        Jump to the    next unread note/response (when    using
  152.             sequencer).
  153.  
  154.       J        Jump to the    next unread note, ignoring any further
  155.             responses in the current note string (when using
  156.             sequencer).
  157.  
  158.       w        When issued    from the index page enters a new note.
  159.             When entered from a    note/response display enters a
  160.             response.  A capital-W will    include    the text of
  161.             the    currently displayed note/response in the new
  162.             response.
  163.  
  164.       q        Leave the current notesfile.
  165.  
  166.       Q        Leave the current notesfile    without    updating the
  167.             sequencer information.
  168.  
  169.       control-d Return to the shell, ignoring any further
  170.             notesfiles in the current invocation. No sequencer
  171.             information    is updated.
  172.  
  173.       x        Search for a note with the (prompted for) string
  174.             in its title.  Capital-X asks for a    new search
  175.             string, otherwise the last entered string is used.
  176.  
  177.       s        Saves the currently    displayed note/response    at the
  178.             end    of a (prompted for) file.  Capital-S saves the
  179.             entire note    string.
  180.  
  181.       M        Sends the text of the note/response    displayed and
  182.             your comments  to another user(s).    The P command
  183.             routes the letter to the author of the
  184.             note/response.
  185.  
  186.       t        Issues a write(1) command to the author of the
  187.             currently displayed    note/response.    No action is
  188.             taken if the note originated on a remote system or
  189.             is anonymous.
  190.  
  191.       !        Forks a shell.
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 2/25/88)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      NOTES(1)       University of Illinois (May 10, 1986)      NOTES(1)
  203.  
  204.  
  205.  
  206.       Only the notesfile owner can create new notesfiles.  The
  207.       notesfile owner will create the notesfile and    turn control
  208.       over to the person requesting    the notesfile.    This person is
  209.       the notesfile    director; he may designate others to also be
  210.       notesfile directors. The notesfile director has special
  211.       privileges including:     deleting any note, determining    policy
  212.       for the notesfile, permitting    anonymous notes, and
  213.       determining accessibility of the notesfile.
  214.  
  215.       An interface is provided to news(1).    Transfers in both
  216.       directions are supported.  See newsoutput(8) and the
  217.       Notesfile Reference Manual for more information on this
  218.       facility.
  219.  
  220.       Facilities for mailing to notesfiles ( nfmail(8) ),
  221.       networking notesfiles    ( nfxmit(8) ), printing    notesfiles (
  222.       nfprint(1) ),    archiving old notes ( nfarchive(8) ), and
  223.       several user routines    ( nfabort(3) and nfcomment(3) )    exist.
  224.  
  225.       The concept of a notesfile was taken from the    PLATO system
  226.       (a trademark of Control Data Corporation) designed at    the
  227.       University of    Illinois to provide automated teaching
  228.       capabilities.
  229.  
  230.      FILES
  231.       /etc/passwd                       for the users
  232.                                name
  233.       /etc/group                       for the users
  234.                                group(s)
  235.       /etc/termcap                       for terminal
  236.                                capabilites
  237.       /usr/spool/notes                   the default
  238.                                notesfile data
  239.                                base
  240.       /usr/spool/notes/.utilities               utility
  241.                                programs    and
  242.                                online help
  243.       /usr/spool/notes/.sequencer/user           Sequencing
  244.                                timestamps for
  245.                                user.
  246.       /usr/spool/notes/.sequencer/user:subsequencer
  247.                                Sub-sequencing
  248.                                timestamps for
  249.                                user.
  250.  
  251.      SEE ALSO
  252.       checknotes(1), ed(1),    mknf(8), news(1), newsoutput(8),
  253.       nfabort(3), nfaccess(8), nfarchive(8), nfmail(8), nfpipe(1),
  254.       nfprint(1), nfstats(1), nfxmit(8), nfcomment(3), notes(8),
  255.       termcap(3), write(1),
  256.       The Notesfile    Reference Manual
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 2/25/88)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      NOTES(1)       University of Illinois (May 10, 1986)      NOTES(1)
  269.  
  270.  
  271.  
  272.      AUTHORS
  273.       Ray Essick (uiucdcs!essick, essick%uiuc@csnet-relay.arpa)
  274.       Department of    Computer Science
  275.       University of    Illinois at Urbana-Champaign
  276.       Urbana, IL
  277.  
  278.       Rob Kolstad (kolstad@convex.UUCP)
  279.       CONVEX Computer Corporation
  280.       Richardson, TX
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                         (printed 2/25/88)
  328.  
  329.  
  330.  
  331.