PMAIL 0.4 (1)                06 August 1998                PMAIL 0.4 (1)




NAME  
        pmail - SMTP and POP3 mail transfer client   ( MTC?)

SYNOPSIS  
        pmail -d  [ -l "list" ] [ -f inbox ]  
                [[ -h ] pop3.server ...] 

        pmail -o [ -f outbox ] [[ -h ] smtp.server ] 

        pmail [ -s subject ] [ -c cc-addr ] [ -b bcc-addr ]  
                [ -h smtp.server ] to-addr [ ... ] 

        pmail -t [[ -f ] outbox ] 

        pmail [ --help ] [ --version ] [ -v ] 

DESCRIPTION  
        Pmail is a small E-mail transfer client. Pmail supports multiple
	POP3  accounts, sends  offline mails   and can  simply   process
	remote  mail before download. Though  pmail  doesn't  offer  the
	MUA functions of reading or writing  letters, it combines easily
	with  tools  like  mail ,  other  MUA's  and  text editors.  The
	structure  of  the  mailboxes  for  either  downloaded  mails or
	ready-to-sends  is the	standard UNIX mail/mailx format.     

POP3 CLIENT  
	
        -d,--do Specifies an action. As  of  now  there  are 5 choices: 

        c - Check mail.  List number and size.  

        t  -  Give  a  detailed report, include  mailhead  and  parts of
        mailbody.  Server  ought  to  support  the  TOP  command.
	See topnumber& in .pmailrc.  

        d - Download mails and remove them from server.  

        f - Fetch mails and leave them in server.  

        r - Remove the specified mails from server without download.  To 
        use this function, user must give a list with the --list option.  
	
	-l,--list Specifies  a mail number list.  The mail number can be
	printed by -dc option.  Upon this list, one can
	download/fetch/top/remove any mails by one's mean.  (include mail
	bomb :-)  The mail number in the list should be separated by
	comma, be joined by dash.  For examples:  ``2,7-18,32'' -finbox
	Specifies a mailbox to store the ingoing mails, when you intend to
	overthrow that one had specified by pop3host in .pmailrc. 
	[-h]pop3.server Specifies the POP3 server.  The switch -h might be
	neglected.  Certainly a list of hosts might be given here. 
        For  these  arguments;  do,inbox,server, in  .pmailrc, there are
        equivalent options.  See  pop3host for the details.  


SMTP CLIENT

        -o Let pmail send mails which are stored in  outgoing  mailbox.
        Each letter needs to contain a structure similar to: 

                        Fromyour@address 
                        From:your@address 
                        To:dest@address 

        and can also contain CC or BCC fields: 

                Cc:address1, 
                Bcc:address1, 

        And any style header line can be put here: 

                My_personal_head:separated 

        Using  -t  option appends a simple template into outgoing mailbox.  

	-foutbox use this outgoing mailbox instead that one, that
	specified by outbox in .pmailrc [-h]smtp.server use this SMTP
	server instead that one specified by smtp in .pmailrc

SEND MAIL IMMEDIATELY  

        -s subject offer the subject of letter.  

	-c cc_addr Give a list of Carbon-Copy address.  

	-b bcc_addr Give a list  of  BCC  address.

        -h smtp.server Specifies an SMTP server, instead of the one
	specified in the .pmailrc.  

        In  this mode,  pmail  pretty much looks like the classico  mail
        command.  It sends a letter  read  from  stdin,   or  read  from
        keyboard.  The buffer for keyboard input is set to 8192 bytes by
	the MBUF constant in the sourcecode.  

        For example: 
                pmail -h 

        OTHER OPTIONS  

        -v,--verbose Verbose   mode.  Pmail will display all the
        conversations with  the remote host.   

	-t[[-f] Append a template to the outgoing mailbox.

	--help,
	
	--version 

FILES  
        .pmailrc has stored most of options. It ought to be   positioned
	in the home directory.  

BUGS  
        English is  not  my  native  language.   If you don't understand
        something in this manpage ... I'm sorry.  

SEE ALSO  
        mail(1) 

AUTHOR  
        "Xu, Ming" xuming@bigfoot.com 
	American English editing by Rick Hohensee