[jboss-cvs] jboss-seam/doc/reference/en/modules ...

[Peter Muir]

  User: pmuir   
  Date: 07/02/18 09:34:44

  Modified:    doc/reference/en/modules  mail.xml
  Log:
  JBSEAM-658
  
  Revision  Changes    Path
  1.16      +18 -9     jboss-seam/doc/reference/en/modules/mail.xml
  
  (In the diff below, changes in quantity of whitespace are not shown.)
  
  Index: mail.xml
  ===================================================================
  RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/mail.xml,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -b -r1.15 -r1.16
  --- mail.xml	13 Feb 2007 16:28:18 -0000	1.15
  +++ mail.xml	18 Feb 2007 14:34:44 -0000	1.16
  @@ -183,15 +183,19 @@
      
   	    	<para>Otherise you can add any header to the message using the <literal>&lt;m:header&gt;</literal> tag:</para>
   	    	
  -	    	<programlisting><![CDATA[<m:header name="X-Sent-From" value="JBoss Seam"/>]]></programlisting>
  +	    	<programlisting><![CDATA[<m:header name="X-Sent-From" value="JBoss Seam"/>![CDATA[</programlisting>
   	    	
   	    </section>
   
   	</section>
  -<!-- <section>
  +    <section>
   		<title>Receiving emails</title>
  -		<para>If you are using EJB then you can use a MDB (Message Driven Bean) to receive email.  JBoss AS comes with <literal>mail-ra.rar</literal> :</para>
  -		<programlisting>@MessageDriven(activationConfig={
  +		<para>If you are using EJB then you can use a MDB (Message Driven Bean) to receive email.  Seam comes with an improved version
  +		of <literal>mail-ra.rar</literal> as distributed in JBoss AS; until the improvements make there way into
  +		a released version of JBoss AS, replacing the default <literal>rar</literal> with the one distributed with Seam is
  +		recommended.</para>
  +		<para>You can configure it like this:</para>
  +		<programlisting><![CDATA[@MessageDriven(activationConfig={
            @ActivationConfigProperty(propertyName="mailServer", propertyValue="localhost"),
            @ActivationConfigProperty(propertyName="mailFolder", propertyValue="INBOX"),
            @ActivationConfigProperty(propertyName="storeProtocol", propertyValue="pop3"),
  @@ -210,18 +214,23 @@
         orderProcessor.process(message.getSubject());
      }
      
  -}</programlisting>
  +}]]></programlisting>
   
   		<para>Each message received will cause <literal>onMessage(Message message)</literal> to be called.  Most seam
   		annotations will work inside a MDB but you musn't access the persistence context.</para>
   
  -		<para>You can find more information on <literal>mail-ra.rar</literal> at 
  -		<ulink url="hhttp://wiki.jboss.org/wiki/Wiki.jsp?page=InboundJavaMail">http://wiki.jboss.org/wiki/Wiki.jsp?page=InboundJavaMail</ulink>.</para>
  +		<para>You can find more information on the default <literal>mail-ra.rar</literal> at 
  +		<ulink url="http://wiki.jboss.org/wiki/Wiki.jsp?page=InboundJavaMail">http://wiki.jboss.org/wiki/Wiki.jsp?page=InboundJavaMail</ulink>.
  +		The version distributed with Seam also includes a <literal>debug</literal> property to enable
  +		JavaMail debugging, a <literal>flush</literal> property (by default true) to disable flushing a <literal>POP3</literal> 
  +		mailbox after successfullying delivering a message to your MDB and a <literal>port</literal> property
  +		to override the default TCP port.  Beware that the api for this may be altered as changes make there
  +		way into JBoss AS.</para>
   	
   		<para>If you aren't using JBoss AS you can still use <literal>mail-ra.rar</literal> (included with Seam in the mail directory),
   		or you may find your application server includes a similar adapter.</para>
   	
  -	</section>-->
  +	</section>
   
   	<section>
   		<title>Configuration</title>