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

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
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
       environment  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 `qwk-
       mail' 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
	    option.  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
	    selected.  Valid  entries  are in the range	of 3 to	300. If	ATP is
	    unable 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
	    selected.  Typical entries are 80  columns.	 Some  terminals  will
	    support 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
       atprc.	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
       message 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
	    impromptu 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
       sequences. 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
       escape 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 dis-
       play 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/unshroud  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  sup-
	    port.  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.digex.net)	provided  the patches for the improved
	    `find' command which highlights found text in reverse video.   ATP
	    supports  messages	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
	    experimental. 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
	    addition, 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.
	    Introduction 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
	    empirical in nature.  Includes both	French and  English  capabili-
	    ties,  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+10.3-RELEASE+and+Ports>

home | help