
# This is a demo configuration file. The formal should be '.pmailrc' in your
# home directory with 0600 permissions. You can put the POP3 account with the
# id and password here; but for the security reasons, please avoid doing this.
#


# 'log' specifies a log file.
# You may instruct a size quota as the second parameter.
#
#log ~/Mail/dbgfile 
#log /var/log/pmail 40K
#log ~/Mail/.pmailog 40k


# Option 'default' specifies a default action of Pmail, while there's no 
# action asserted in the command line, such as simplely typing 'pmail'.
#
# Note that in the command line, these arguments are looked as action:
# '-d', '-o', '-p', '-P', '-t' or email address. Any other argument is 
# looked as an option. If pmail doesn't take an action from command line, 
# it goes with this 'default' option.
#
# There are 6 default actions are available:
#
#   get        work as message incoming client.
#   sent       send messages in the postpone message folder.
#   dump       dump contents in the postpone message folder. 
#   info       list message informations in the postpone message folder.
#   help       print help information.
#   version    print version information.
#
# These actions could used consolidately, for example,
#
#   default get,sent
#
# means pmail should download messages first, then send messages in the 
# postpone mailbox. (recommanded)
#

default get,sent


# If 'verbose' is uncommented, pmail will display the detail conversation
# with the remote servers.
#
#verbose


# Both SMTP and POP3 protocols need timeout mechanism support.
# By second, 0 means unlimit it.
#
timeout 90



# 'fetch' specifies the incoming message servers. 
# According to the option list, pmail will connect to those servers 
# one by one. There is no limit in the number of incoming message server.
# 
# Each line has this format:
#	
#   host.name:protocal:operation:spam:mailbox:id:passwd
#					
#   host.name   the incoming mail server.
#   protocal    protocal of message retrieval: pop3, apop.
#   operation   what should pmail do. 4 options availible:
#               'd'   download and remove mails from host.(default)
#               'f'   download mails but reserve them in the host.
#               'c'   check mails status only
#               't'   display messages' head part.
#   spam        anti-spam mail option. 3 choises:
#               'y'   adopt general anti-spam list, .e.g anti-spam id=0
#               'n'   disable anti-spam function
#               [...] anti-spam id list, seperate by comma, such as: 0,2,3
#   mailbox     the mailbox for saving incoming mail. Default is ~/mbox.
#   id&passwd   user's account in the server.
#
# Note that any one set '*' is looked as blank item. Pmail will take the 
# default value or ask user for if no default value assumed. It generally
# is equivalent to leave the column in empty, except the 'passwd' column.
# Leaving the 'passwd' column in empty means no password needed in the 
# maildrop server. Otherwise pmail will ask user of password if '*' is set.
#
# Examples:
# 
# fetch pop3.host.com:pop3:d:n:~/mbox:user:	(blank passwd)
# fetch pop3.host.com:apop:d:y:~/mbox:user:*	(require passwd when login)
# fetch pop3.host.com:pop3:d:n:~/mbox:user:\*	(the passwd is "*")
# fetch pop3.host.com:pop3:d:1,2,3,4:~/mbox:*:*
# fetch localhost:pop3:d:n:*:*:*


# SMTP server
# You can list several SMTP servers here though it just accesses one server
# at one time, generally the first server listed. The command line option,
# -h@, can change this, such as to access the third SMTP server by -h@3.
# Each line has this format:
#
#   hostname:reply_address:id:passwd
#
#   hostname        the address of the SMTP server
#   reply_address   reply address. It's usually the mail address given by
#                   the SMTP service provider.
#   id & passwd     the authenfication of the server. If you haven't, leave
#                   them empty. (this function will be supported soon)
#
#smtp server.your.isp:yours@your.isp.server:id:passwd


# specify a default postpone mailbox.
# If you specify an operation to display messages' head part, Pmail should 
# connect to the server, then download messages' head and, according to the 
# second  parameter of 'topstyle', might download parts of mailbody. The 
# 'topstyle' sets a choice, display all part of heads, or just display the 
# part of which you're interesting.
#
# There are two choices of 'topstyle': 
#
#   'all'     - display all part of heads.
#   'smart'   - display sender, subject, date and other useful informations
#   'brief    - display series no., sender and subject briefly.
#
# The second parameter requests the lines of mailbody to display.
#
# topstyle all 5	# display message head and up to 5 lines body
topstyle smart 


# In some situation, both pmail and mailz are intending to display parts of
# the message head, such as the 'smart' option of topstyle.

headmask From:To:Cc:Bcc:Subject:Date:Sender:Reply-To:X-Mailer


