Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ATP(1)			   ATP QWK Mail/News Reader			ATP(1)

NAME
       atp - read, reply, and archive QWK format mail packets.

SYNOPSIS
       atp bbsname[.qwX]

       where  bbsname  is  the	name of	the QWK	packet with extension omitted.
       The long	form uses bbsname.qwX where X is any valid filename character,
       typically the letter `k'	or a digit in the range	`0' to `9'.

DESCRIPTION
       ATP  is used for	reading	and replying to	messages contained in QWK mail
       packets which are available through public access bulletin boards.  ATP
       evolved from an earlier reader written by Rene Cougnenc which he	called
       `AzerTyuioP' (the name `AzerTyuioP' is the top row of keys on a	French
       typewriter).   ATP has greatly enhanced and expanded upon the function-
       ality of	its predecessor. But like its predecessor, ATP	still  may  be
       compiled	 for  the  French language. German is now also supported.  ATP
       includes	the Rich Salz and Simmule Turner Emacs-style command line edi-
       tor with	command	history. Note that this	is covered by a	separate copy-
       right.

       A BBS will typically carry topical news conferences. A user may dial up
       a BBS, start a program know as a	mail door, and quickly gather the cur-
       rent news into a	file called a ``QWK packet.'' Once this	file is	 down-
       loaded, an offline mail reader such as ATP processes it for reading and
       replying	at one's leisure.  There are several formats for offline  mail
       packets	but  QWK is the	most common. Some of the more popular QWK mail
       doors which produce these packets are Qmail, Markmail, Jimmer, and TQM.
       ATP  can	 handle	QWK packets produced by	any of these doors so there is
       no need to worry	which one to use.

       When started, ATP will present you with a command prompt.  This	prompt
       will  show  the	current	active BBS and the conference. At any time you
       may type	`help' at the command prompt to	receive	a summary of commands.
       ATP  also  functions  as	a mini-shell allowing you to enter many	common
       Unix commands at	the prompt.

FEATURES
       In addition to reading and replying to mail, ATP	maintains archives  of
       past  messages.	These  can be reviewed at any time. As new QWK packets
       are loaded, they	are immediately	added to the archives. Pointers	to the
       last  read  messages are	maintained. Loading a new mail packet will not
       reset these pointers. Reading will resume with the last read message in
       each  conference.  By  entering	a number at the	command	line, ATP will
       move to that message number and display it. In this way	you  can  move
       backward	 and forward among the messages	at will. Typing	`reset'	resets
       the the message pointer,	marking	the current message as the  last  mes-
       sage  read.   The  `clean'  command provides a means of maintaining and
       pruning message bases.

       ATP will	support	8192 conferences per BBS. The limit is set  for	 back-
       ward  compatibility  with  some	older  mail doors. You may change this
       limit by	recompiling ATP	should the need	arise.	Your tagline file  can
       hold  many  thousands  of  taglines, essentially	no limit for most pur-
       poses.  Taglines	are stored in a	the plain text file taglines.atp.

       Other features include the ability to scan message headers,  a  tagline
       management system, support for FIDO or regular style taglines, personal
       mail notification and personal mail conference, the ability  to	search
       messages	 for  strings,	a  separate  conference	 for replies, kill and
       change security on replies, tagline selection by	random,	automatic,  or
       direct means, hooks for a spelling checker, powerful command line edit-
       ing with	history	recall.

ENVIRONMENT
       ATP looks for three environment variables: SHELL, HOME, and  ATP.   The
       SHELL  environment variable must	reflect	the path to your command shell
       (under MSDOS and	OS/2 this path would be	called COMSPEC instead).   The
       HOME  environment variable points to your home directory.  Some command
       processors will automatically set SHELL and HOME	for you.  The ATP  en-
       vironment  variable should be the full path to a	subdirectory where ATP
       will store its configuration files, normally a subdirectory under  your
       home  directory.	 Use a descriptive name	such as	`atpmail' or `qwkmail'
       for this	directory. As you probably know,  environment  variables  most
       often  are  set	by adding entries to your command shell's startup file
       (.e.g.  .profile	or autoexec.bat).

