Re: [Mimedefang] obtaining the senders IP address within filter_begin

2010-06-01 Thread -
--- On Tue, 6/1/10, TLD MimeDefang  wrote:
> RE: $RelayAddr documentation.

I consider the documentation as accurate as written.  However, English is my 
first language.  Maybe non-native speakers have a different view.

___
NOTE: If there is a disclaimer or other legal boilerplate in the above
message, it is NULL AND VOID.  You may ignore it.

Visit http://www.mimedefang.org and http://www.roaringpenguin.com
MIMEDefang mailing list MIMEDefang@lists.roaringpenguin.com
http://lists.roaringpenguin.com/mailman/listinfo/mimedefang


Re: [Mimedefang] obtaining the senders IP address within filter_begin

2010-06-01 Thread -
--- On Tue, 6/1/10, TLD MimeDefang  wrote:
> > ... in addition, some of them are available in filter_relay,
> > filter_sender or filter_recipient.  If this is the case, it will
> > be noted below."

Although accurate, replacing "If this is ..." with "Where this is..." is better 
diction.

___
NOTE: If there is a disclaimer or other legal boilerplate in the above
message, it is NULL AND VOID.  You may ignore it.

Visit http://www.mimedefang.org and http://www.roaringpenguin.com
MIMEDefang mailing list MIMEDefang@lists.roaringpenguin.com
http://lists.roaringpenguin.com/mailman/listinfo/mimedefang


Re: [Mimedefang] obtaining the senders IP address within filter_begin

2010-06-01 Thread TLD MimeDefang

David F. Skoll wrote:

It's correct.  However, the top of the section says:
"All of these variables are always available to filter_begin, filter,
 filter_multipart and filter_end.  In addition, some of them are
 available in filter_relay, filter_sender or filter_recipient.  If this
 is the case, it will be noted below."


Drat.  I thought I was so thorough too. :)

I appreciate the assistance!

Brad/TLD
___
NOTE: If there is a disclaimer or other legal boilerplate in the above
message, it is NULL AND VOID.  You may ignore it.

Visit http://www.mimedefang.org and http://www.roaringpenguin.com
MIMEDefang mailing list MIMEDefang@lists.roaringpenguin.com
http://lists.roaringpenguin.com/mailman/listinfo/mimedefang


Re: [Mimedefang] obtaining the senders IP address within filter_begin

2010-06-01 Thread David F. Skoll
TLD MimeDefang wrote:

> ***This variable is available in filter_relay, filter_sender and
> filter_recipient.***

It's correct.  However, the top of the section says:

"All of these variables are always available to filter_begin, filter,
 filter_multipart and filter_end.  In addition, some of them are
 available in filter_relay, filter_sender or filter_recipient.  If this
 is the case, it will be noted below."

As Jan-Pieter Cornet pointed out, the wording could be improved.

Regards,

David.
___
NOTE: If there is a disclaimer or other legal boilerplate in the above
message, it is NULL AND VOID.  You may ignore it.

Visit http://www.mimedefang.org and http://www.roaringpenguin.com
MIMEDefang mailing list MIMEDefang@lists.roaringpenguin.com
http://lists.roaringpenguin.com/mailman/listinfo/mimedefang


Re: [Mimedefang] obtaining the senders IP address within filter_begin

2010-06-01 Thread TLD MimeDefang

David F. Skoll wrote:

  I see $RelayAddr as a global, but is only available in
_relay, _sender, and _recipient and that doesn't do me any good.

Umm?  What makes you think it's only available there?


From the man page (* added for highlight):
---
  $RelayAddr
  The  IP  address of the sending relay (as a string 
consisting of four dot-separated decimal numbers.)  One potential use of 
$RelayAddr is to limit mailing
  to certain lists to people within your organization. 
***This variable is available in filter_relay, filter_sender and 
filter_recipient.***


---

So that is not correct?
___
NOTE: If there is a disclaimer or other legal boilerplate in the above
message, it is NULL AND VOID.  You may ignore it.

Visit http://www.mimedefang.org and http://www.roaringpenguin.com
MIMEDefang mailing list MIMEDefang@lists.roaringpenguin.com
http://lists.roaringpenguin.com/mailman/listinfo/mimedefang


Re: [Mimedefang] obtaining the senders IP address within filter_begin

2010-06-01 Thread Jan-Pieter Cornet

On 2010 Jun 1, at 1:57 , David F. Skoll wrote:

 I see $RelayAddr as a global, but is only available in
_relay, _sender, and _recipient and that doesn't do me any good.


Umm?  What makes you think it's only available there?



Probably because the docs are slightly unclear if you quick search them:

   $RelayAddr
  The  IP  address of the sending relay (as a string  
consisting of
  four dot-separated  decimal  numbers.)   One   
potential  use  of
  $RelayAddr is to limit mailing to certain lists to  
people within
  your organization.  This variable is available in   
filter_relay,

  filter_sender and filter_recipient.

That doesn't say the variable is also available in filter_begin,  
filter, filter_end, etc. That only becomes clear if you read the start  
of that section, which says:


GLOBAL VARIABLES SET BY MIMEDEFANG.PL
   The following global variables are set by mimedefang.pl and  
are  avail‐
   able  for use in your filter.  All of these variables are  
always avail‐
   able to filter_begin,  filter,  filter_multipart  and   
filter_end.   In
   addition,  some of them are available in filter_relay,  
filter_sender or

   filter_recipient.  If this is the case, it will be noted below.

... but most people probably don't get that far.

The addition of the word "also" in some of the manpages might make  
things a little clearer. Or just list all functions where the variable  
is available, or say something like:


 "This variable is available in filter() and the other message body  
filtering functions, and also in filter_relay, filter_sender, ... [etc]"


And then define "message body filtering functions" somewhere in the  
start of the section to be filter_begin, filter, filter_multipart and  
filter_end.


(I can't recall exactly - I know I did some work on this section of  
the manpage because of the introduction of read_commands_file(), could  
be this is partly my fault).


--
Jan-Pieter Cornet 
Systeembeheer XS4ALL Internet bv
Internet: www.xs4all.nl
Contact: www.xs4all.nl/contact

___
NOTE: If there is a disclaimer or other legal boilerplate in the above
message, it is NULL AND VOID.  You may ignore it.

Visit http://www.mimedefang.org and http://www.roaringpenguin.com
MIMEDefang mailing list MIMEDefang@lists.roaringpenguin.com
http://lists.roaringpenguin.com/mailman/listinfo/mimedefang