On Apr 14, 2012, at 15.55, Wietse Venema wrote:

> The alternatives that I see are 
> 
> a) Spam every address class description with text that virtual alias
> mappings are class-agnostic. Then we would also have to mention
> canonical_maps,and other class-agnostic mechanisms.

on one hand, this might be less desirable due to the potential for repetition, 
but if it could be concise enough, that might outweigh the negatives.  maybe 
something like this?:

[...]
The relay domain class.

        [... existing text ...]

        • The class-agnostic mechanisms used by this address class are 
virtual_alias_maps and canonical_maps.

The default domain class.
[...]

i do like the idea of there being a reference to this in ADDRESS_CLASS_README, 
because it seems to often serve as a natural reference for this topic, but not 
knowing the comprehensive list of mechanisms which would apply to each class, 
this may just not be practical.

> b) Describe the virtual alias lookup behavior in the text that
> defines virtual alias lookups, i.e. virtual(5). If anyone uses
> virtual aliasing then they are more likely to look there.

i'm not certain the placement is ideal, but a note at the end of the VIRTUAL 
ALIAS DOMAINS section?:

[...]
VIRTUAL ALIAS DOMAINS

       [... existing text ...]

       Note: virtual_alias_maps is not used solely for domains listed in  vir‐
       tual_alias_domains.  Addresses  listed in virtual_alias_maps can refer‐
       ence domains found in address classes  other  than  the  virtual  alias
       domain   class,   unless  of  course  the  domain  is  listed  in  vir‐
       tual_alias_domains.

REGULAR EXPRESSION TABLES
[...]

your use of the term "class-agnostic" prompted me to think about the various 
parameters themselves, and the particular characteristics of each.  maybe 
another alternative would be to call this characteristic out in postconf(5), 
where appropriate for a given parameter?  i.e.:

[...]
virtual_alias_maps (default: $virtual_maps)
Optional lookup tables that alias specific mail addresses or domains to other 
local or remote address. The table format and lookups are documented in 
virtual(5). For an overview of Postfix address manipulations see the 
ADDRESS_REWRITING_README document.  This parameter is address class agnostic.
[...]

-ben

Reply via email to