CONFIGURATION
       Before using ATP	for the	first time, you	will have to edit its configu-
       ration  file which you may call either .atprc or	atprc.	This file con-
       tains a list of information which tells ATP where  to  find  your  mail
       packets,	 what  editor  to invoke for entering messages,	how many lines
       your screen has.	Below is a typical configuration file.	 IMPORTANT!  A
       space must reside on either side	of the `=' sign	for correct parsing to
       take place. After you have edited your atprc configuration file,	 don't
       forget  to  put it in the same directory	as pointed to by the ATP envi-
       ronment variable, or your home directory. If you	 have  a  Perl	inter-
       preter  installed  on  your  system,  you can use the script atpdiag to
       check your installation and configuration. See atpdiag(1) for details.

       # -------------------------------------------------------
       # sample	atprc ATP configuration	file
       #
       user = PAUL DRAKE
       editor =	vile
       reply =	/usr/spool
       mail  =	/usr/spool
       archiver	= zip -jk
       unarchiver = unzip -Lxjo
       speller = ispell
       ansi = on
       bell = on
       color = on
       graphics	= on
       charset = latin1
       screenlen = 25
       screencol = 80
       qlist = ls -lt *.qw? | cut -c 34- | less
       blist = ls -lt blt* | cut -c 34-	| less
       tagstyle	= fido
       tagline = Why buy a cow when the	milk is	free?
       autotag = on
       workpath	= /tmp
       truncate	= 50
       pcb = on
       header =	off
       #  end of sample	atprc ATP configuration	file
       # ------------------------------------------------------

       user
	    Your name goes here. It must be spelled exactly as it  appears  on
	    the	bulletin boards	where you are registered.

       editor
	    The	name of	the editor which you will use to edit your replies.

       reply
	    This  is  the  path	to your	directory where	you keep reply packets
	    for	uploading.

       mail
	    This is the	path to	your directory where downloaded	message	 pack-
	    ets	are kept.

       archiver
	    This  is the name of the program used to prepare your reply	packet
	    for	uploading. Normally this is zip.  When using the Info-Zip ver-
	    sion, the switches `-jk' tell zip to create	archives without path-
	    names and to  emulate  PKzip.  These  switches  aren't  absolutely
	    needed put could be	helpful	in certain situations.	Please acquire
	    the	most recent versions of	zip and	unzip for  your	 system	 which
	    are	 compatible  with  the	BBSs  which you	frequent. The Info-Zip
	    package is highly recommended.

       unarchiver
	    This is the	name of	the program used to  extract  the  data	 files
	    from  your	QWK  mail  packets. Normally this would	be unzip.  The
	    sample atprc assumes the freeware Info-Zip version of unzip.   The
	    switches  `-Lxjo'  tell  it	 to  extract  files while junking path
	    names, convert MSDOS file names to lower case,  and	 to  overwrite
	    existing files without prompting. These switches may not always be
	    necessary but may be helpful in certain situations.	Use  appropri-
	    ate	switches for the brand of unarchiver you are using.

       speller
	    This line defines the name of the spelling checker you wish	to use
	    to check the spelling of your replies. The program ispell is  rec-
	    ommended  because  of  its	interactive design. It is available in
	    source code	form via anonymous ftp from prep.ai.mit.edu:/pub/gnu.

       ansi
	    This configuration switch can be set to either `on'	or  `off'.  It
	    defaults  to  `off'	 but  most users should	set this to `on'. This
	    controls the placing of the	cursor on the screen and other	screen
	    attributes.	  Note that if `ansi' is set `on' you must have	a ter-
	    minal capable of handling ANSI sequences. MSDOS users will want to
	    add	 the line DEVICE=ANSI.SYS to their config.sys file in order to
	    use	this feature. Many common terminals support ANSI such  as  the
	    popular VT102 and VT220 terminals. The Linux console also supports
	    ANSI, as do	many other PC unixes, and OS/2.	So if  you  fall  into
	    any	of these categories, please set	`ansi' to `on'.

       bell
	    This  configuration	 switch	can be set to either `on' or `off'. It
	    determines if ATP will use the terminal bell. If you desire	silent
	    operation, set bell	to `off'.

       color
	    ATP	 will support color on ANSI terminals. Setting color `on' will
	    enable ANSI	color. You must	have the ATP `ansi'  variable  set  to
	    `on'  also.	  If  you have a monochrome terminal you may find that
	    setting color to `off' gives a more	 readable  screen.  Experiment
	    and	see.

       graphics
	    When  graphics  is	set  to	 `on' ATP will use VT102 line graphics
	    characters to emulate the MSDOS line graphic character set.	 Linux
	    users  will	want to	set this `on'. If your terminal	or system con-
	    sole is unable to display the VT102	line  graphics	set  then  set
	    this `off'.

	    If you want	to see if your terminal	is capable of displaying VT102
	    graphics, type the command `graphics' at the ATP command line.  It
	    will  toggle  this mode on and off,	displaying a boxed message. If
	    you	toggle graphics	`on' and instead of a pretty graphics box on a
	    reverse  field  you	 view an ugly box composed of q's and a's then
	    you	may safely assume that your terminal will  not	support	 VT102
	    line graphics.

	    Note: not all VT102	class terminals	have the line graphics option.
	    Note too that line graphics	is independent of which	character  set
	    you	 choose.   If  your  terminal uses the MSDOS character set and
	    displays it	correctly, there is little point in choosing this  op-
	    tion.  However, just because your operating	system is running on a
	    PC,	do not assume that is uses the MSDOS character set.

       charset
	    Most QWK packets use the MSDOS character set to represent  foreign
	    language  and  line	 graphics characters. If your system does then
	    you	should set charset equal `msdos' and `graphics'	to `off'. How-
	    ever  most	Unix  systems do not recognize the MSDOS character set
	    mappings. If your terminal or console  uses	 ISO  standard	LATIN1
	    character  set  (e.g.   Linux)  then  you will want	to set charset
	    equal to `latin1'. If your system is unable	to display any	8  bit
	    characters	you will want to set this to `7-bit' (8	bit characters
	    will then be mapped	to their closest  7-bit	 counterpart).	Please
	    see	 the file atprc	for more details. Here is a table of some sug-
	    gested settings:

					 TABLE 1
			CHARACTER SET OPTIONS FOR ATPRC	VARIABLES

			 +------------+------------+------------+
			 |  system    |	 charset   |  graphics	|
			 +------------+------------+------------+
			 |  Linux     |	  latin1   |   on	|
			 |  VT102     |	  7-bit	   |   on	|
			 |  generic   |	  7-bit	   |   off	|
			 |  OS/2      |	  msdos	   |   off	|
			 |  386bsd    |	  msdos	   |   off	|
			 |  MS-DOS    |	  msdos	   |   off	|
			 +------------+------------+------------+

       screenlen
	    This configuration setting tells ATP how many  lines  your	screen
	    uses.   This depends on the	type of	video card which you are using
	    and	also on	the type of terminal  emulation	 which	you  have  se-
	    lected.  Valid entries are in the range of 3 to 300. If ATP	is un-
	    able to automatically detect your screen size, it will fallback to
	    these values.

       screencol
	    This  configuration	setting	tells ATP how many columns your	screen
	    uses.  This	depends	on the type of video card which	you are	 using
	    and	 also  on  the	type  of terminal emulation which you have se-
	    lected.  Typical entries are 80 columns. Some terminals will  sup-
	    port  132  columns	too.  If ATP is	unable to automatically	detect
	    your screen	size, it will fallback to the value you	specify	here.

       qlist
	    Used for listing QWK packets.  This	configuration entry is a  com-
	    mand  line	which will be executed anytime you type	`qlist'	at the
	    ATP	prompt.	ATP will change	to your	mail path directory  and  exe-
	    cute  this	command	 line. The example here	when invoked will list
	    all	the QWK	packets	in your	mail directory sorted by time and only
	    displaying	the  size,  date, and name of the packets. It is piped
	    into `less'	which is the GNU version of  `more'.  You  may	delete
	    this  entry	 or modify it if it doesn't do what you	want. A	simple
	    default entry is already set internal to ATP.

       blist
	    ATP	can display bulletins delivered	 with  the  mail  packet.  The
	    `blt'  command  uses  the string specified here, passing it	to the
	    shell to list your bulletins.  You will want to modify this	 entry
	    depending on your operating	system.	After you have viewed the list
	    of available bulletins, view a bulletin by typing its name at  the
	    command line.

       tagstyle
	    This  switch sets the default style	used in	your message taglines.
	    It defaults	to normal. By setting this to `tagstyle	=  fido',  atp
	    will  start	 up using FIDOnet style	taglines. See later section on
	    taglines for more information.

       tagline
	    This is used to set	your persistent	tagline	which  can  always  be
	    called  back  immediately  from  the  command line.	See section on
	    taglines for details.

       autotag
	    By default,	ATP will randomly select taglines  for	your  replies.
	    The	 taglines  are stored in the text file taglines.atp located in
	    the	same directory as your atprc. Automatic	selection of  taglines
	    may	 be  turned off	from the command line or by setting autotag to
	    `off'.

       workpath
	    This option	is not usually needed. However,	if you	need  the  ATP
	    work  directory  to	be on some particular path or drive specify it
	    here.  OS/2	and MSDOS users	can specify a disk drive by specifying
	    the	drive letter. See example in atprc.

       truncate
	    Under  ATP there is	a `clean' command that will put	you into main-
	    tenance mode for your message bases. One  of  the  options	is  to
	    truncate  a	 message base to the most recent messages. This	option
	    sets the default truncation	length.	This truncate  option  can  be
	    changed during the maintenance process if the need should arise.

       pcb
	    The	 BBS  known  as	 PCBoard supports long subject lines as	of PCB
	    version 15.	 If you	would like to have long	subject	lines then set
	    this option	on. Note that not all QWK readers will be able to read
	    your entire	subject	line because most readers are  limited	to  25
	    characters.	But generally there should be no problem. Note that if
	    you	use the	RIME network that you should not use  a	 long  subject
	    line  when	entering  a  routed  message, i.e. a message where the
	    first line must read something like	->156<-.  If  this  option  is
	    enabled and	you enter a reply subject line less than 25 characters
	    in length, behavior	defaults to normal QWK conventions.

       header
	    When replying to a message,	ATP generates  a  reply	 header	 which
	    mentions the author	of the message being responded to. If you wish
	    to have no headers then set	the header option off in your atprc.

