##################################################################
# Carbons configuration

# For detailed description of all available keywords
# see chapter 3.7 of hpt manual

# Enable CC for outgoing mail. Default off.
CarbonOut on

# This statement restricts CC to a first matching rule only.
# By default message can be subject of more than one CC rule.
#CarbonAndQuit on

# Don't carbon in passthrough areas
ExcludePassthroughCarbon

# Exclude " * Forward from area " string
CarbonExcludeFwdFrom off

# Keep seen-by's and path
CarbonKeepSb


# Every carbon rule consists of two parts. First is a carbon
# pattern. Messages are checked against this pattern.
# Second is an action. The action is executed on messages that
# match appropriate pattern.
# For one pattern there is one and only one action.
# Yet the pattern itself can be complex, i.e. consists of
# many actual patterns molded together with logical operators.


# Let's overview available keywords:
#
# Patterns:
#
# CarbonAddr: make carbonCopy using from address of msg
# CarbonFrom: make carbonCopy using from-field of msg
# CarbonFromArea: carbon messages from area
# CarbonGroups: make carbonbonCopy from this groups
# CarbonKludge: make carbonCopy using kludge lines of msg
# CarbonSubj: make carbonCopy using subject-field of msg
# CarbonText: make carbonCopy using text-field of msg
# CarbonTo: make carbonCopy using to-field of msg
#
# Logical operator:
#
# CarbonRule <AND|OR|NOT> : how to combine Carbon patterns (NOT = AND NOT)
#
# Actions:
#
# CarbonCopy: specify the area where the carbon copies go into
# CarbonDelete: specify that the carbon msg should be deleted
# CarbonExtern: specify the external program to pass msg text to
# NetmailExtern: specify the external Program to pass netmail msgs to
# CarbonMove: specify the area where the carbon msg get moved into

# One additional keyword exists that is not the pattern but also
# not exactly the action:
#
# CarbonReason
#
# It precedes action itself and sets string for @REASON kludge that
# is added for copied or moved messages.

# Example:

# CarbonFrom Overmind
# CarbonReason smart one, read it
# CarbonCopy

# How to write complex patterns?

# For those who are familiar with boolean algebra it is easy.
# Just keep in mind:
# 1) NOT between patterns = AND NOT, if you want OR NOT then write

# CarbonRule OR
# CarbonRule NOT

# 2) AND and NOT have higher priority than OR
# 3) There is NO BRACES, so if you want to write something
# like A && (B || C) then write it as A && B || A && C.
# Note also that A && NOT (B || C) is equivalent to A && NOT B && NOT C.
##EN# That's all.

# If you don't know wtf is boolean algebra then you should
# search for better teacher than me. :-P

# If someone can explain it for newbe -- do it.




# Define typical carbon rule that will CC all messages
# addressed to Yeti except those in areas YETI.*
CarbonTo       Yeti
CarbonRule NOT
CarbonFromArea YETI.*
CarbonCopy     YETI.CC
