[news.software.anu-news] NEWS V5.9C diff 17/21

gih900@csc.anu.oz (Geoff Huston) (12/21/89)

+-+-+-+ Beginning of part 17 +-+-+-+
X   if required rather than complete the NEWS posting.
X `032
X+ /NETFEED
X+  /NETFEED   [default]
X+  /NONETFEED
X+`032
X+  The default action of NEWS is to assume that all items added by the ADD
X+  command are network news items, and should be forwarded to NEWS network
X+  neighbours (as specified by the SYS and DISTRIBUTION files). /NONETFEED
X+  inhibits the forwarding of ADDed items to neighbours. /NETFEED is the
X+  default
X+`032
X+ /NEWSGROUP
X+  /NEWSGROUP=newsgroup
X+`032
X+  This directs the NEWS parser to place all items into the nominated
X+  newsgroup (regardless of whether the item contains a "Newsgroups:"
X+  header line). This qualifier is useful when converting messages from
X+  a mailing list into a newsgroup. For example:
X+`032
X+     $ MAIL
X+     MAIL> set folder CMU_TCPIP
X+     MAIL> extract/all tcp.mail
X+     MAIL> delete/all
X+     MAIL> exit
X+     $ NEWS/NOSCREEN
X+     NEWS> add file tcp.mail/news=anu.tcpip
X+`032
X+ /NOCONTROL
X+`032
X+  When specified, this qualifier inhibits the interpretation of the Control:
X+  header in ADDed items by NEWS.
X+`032
X+  The default behaviour of NEWS is to interpret all Control: headers.
X+`032
X  /RETRY
X   /RETRY
X   /NORETRY [default]
X**************
X*** 487,495
X   place for a number of reasons, but the primary one is that the NEWS.SYS
X   file has rejected this item. You may wish to make changes to the SYS file
X   and retry adding the item. Normally such an attempt would be rejected, as
X!  the Path: name now contains the local node name, and this is regarded as
X!  a loop in the news. /RETRY directs the ADD command to ignore the Path:
X!  line when checking the news item for addition into the local node.
X `032
X  2 MARKER
X `032
X--- 562,571 -----
X   place for a number of reasons, but the primary one is that the NEWS.SYS
X   file has rejected this item. You may wish to make changes to the SYS file
X   and retry adding the item. Normally such an attempt would be rejected, as
X!  the Path: item has now been stamped with the local node name, indicating
X!  that the local system has already seen this item. /RETRY directs the ADD
X!  command to ignore the Path: header line when checking the news item for
X!  addition into the local node.
X `032
X  2 MARKER
X `032
X**************
X*** 498,504
X `032
X   ADD MARKER places a mark against the current newsitem. This item can be
X   selected at a later stage by the READ/MARK or SELECT/MARK commands, or
X!  printed by the PRINT/MARK command.
X `032
X   If no marker-name value is specified then the default value, "mark" is
X   used. A marker name is a string.
X--- 574,581 -----
X `032
X   ADD MARKER places a mark against the current newsitem. This item can be
X   selected at a later stage by the READ/MARK or SELECT/MARK commands, or
X!  printed by the PRINT/MARK command. Marks are on a user-by-user basis,
X!  and system-wide marks are not supported in NEWS.
X `032
X   If no marker-name value is specified then the default value, "mark" is
X   used. A marker name is a string. If no item number is specified, the
X**************
X*** 501,507
X   printed by the PRINT/MARK command.
X `032
X   If no marker-name value is specified then the default value, "mark" is
X!  used. A marker name is a string.
X `032
X   If no item number is specified, the mark is placed against the current
X   item.
X--- 578,585 -----
X   and system-wide marks are not supported in NEWS.
X `032
X   If no marker-name value is specified then the default value, "mark" is
X!  used. A marker name is a string. If no item number is specified, the
X!  mark is placed against the current item.
X `032
X   Example:
X `032
X**************
X*** 503,510
X   If no marker-name value is specified then the default value, "mark" is
X   used. A marker name is a string.
X `032
X!  If no item number is specified, the mark is placed against the current
X!  item.
X `032
X  2 MEMBER
X `032
X--- 581,587 -----
X   used. A marker name is a string. If no item number is specified, the
X   mark is placed against the current item.
X `032
X!  Example:
X `032
X  `009ADD MARKER "comms"
X          will mark the current item with the tag "comms"
X**************
X*** 506,512
X   If no item number is specified, the mark is placed against the current
X   item.
X `032
X! 2 MEMBER
X `032
X   ADD MEMBER is a NEWS MANAGEMENT command.
X `032
X--- 583,590 -----
X `032
X   Example:
X `032
X! `009ADD MARKER "comms"
X!         will mark the current item with the tag "comms"
X `032
X  2 MEMBER
X `032
X**************
X*** 508,513
X `032
X  2 MEMBER
X `032
X   ADD MEMBER is a NEWS MANAGEMENT command.
X `032
X   Format:
X--- 586,594 -----
X  `009ADD MARKER "comms"
X          will mark the current item with the tag "comms"
X `032
X+ 2 MEMBER
X+`032
X+  *MANAGEMENT COMMAND*
X   ADD MEMBER is a NEWS MANAGEMENT command.
X `032
X   Format:
X**************
X*** 518,525
X   the newsgroup, and by default also grants write access.
X `032
X   The username may include wildcard characters ('%','*') to include a set
X!  or related usernames, or may be an identifier name. If either of these
X!  specifications are used it is advised not to include the /MAIL or /NODES
X   parameters to the command.
X `032
X   The newsgroup must have been set as a restricted newsgroup for this
X--- 599,607 -----
X   the newsgroup, and by default also grants write access.
X `032
X   The username may include wildcard characters ('%','*') to include a set
V!  or related usernames. An identifier name may be used instead of a username
X,
X!  in which case all owners of that identifier are included. If wildcards or
X!  identifier names are used it is advised not to include the /MAIL or /NODES
X   parameters to the command.
X `032
X   The newsgroup must have been set as a restricted newsgroup for this
X**************
X*** 526,532
X   command to be executed, and the user must be either the local News
X   Manager, or the supervisor of this newsgroup.
X `032
X! 3 Parameters
X `032
X  /MAIL
X   /MAIL=mail_address
X--- 608,614 -----
X   command to be executed, and the user must be either the local News
X   Manager, or the supervisor of this newsgroup.
X `032
X! 3 Qualifiers
X `032
X  /MAIL
X   /MAIL=mail_address
X**************
X*** 532,538
X   /MAIL=mail_address
X `032
X   Specifies a mail address for this member. The address format may be
X!  either a VMS MAIL or an internet format address.
X `032
X  /NODES
X   /NODES=(node-name[,...]_
X--- 614,620 -----
X   /MAIL=mail_address
X `032
X   Specifies a mail address for this member. The address format may be
X!  either a VMS MAIL or an Internet format address.
X `032
X  /NODES
X   /NODES=(node-name[,...]_
X**************
X*** 557,563
X `032
X  1 ANSWER
X `032
X!  See the Subtopic FOLLOWUP
X `032
X  1 ATTACH
X `032
X--- 639,645 -----
X `032
X  1 ANSWER
X `032
X!  See the Topic FOLLOWUP
X `032
X  1 ATTACH
X `032
X**************
X*** 578,584
X `032
X  2 REPLY
X `032
X!  BACK REPLY is equivalant to READ/PARENT, displaying the previous entry in
X   the same conversation stream as the current item.
X `032
X  2 NOTE
X--- 660,666 -----
X `032
X  2 REPLY
X `032
X!  BACK REPLY is equivalent to READ/PARENT, displaying the previous entry in
X   the same conversation stream as the current item.
X `032
X  2 NOTE
X**************
X*** 595,605
X `032
X  /EDITOR
X `032
X!  Use a callable editor in read-only mode to display the newsitem. By
X!  default this is the TPU editor, but this may be altered by the NEWS_VIEW
X!  logical name. See the Subtopic Logical_Names for details. For
X!  compatibility with previous versions of NEWS, /TPU is equivaluent to
X!  /EDITOR.
X `032
X  /ROT13
X `032
X--- 677,683 -----
X `032
X  /EDITOR
X `032
X!  Use a text editor in read-only mode to display the newsitem.
X `032
X  /ROT13
X `032
X**************
X*** 609,615
X  1 BOTTOM
X `032
X   This command moves the screen display to the end of the display screen.
X!  The command is invoked by the key sequence PF1 - NextScreen.
X `032
X  1 CANCEL
X `032
X--- 687,693 -----
X  1 BOTTOM
X `032
X   This command moves the screen display to the end of the display screen.
X!  The command is invoked by the key sequence Gold (PF1) - NextScreen.
X `032
X  1 CANCEL
X `032
X**************
X*** 622,629
X   user as the user issuing the cancel command.
X `032
X   This restriction is lifted slightly for the local NEWS Manager, and the
X!  supervisor of the newsgroup, who can cancel ANY item posted from the local
X!  node.
X `032
X   There are no parameters to this command - CANCEL deletes the current
X   news item. The user is prompted for confirmation before the command
X--- 700,707 -----
X   user as the user issuing the cancel command.
X `032
X   This restriction is lifted slightly for the local NEWS Manager, and the
X!  local supervisor of the newsgroup, who can cancel ANY item that has been
X!  posted from the local node.
X `032
X   There are no parameters to this command - CANCEL deletes the current
X   news item. The user is prompted for confirmation before the command
X**************
X*** 684,690
X  1 COMPRESS
X `032
X    COMPRESS is a command which refers to MAIL, and is may be used
X!   once the MAIL file is opened by  the OPEN MAIL command.
X `032
X    When you compress a file, the following four steps occur:
X `032
X--- 762,768 -----
X  1 COMPRESS
X `032
X    COMPRESS is a command which refers to MAIL, and is may be used
X!   once the MAIL file is opened within NEWS by the OPEN/MAIL command.
X `032
X    When you compress a file, the following four steps occur:
X `032
X**************
X*** 700,706
X     4  The newly compressed file is renamed from
X        MAIL_nnnn_COMPRESS.TMP back to its original name.
X `032
X-    Format:
X `032
X           COMPRESS
X `032
X--- 778,783 -----
X     4  The newly compressed file is renamed from
X        MAIL_nnnn_COMPRESS.TMP back to its original name.
X `032
X `032
X  1 CREATE
X `032
X**************
X*** 702,710
X `032
X     Format:
X `032
X-          COMPRESS
X-`032
X-`032
X  1 CREATE
X `032
X  2 CONFERENCE
X--- 779,784 -----
X        MAIL_nnnn_COMPRESS.TMP back to its original name.
X `032
X `032
X  1 CREATE
X `032
X  2 CONFERENCE
X**************
X*** 717,722
X `032
X  2 NEWSGROUPS
X `032
X   CREATE NEWSGROUPS is a NEWS MANAGEMENT Command.
X `032
X   Format:
X--- 791,797 -----
X `032
X  2 NEWSGROUPS
X `032
X+  *MANAGEMENT COMMAND*
X   CREATE NEWSGROUPS is a NEWS MANAGEMENT Command.
X `032
X   Format:
X**************
X*** 727,733
X `032
X  2 Parameters
X `032
X! newsgroup
X `032
X   This parameter is the name of the newsgroup to create. If the newsgroup
X   does not exist on the local node, then the user is prompted to confirm
X--- 802,808 -----
X `032
X  2 Parameters
X `032
X! Newsgroup
X `032
X   This parameter is the name of the newsgroup to create. If the newsgroup
X   does not exist on the local node, then the user is prompted to confirm
X**************
X*** 738,744
X `032
X  2 Qualifiers
X `032
X! /CACHE
X `032
X   Format:
X `032
X--- 813,821 -----
X `032
X  2 Qualifiers
X `032
X! /APPROVAL
X!  /APPROVAL   [default]
X!  /NOAPPROVAL
X `032
X   Moderated newsgroups require an Approved: header in all postings in order
X   to be accepted by each local NEWS site. This approval requirement can be
X**************
X*** 740,745
X `032
X  /CACHE
X `032
X   Format:
X `032
X      CREATE NEWSGROUP newsgroup/SERVER=node/PROTO=TCP/CACHE=3
X--- 817,830 -----
X   /APPROVAL   [default]
X   /NOAPPROVAL
X `032
X+  Moderated newsgroups require an Approved: header in all postings in order
X+  to be accepted by each local NEWS site. This approval requirement can be
X+  removed by specifying the /NOAPPROVAL qualifier with the newsgroup.
X+`032
X+ /CACHE
X+  /CACHE=2   [default]
X+  /NOCACHE
X+`032
X   Format:
X `032
X      CREATE NEWSGROUP newsgroup/SERVER=node/PROTO=TCP/CACHE=3
X**************
X*** 745,752
X      CREATE NEWSGROUP newsgroup/SERVER=node/PROTO=TCP/CACHE=3
X `032
X   This qualifier is used to specify the retention period of the local
X!  item cache. This cache is used if the newsgroup is defined as a
X!  servered newsgroup. /NOCACHE disables all caching.
X `032
X  /HOLD
X `032
X--- 830,837 -----
X      CREATE NEWSGROUP newsgroup/SERVER=node/PROTO=TCP/CACHE=3
X `032
X   This qualifier is used to specify the retention period of the local
X!  item cache. This cache is used if the newsgroup is defined as an
X!  NNTP-served newsgroup. /NOCACHE disables all caching.
X `032
X  /CONFIRM
X   /CONFIRM   [default]
X**************
X*** 748,754
X   item cache. This cache is used if the newsgroup is defined as a
X   servered newsgroup. /NOCACHE disables all caching.
X `032
X! /HOLD
X `032
X   Format:
X `032
X--- 833,841 -----
X   item cache. This cache is used if the newsgroup is defined as an
X   NNTP-served newsgroup. /NOCACHE disables all caching.
X `032
X! /CONFIRM
X!  /CONFIRM   [default]
X!  /NOCONFIRM
X `032
X   Normally NEWS will require confirmation in order to create new newsgroups.
X   The /NOCONFIRM qualifier overrides this requirement.
X**************
X*** 750,755
X `032
X  /HOLD
X `032
X   Format:
X `032
X    CREATE NEWSGROUP newsgroup/HOLD=n
X--- 837,847 -----
X   /CONFIRM   [default]
X   /NOCONFIRM
X `032
X+  Normally NEWS will require confirmation in order to create new newsgroups.
X+  The /NOCONFIRM qualifier overrides this requirement.
X+`032
X+ /HOLD
X+`032
X   Format:
X `032
X    CREATE NEWSGROUP newsgroup/HOLD=n
X**************
X*** 760,766
X   deleted. If not specified, the system default value is used.
X `032
X   If the value "/HOLD=*" is used, the newsgroup will NOT be automatically
X!  deleted.
X `032
X  /INQUIRE
X `032
X--- 852,859 -----
X   deleted. If not specified, the system default value is used.
X `032
X   If the value "/HOLD=*" is used, the newsgroup will NOT be automatically
X!  deleted. It is recommended that network-newsgroups be initially set up
X!  with a /HOLD=* value.
X `032
X  /INQUIRE
X `032
X**************
X*** 771,777
X      CREATE NEWSGROUP anu.*/SERVER=node/PRTO=TCP/INQUIRE
X `032
X   This command interrogates the remote system and creates local newsgroups
X!  which do not already exist on the loca system. The user is prompted
X   for each newsgroup before it is created.
X `032
X   If no newsgroup is specified, then all newsgroups on the remote system
X--- 864,870 -----
X      CREATE NEWSGROUP anu.*/SERVER=node/PRTO=TCP/INQUIRE
X `032
X   This command interrogates the remote system and creates local newsgroups
X!  which do not already exist on the local system. The user is prompted
X   for each newsgroup before it is created.
X `032
X   If no newsgroup is specified, then all newsgroups on the remote system
X**************
X*** 789,795
X   for the specified period, after which they will be automatically deleted.
X `032
X   If the value "/ITEMHOLD=*" is used, NO items within the newsgroup will
X!  be automatically deleted.
X `032
X  /LOCAL
X `032
X--- 882,890 -----
X   for the specified period, after which they will be automatically deleted.
X `032
X   If the value "/ITEMHOLD=*" is used, NO items within the newsgroup will
-+-+-+-+-+ End of part 17 +-+-+-+-+-