SHELL SYSTEM COMMANDS
       When at the ATP command prompt, you will	be able	to execute many	common
       Unix  commands  directly: cat, cd, cp, echo, df,	du, less, ln, lpr, ls,
       man, mkdir, more, mv, pwd, cwd, rm, rmdir, set, sort, sync.

       Under the MSDOS version	the  following	commands  are  available:  cd,
       chkdsk,	copy,  del,  dir, md, mem, more, mkdir,	print, rd, rmdir, set,
       sort, type, xcopy.

COMMANDS SUMMARY
       What follows is a summary of the	commands  available  inside  ATP.  The
       most  important	are:  `load', `review',	`j',`n',`r', `e', and `qscan'.
       These will be presented first. Remember that you	may always type	`help'
       for a brief summary of commands.

       help
	    The	 `help'	command	will display a brief summary of	available com-
	    mands.

       load bbsname
	    This command is used to get	a QWK packet from your spool directory
	    and	 load  it  into	the reader for viewing.	It takes one argument,
	    the	name of	the BBS	or the explicit	name of	the  mail  packet.  If
	    you	 just give the name of the BBS,	ATP will search	for the	packet
	    named bbsname.qwk.	You may	also name the packet explicitly	 (e.g.
	    bbsdeguy.qwk, joesbbs.qw5, etc.).

	    Example:		 load zer0g.qw4

       review bbsname
	    The	 review	 command is used for reviewing the BBS archives	previ-
	    ously loaded into the reader. It takes one argument, the  name  of
	    the	BBS without any	extension. DO NOT add the `qwk'	file extension
	    with this command. The short form of this command is `rev'.

	    Example:		 rev hobbits

       <cr>
	    A carriage return alone will read the next message.

       j[ conference_name | conference_number ]
	    The	`j' command stands for `join' and it is	used for changing con-
	    ferences.	It  must  be followed by either	the conference name or
	    the	conference number.

       n    The	`n' command will join the next active conference.

       a    The	`a' command will display the current message again.

       +    The	`+' command will go forward one	message.

       -    The	`-' command will go backward one message.

       r    The	`r' command is used to enter a reply to	the  current  message.
	    You	 may redirect a	reply to a different message area by following
	    `r'	with the name of the  new  area	 where	the  reply  should  be
	    posted.   When  entering a reply, you are always prompted to allow
	    changing of	the subject, address, and security  information.  When
	    prompted for security you may answer `n' or	`r' which respectively
	    stand for `none' and `receiver only' (private message) security.

       x    The	`x' command is used to crosspost a reply to another  area.  To
	    use	 this command, go to the reply conference and select the reply
	    you	wish to	crosspost. Type	`x' followed by	the conference	number
	    or conference name where you wish to post a	new copy of the	reply.

       c    The	`c' command is used to enter changes to	a previous reply. This
	    command Is valid only in the replies conference. It	will re-invoke
	    the	 editor	 for  the  current  message. The old message is	killed
	    along with its tagline. The	tagline	active at the time  this  com-
	    mand  was  invoked	will  be the new tagline for the edited	reply.
	    Note that that in the context of the  reply	 conference,  the  `e'
	    command has	the same effect	as the `c' command--change a reply.

       p    The	 `p'  command is used to toggle	message	security between `pri-
	    vate' and `public' for your	reply messages.	When a message is pri-
	    vate,  a  warning to this affect will be highlighted in the	bottom
	    right of the message header.

       e[ conference_name | conference_number ]
	    The	`e' command with no arguments will enter a message in the cur-
	    rent  conference.  Again, choose your tagline before entering your
	    message.  The `e' command may be followed optionally by  the  name
	    or	number	of  the	 conference where you would like to enter your
	    message. Upon invoking `e' you will	be presented some choice as to
	    subject, addressee,	and message security.

	    Note  that this command behaves differently	if the current confer-
	    ence is either the REPLY or	PERSONAL conference. If	you are	in the
	    PERSONAL  message  conference, this	command	is completely disabled
	    because it makes no	sense to enter a message in the	personal  con-
	    ference  (you  CAN reply to	messages though--use the `r' command).
	    If you are in the REPLY conference,	this command will re-edit  the
	    current message. It	does not enter a new message.

       head
	    The	 `head'	 command will toggle the automatic reply header	on and
	    off.  The reply header is a	sentence at the	top of a quoted	 reply
	    message  which  will  mention the name of the author of the	quoted
	    message, who it was	written	to, and	on what	date it	 was  written.
	    If	you don't want this style in your replies then you may turn it
	    off	with the head command or just edit it out when composing  your
	    reply.

       reset
	    The	 `reset' command is used to set	the conference message pointer
	    to the highest message which you have read.	It looks at the	 value
	    of the current message and resets the highest read pointer to that
	    value. This	is useful if you wish to quit in  the  middle  of  re-
	    reading a conference but would like	to save	your place marker.

       scan
	    Will  scan	forward	 from  the  current message displaying message
	    headers.  You will be prompted after each screen whether you  wish
	    to continue	scanning.

       qscan
	    Quick  scan	is the same as scan except it will only	display	a sin-
	    gle	line abbreviated header.

       conf The	conf command will display a list of all	available  conferences
	    on a particular BBS.

       ts   The	`ts' is	text search command, an	alias for `find', see below.

       find The	`find' command will search the current conference for any text
	    that follows it. Wildcards are not supported, and it is  not  case
	    sensitive.	For example:

			find paul drake

	    will display messages containing the text ``Paul Drake'' or	``PaUl
	    dRakE'' and	so on. After finding some text,	use the	`next' command
	    to	repeat	the  search.  Note that	any spaces after the first one
	    following `find' are significant.  Thus,

			find paul drake

	    is NOT the same as

			find	  paul drake

       next
	    The	`next' command is used to repeat the search initiated  by  the
	    `find'  command.   If  your	version	of ATP supports	function keys,
	    pressing F10 is  equivalent	 to  typing  this  command.  To	 abort
	    search, type control-C.

       qlist
	    The	 qlist	command	will display a list of all QWK packets in your
	    mail directory. See	the configuration section for details.

       clean
	    The	clean command will allow you to	do maintenance on your message
	    bases.   You  will	be able	to delete, truncate, or	purge messages
	    marked as killed.  Use the `k' command while reading  messages  to
	    mark  a  message as	killed.	 Set the default truncation length for
	    maintenance	in your	atprc.	This number is changeable from	inside
	    the	clean command should you need that flexibility.

       rot  The	 rot  command will filter the current message through a	Usenet
	    standard rot-13 text filter. Invoking the rot command  twice  will
	    restore the	original message. Rot-13 encoding is sometimes used to
	    shield offensive material from being accidentally read. It is  not
	    a secure cypher, and it is not intended to be.

       ![ shell_command	]
	    Without  arguments,	this command will shell	you out	of the program
	    into the system. Type `exit' to return. You	may also  follow  this
	    command  with any valid command line which your operating system's
	    command processor will recognize.

       cls  Will clear the screen display.

       pcb  Will toggle	support	for PCBoard long subject lines.

       time Will display the current date and time.

       date Will display the current date and time

       fido The	`fido' command will toggle the current tagline style. See sec-
	    tion on taglines for more information.

       last The	`last' command will display the	end message in a conference.

       news The	 `news'	 command  will	display	the current news file from the
	    BBS.

       welcome
	    The	`welcome' command will display	the  current  board's  welcome
	    message.

       files
	    The	 `files' command will display the new files list from the cur-
	    rent BBS.

       blt  The	`blt' command will display a list of available bulletins  from
	    the	 current  BBS. To display a particular bulletin	just enter its
	    file name.

       hello
	    The	`hello'	command	will display the BBS Welcome message.

       goodbye
	    The	`goodbye' command will display the BBS goodbye message.

       door The	`door' command will display the	BBS door id and	version	(if it
	    was	included in the	mail packet).

       m    The	`m' command will toggle	the ansi mode on and off.

       g    The	`g' command will quit ATP.

       q    The	`q' command will quit ATP. It is the same as the `g' command.

       s filename
	    The	 `s' command will save the current message to a	specified text
	    file.  If the file exists, the message will	 be  appended  to  the
	    end.

       tag  The	 `tag' command is used to set tagline options. See the section
	    below on taglines for details.