# How does pmail process those delivering and delivered mails in the postpone
#   message folder?
# There are all choices: pipe, sign, exhd, pure, unpipe, unsign, unexhd,
#   dele, bkup.
# Note that first 7 choices can be overrided by 'X-behave' headline in 
#   the individual message.
#
#   pipe:   enable external pipe
#   sign:   enable external signature file
#   exhd:   enable appanding extra head specified in the 'header' below.
#   dele:   delete messages successfully sent.
#   bkup:   backup successfully sent messages to the file by 'bakbox'.
#   pure:   no pipe, no signature, no extra head message
#   unpipe: disable external pipe
#   unsign: disable external signature file
#   unexhd: disable extra head appanding
#
# The default smtpbeh is pipe,sign,exhd,dele,bkup
#
#smtpbeh pipe,sign,exhd


# a short pause after logined into a POP3 server
#
# some server may need a brief pause to finish copying very large mailbox 
# to the temp-file, especially in a heavy loading machine.
# counted by second. 0 means no pause.
#
#popdelay 1


# Default message folder.
# If no message folder is specified for downloading mails, this folder is set
# to default folder. Mailz also use it as default folder.
#
#mbox ~/mail/mbox


# The messages are going to deliver should be in this folder. These messages
# are assumed in 'FromSpace' form that adopted by standard UNIX mail/mailx.
# In other word you can view/edit these letters with mail or elm.
# Try 'pmail -t' to get a sample in this mailbox
#
#postpone ~/mail/postpone


# specify a message folder for backup delivered messages.
# This capabaility needs the support of 'smtpbeh'. By default it has
# supported already.
#
#bakbox ~/mail/sent


# This is an address memorandum for mailz composing messages.
# =======
#memo   ~/mail/address.rc


# Your individual information and default reply address
#
#reply-to "Your full name" <yours@reply.address>


# a signature file, like other email program.
# CAUTIOUS: Pmail cannot process signature larger than 48 kilobytes.
#
#signature ~/.signature


# External pipe. Pmail can transfer every messages' body, including the 
# signature part, through this pipe line just before delivering them. 
# For example, to armour messages' body with PGP.
#
#pipeto mmencode -b
#pipeto mmencode -q
#pipeto gb2hz
#pipeto pgp -fast


# Introducing the extra head. It used to optimize the messages' head part
# for some purposes. You can put anything you pleased here. 
# If there appears the same class head entry in the mail, the relatively
# extra head will be ignored.
#
#header Content-Transfer-Encoding: quoted-printable
#header Content-Transfer-Encoding: base64
#header Content-Transfer-Encoding: 7bit
#header Content-Transfer-Encoding: 8bit
#header Content-Type: text/plain; charset=gb2312
#header Content-Type: text/plain; charset=ISO-8859-1
#header Content-Type: text
#header Content-Type: text/plain; charset="hz-gb-2312"
#header Content-Type: text/plain; charset=us-ascii
#header X-Mailer: Mozilla 3.0Gold (Faked :-)
#header MIME-Version: 1.0
#header Organization: What on earth do you like?
#header Reply-To: /dev/null
#header Subject: No subject is good subject!
#header Errors-To: /dev/null
#header X-Priority: 999!
#header X-URL: http://www.tianfu.net/~xuming


# specify an external pager for Mailz.
pager  /bin/more


# specify an external editor for mailz.
editor /bin/vi


# Set anti-spam filter regular chain
# A regular node is composed of three parts: Identity, Regularity and Action.
# The Identity marked 'id' is an arbitrary integer.
#   These regular nodes within the same id number compose a regular chain.
#   Messages must go through all nodes in the chain, otherwise they should
#   be rejected. You can specify several chains in the 'fetch' option.
#   Note that id 0 has special mean. It composes a generic chain that works
#   for the choice of 'y' in the 'fetch' option. Because you didn't make
#   instruction, the default action is assumed.
# The Regularity is used to match the relative entry of message head. There
#   are three choices by now: from, subject and quota. The 'from' copes with
#   'From', 'Sender' and 'Reply-to'; the 'subject' is for the subject part
#   of a message; the quota is the limitation of a message. If you put more
#   than one regularity inside one node, they work at AND relationship. i.e.
#   only all regular matched has true the node. On the contrary, the nodes
#   in the chain work at OR relationship. Any one matched makes a bounced
#   message.
# The Action defines do what whenever a message matches centain node.
#   There are four choices: true-delete, true-keep, false-delete, false-keep.
#   You can look it on two parts: the condition and the action. 'delete'
#   means deleting the message from server; 'keep' means bouncing the message,
#   but does not remove it from server. TRUE is defined as all rules in a
#   node matched.
# Note that the 'from' and 'subject' rules support extend regular expression.
# See regex(7) for the detail.
#
#spam {
#    id: 0
#    from: \.sina\.com		# refuse any message from sina.com
#    action: true-delete
#}
#
#spam {
#    id: 0
#    subject: i love you
#    action: true-delete
#}
#
#spam {
#    id: 1
#    quota: 1M
#    action: true-keep
#}
#
#spam {
#    id: 4
#    subject: .*ma.e.*money.*	# kick out anyone said "make money"
#    action: true-delete
#}