TAGLINES
       ATP supports either FIDO	or regular style  taglines.  In	 addition  ATP
       uses  three  types  of taglines:	persistent, run-time, list. You	have 1
       persistent and 1	run-time tagline. Your list taglines must be  kept  in
       the file	taglines.atp which should be in	the same directory as your at-
       prc.  The purpose of the	persistent tagline is that it is always	 there
       for you to recall and use. You may choose to use	other taglines but the
       persistent tagline will still be	there when you want it.	 The  run-time
       tagline	is  one	you yourself enter at the command line.	 Should	a  bit
       of whimsy strike	you, you can use it right  away	 without  editing  the
       tagline	file.	At any one time	there is only one active tagline which
       may be viewed by	typing the command `tag	?'. Before entering your  mes-
       sage  choose  your active tagline. You may pick from the	list, use your
       persistent tagline, or type a run-time defined tagline at  the  prompt.
       You  also  have the choice of toggling FIDO or regular style tagline by
       typing the command `fido' at the	command	line. Here is a	summary:

       persistent
	    Defined after the `tagline =' statement in the configuration file.
	    This  tagline is stored in a stack with the	run-time tagline. Typ-
	    ing	`tag swap'  will  copy	the  stack  into  the  current	active
	    tagline. Typing `tag swap' twice in	a row will roll	the stack. The
	    persistent tagline is good for a tagline which you	regularly  use
	    such as one	containing place of message origin.

       run-time
	    Defined  at	 the  ATP command line.	If you feel like adding	an im-
	    promptu tagline just type `tag' followed by	your text.

	    Example:		 tag Laurel and	Hardy fan club

	    This above example command will change the active tagline to:

	     ...
	      *	ATP/Linux 1.50 * Laurel	and Hardy fan club.

       list
	    A list type	tagline	is just	a tagline stored  in  the  plain  text
	    file taglines.atp.	If you have selected the auto tagline feature,
	    ATP	will choose a tagline at random	from  your  taglines.atp  file
	    every  time	 you  enter a reply. You may also type `tag random' at
	    the	command	prompt to re-select at any time. Taglines may also  be
	    selected  directly.	Type `tag list'	to view	your list of taglines,
	    and	then type `tag n' to choose a numbered tagline directly	(where
	    `n'	 would	be  the	 number	 of  the  tagline in the list as it is
	    viewed). If	you wish to add	or delete taglines  from  taglines.atp
	    you	should use your	favorite text editor.

TAGLINE	COMMAND
       The  `tag'  command  is	the  basic  command  for  setting and changing
       taglines. ATP echoes any	changes	in tagline to the screen so you	may be
       certain	as to what the current tagline is. If in doubt,	just type `tag
       ?'. Here	are the	possible variations on `tag':

       tag help
	    The	`tag help' command will	display	 the  special  help  menu  for
	    taglines.

       tag swap
	    The	`tag swap' command will	swap move either the persistent	or the
	    run-time defined tagline into the current tagline buffer. Any list
	    defined  tagline will be removed from the buffer. Alternately typ-
	    ing	`tag swap' will	toggle the current tagline between  persistent
	    and	run-time defined.

       tag steal
	    The	 `tag  steal'  command	will append the	tagline	in the current
	    message to your taglines.atp file. This feature only works on mes-
	    sages  which  follow  the  PCBoard BBS style of taglines. For Fido
	    taglines use the `tag add' command.

       tag add
	    The	`tag add' command allows you to	type in	a tagline  which  will
	    then be appended to	your taglines.atp file.	This feature is	useful
	    for	Fido style taglines which are not so easily  captured  by  the
	    `tag steal'	command.

       tag list
	    The	 `tag  list'  command  will  display  a	 list of all available
	    taglines.

       tag n
	    The	`tag n'	command	will set the current tagline to	the tagline in
	    the	list designated	by the number `n'.

       tag ?
	    The	`tag ?'	command	will display the current tagline.

       tag auto
	    The	 `tag auto' command will toggle	automatic tagline selection ON
	    or OFF.

       tag random
	    The	`tag random' will choose a random tagline for you.  It may  be
	    used with either automatic selection disabled or enabled. The auto
	    tagline mode itself	uses this command after	every reply to	regen-
	    erate  a  new tagline. Try it out a	few times to familiarize your-
	    self with it.

       tag off
	    The	`tag off' command will disable taglines.

       tag on
	    The	`tag on' command will re-enable	taglines.

       fido This is a command which toggles the	 tagline  style	 between  FIDO
	    style taglines and regular style. This is provided because FIDOnet
	    has	specific rules about tear lines	 and  high  ascii  characters.
	    Here  is an	example	of a regular tagline followed by an example of
	    a FIDO style tagline:

	     ---
	      [] ATP/Linux 1.50	[] This	is a regular style tagline.

	     ...
	      *	ATP/Linux 1.50 * This is a FIDO	style tagline.

SPECIAL	KEYS
       With release 1.4	some support for special keys have been	 added.	  This
       is  still  being	developed and may change. If you would like to try the
       special keys here are the mappings.  Note:  support  now	 is  only  for
       VT102, Linux, OS/2, and MSDOS consoles.

	key	     command
       -------------------------------------------------------------
	<f1>	     help
	<f2>	     tagline help
	<f3>	     view taglines
	<f4>	     list available QWK	packets
	<f5>	     show terms	of license
	<f10>	     `next' for	text search.
	<home>	     goto first	message	in conference [keypad upper left]
	<end>	     goto last message in conference [keypad lower left]
	<page up>    view messages in reverse order [keypad upper right]
	<page dn>    view messages in forward order [keypad lower right]
	<keypad	`5'> `N' either	`next' or `no' (depends	on context)
	<up arrow>   recall previous command in	history
	<down arrow> recall next command in history

COMMAND	LINE EDITOR
       ATP  uses  the  Rich  Salz and Simmule Turner command-line editor. This
       provides	a simple but powerful emacs-like command-line  editing	inter-
       face  to	 its  users.   Previous	 commands may be recalled by scrolling
       through the command history with	the arrow keys.	A line may  be	edited
       before  it  is  sent  by	typing either control characters or escape se-
       quences.	A control character, shown as a	caret followed by a letter, is
       typed  by  holding  down	the ``control''	key while the letter is	typed.
       For example, ``^A'' is a	control-A. An escape sequence  is  entered  by
       typing  the ``escape'' key followed by one or more characters.  The es-
       cape key	is abbreviated as ``ESC.'' Note	that unlike control keys, case
       matters	in  escape  sequences; ``ESC F'' is not	the same as ``ESC f''.
       Auto command completion is invoked by  pressing	the  ``TAB''  key.  If
       there  is more than one possible	completion, ``ESC ?'' will display the
       available alternatives.

       An editing command may be typed anywhere	on the line, not just  at  the
       beginning.   In	addition,  a  return may also be typed anywhere	on the
       line, not just at the end.

       Most editing commands may be given a repeat count, n, where n is	a num-
       ber.   To  enter	 a  repeat count, type the escape key, the number, and
       then the	command	to execute.  For example, ``ESC	4 ^f''	moves  forward
       four  characters.   If  a  command may be given a repeat	count then the
       text ``[n]'' is given at	the end	of its description.

       Please see the man page editline(3) for more  details.	The  following
       are a list of the basic control characters and commands:

	      ^A	  Move to the beginning	of the line
	      ^B	  Move left (backwards)	[n]
	      ^D	  Delete character [n]
	      ^E	  Move to end of line
	      ^F	  Move right (forwards)	[n]
	      ^G	  Ring the bell
	      ^H	  Delete character before cursor (backspace key) [n]
	      ^I	  Complete filename (tab key); see below
	      ^J	  Done with line (return key)
	      ^K	  Kill to end of line (or column [n])
	      ^L	  Redisplay line
	      ^M	  Done with line (alternate return key)
	      ^N	  Get next line	from history [n]
	      ^P	  Get previous line from history [n]
	      ^R	  Search backward (forward if [n]) through history for text
			  must start line if text begins with an uparrow
	      ^T	  Transpose characters
	      ^V	  Insert next character, even if it is an edit command
	      ^W	  Wipe to the mark
	      ^X^X	  Exchange current location and	mark
	      ^Y	  Yank back last killed	text
	      ^]c	  Move forward to next character ``c''
	      ^?	  Delete character before cursor (delete key) [n]
	      ESC	  start	an escape sequence (escape key)
	      TAB	  auto command completion
	      ESC ?	  suggest alternative completions

	      Note: use	the up/down arrow keys to recall previous commands.

HISTORY
       Version 1.50 January 1997 -- fourth release of ATP

	    Full  termcap support for non-ansi terminals. No limits on message
	    size for any version. Replies can now be directed to  any  message
	    area with `r' command. New `x' command for cross posting. Improved
	    `r'	and `c'	commands for re-directing replies to different message
	    areas.  Use	^C to cancel `find' search.  Add perl script `atpdiag'
	    to help diagnose proper configuration.  Rot-13 message  shroud/un-
	    shroud  added.  GNU	autoconf support provides configure script for
	    building ATP on  Unix  systems.   Tom  Glaab  contributes  tagline
	    steal/add (thanks!). Tagline `tag on/off' commands added. MSDOS 16
	    bit	version	can swap itself	out when spawning sub-shell if	linked
	    with  Ralph	 Brown's spawno	libraries. MSDOS versions now DESQview
	    aware.  Stefan Reinauer contributes	German language	support.  Code
	    re-organized  with	greater	modularity and strong type checking in
	    mind.  Source includes ansi2knr to allow building with non-ANSI  C
	    compiler.	Can  now  be compiled with C++.	 Various bug fixes and
	    improvements.

       Version 1.42 September 4, 1993 -- third release of ATP

	    This release sports	improved  `find'  and  `clean'	commands.  The
	    `clean' command now	allows selective purging of messages that have
	    been marked	killed with the	`k' key. It also allows	truncation  of
	    message  bases  to	the last `n' messages. All in all a much nicer
	    way	to maintain message bases.  Derric  Scott  (dtscott@access.di-
	    gex.net)  provided	the  patches  for  the improved	`find' command
	    which highlights found text	in reverse video.  ATP	supports  mes-
	    sages  up to 180,000 bytes in size (more than 3000 lines). The ATP
	    command line is now	8 bit clean and	 will  accept  the  so	called
	    "high ascii" and foreign language characters.

	    PCBoard long subject lines are now supported but this is still ex-
	    perimental.	Users may toggle this feature with the	`pcb'  command
	    from the command line. The `blt' command displays a	list of	avail-
	    able bulletins, then type the bulletin name	that you wish to view.
	    Alan Barclay provided patches for SCO which	also added the `qscan'
	    command for	a quick	scan of	 abbreviated  message  headers.	  Many
	    bugs  have been fixed and efforts to greater portability have con-
	    tinued. OS/2 is now	supported.  Jim	Gomes provided Windows and MSC
	    support. It	has been reported that ATP runs	under the AMIGA	but no
	    patches were submitted for inclusion in this  release.  Thanks  to
	    David Fox for his bug reports and ideas.

       Version 1.41 Spring 1993	-- beta	testing	release	of ATP

	    Closed beta	testing	with interested	individuals.

       Version 1.4 November 1992 -- second release of ATP

	    Now	ATP includes a separate	conference for replies.	Replies	may be
	    killed with	the `k'	command	or security toggled with the `p'  com-
	    mand.   The	 `find'	command	and `next' command were	added for text
	    search. The	Rich Salz and Simmule Turner line editing  library  is
	    now	included. This gives powerful Emacs style command line editing
	    and	history	recall.	 Please	check the  separate  copyright	notice
	    regarding  this  library.  Three character sets are	now supported:
	    ISO	Latin1,	7bit, and MSDOS. On terminals which support VT102 line
	    graphics, MSDOS line graphics are translated appropriately.	In ad-
	    dition, for	some terminals,	special	function  keys	are  now  sup-
	    ported.

	    Limits  on	number	of conferences per BBS is now set at 8192 with
	    dynamic memory allocation for supporting data structures.  Message
	    size  limit	 has  been  increased  from  32K  bytes	to 150K	bytes,
	    roughly 3000 lines of typical message text.	 Limits	on the	number
	    of	taglines have been removed. Taglines are now stored in a sepa-
	    rate tagline file "taglines.atp". Taglines	may  now  be  selected
	    randomly  (automatically  or  manually)  as	 well as directly. Bug
	    fixes and general code cleanup  also  were	done.  Code  has  been
	    brought  into  stricter  compliance	with ANSI and POSIX standards.
	    Sorry K&R. No matter what your system GNU GCC is  recommended  for
	    compiling ATP.

	    ATP	 has  been compiled and	tested on a number of systems for this
	    release including Esix, Linux, SVR4, 386bsd, and MSDOS. For	 MSDOS
	    it	is recommended that DJ Delorie's port of GNU GCC be used. This
	    is a very nice compiler and	it will	compile	Unix source code  very
	    easily.  It	 requires a 386	or better computer. ATP	will also com-
	    pile under the large model of Borland's Turbo C but	the limits are
	    smaller.

       Version 1.3 July	1992 --	first release of ATP

	    McWilliams.	 Character  set	 translation MSDOS/Linux, Linux/MSDOS.
	    Personal mail alarm. Personal mail conference. Correct reply head-
	    ers, correct time and conference numbers. Command line processing.
	    Improved command parsing. Rewrite fget()  to  handle  pathological
	    control.dat	 files.	 Taglines and tagline management. Ansi editing
	    of entries.	Replies	queries: save,	abort,	edit.  Message	header
	    scanning.  Bug fixes. Improved message quoting. Correction of con-
	    ference Autojoin();	Tested under Linux 0.96c and Esix R.4.0.

       Version 1.2 April 1992 -- first Unix/Linux port of AzerTyuioP.

	    Salazar. Unix-izing	for Linux. Conversion of path  names.  Writing
	    new	 string	 comparison functions. Reworking system.c and system.h
	    modules for	portability.  First version to unarc packets and  read
	    them  under	 Linux.	 Improved handling of control.dat parsing. In-
	    troduction of array	to track real conference numbers  versus  con-
	    ference ordinal numbers.

       Version 1.1 November 1990 -- Cougnenc releases AzerTyuioP code.

	    Cougnenc.  Code to experimental QWK	reader AzerTyuioP is  released
	    for	MSDOS. Primarily useful	as  tool  for  studying	 QWK  packets.
	    Cougnenc  had  no documentation on the layout so this work was em-
	    pirical in nature.	Includes both French and English capabilities,
	    set-able  at  compile  time.   Reader creates archives of received
	    messages.

THANKS
       Many thanks to Rene Cougnenc for	his AzerTyuioP from which much of  ATP
       is  derived. Also thanks	must be	given to Mark Salazar who provided the
       first quasi-functional Unix version of AzerTyuioP which was able	to un-
       archive	packets	 and  read mail. A big thanks to all who have provided
       patches particularly Derric Scott with enhancements to the `find'  com-
       mand.  Alan Barclay provided fixes and added functionality with his SCO
       patches.	 Tom Glaab has provided	nice enhancements to the tagline func-
       tionality  such as the `steal' command. Stefan Reinauer provided	German
       language	support. Also thanks to	Jim Gomes, Dane	Beko, Patrick Lee, Ron
       Smith,  and  David  Fox who have	provided useful	suggestions, contribu-
       tions, and bug-reports.

COPYING	AND NO WARRANTY
       Copyright (C) 1992,1993,1997 Thomas McWilliams.
       ATP is copyrighted free software	provided WITHOUT warranty of any kind,
       NOT  EVEN  the  implied	warranty of merchantability or fitness for any
       particular purpose. Use at your own risk.  ATP may be used in  any  way
       you wish	so long	as you comply with the provisions of the Free Software
       Foundation GNU General Public License; either version 2 of the License,
       or  (at your option) any	later version. Essentially this	means that you
       *MUST* provide the source code for any works derived from ATP when  you
       distribute binaries. You	can not	withhold the rights which you yourself
       have been granted. Please type `show terms' from	ATP's command line for
       a  display  of warranty disclaimer and pointers to pertinent documents.
       This software should have come with a copy of the  GNU  General	Public
       License.	You may	obtain a copy of this license by writing to:

		   Free	Software Foundation, Inc.,
		   675 Mass Ave,
		   Cambridge, MA 02139,	USA.

BUG REPORTS AND	PATCHES
       Bug  reports,  suggestions, and code contributions are welcome.	If you
       have ported ATP to another system,  your	 are  welcome  to  submit  the
       patches	so that	they might be incorporated into	the next release.  Bug
       reports should include a	way for	me to reproduce	the bug.

       Fido netmail may	be sent	to me at node 1:109/615	 and  I	 am  sometimes
       reachable via the Internet at one of the	following locations:

		   tgm@netcom.com

		   thomas.mcwilliams@f615.n109.z1.fidonet.org

       Snail mail may be sent to:

		   Thomas McWilliams
		   P.O.	Box 7545
		   Arlington, VA 22207

       Source code for ATP can be found	at:
       sunsite.unc.edu:/pub/Linux/system/BBS/mail/atp-1.50-src.tar.gz

FILES
       /usr/local/bin/atp
       $ATP/taglines.atp
       $ATP/atprc

SEE ALSO
	      atpdiag(1), editline(3), zip(1), unzip(1), rot13(1)

ATP 1.50			4 January 1997				ATP(1)

NAME | SYNOPSIS | DESCRIPTION | FEATURES | ENVIRONMENT | CONFIGURATION | SHELL SYSTEM COMMANDS | COMMANDS SUMMARY | TAGLINES | TAGLINE COMMAND | SPECIAL KEYS | COMMAND LINE EDITOR | HISTORY | THANKS | COPYING AND NO WARRANTY | BUG REPORTS AND PATCHES | FILES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=atp&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help