added password notification job for Shadow accounts

lam/docs/manual-sources/howto.xml

@@ -2066,6 +2066,90 @@ mysql> GRANT ALL PRIVILEGES ON lam_cron.* TO 'lam_cron'@'localhost';
           @@ATTRIBUTE_NAME@@. E.g. to add the user's common name use "@@cn@@".
           For the common name it would be "@@cn@@".</para>
         </section>
+
+        <section>
+          <title>Shadow: Notify users about password expiration</title>
+
+          <para>This will send your users an email reminder before their
+          password expires.</para>
+
+          <para>You need to activate the Shadow module for users to be able to
+          add this job. The job can be added multiple times (e.g. to send a
+          second warning at a later time).</para>
+
+          <para>LAM calculates the expiration date based on the last password
+          change, the password warning time (attribute "shadowWarning") and
+          the specified notification period.</para>
+
+          <para>Examples:</para>
+
+          <para>Warning time = 14, notification period = 10: LAM will send out
+          the email 24 days before the password expires</para>
+
+          <para>Warning time = 14, notification period = 0: LAM will send out
+          the email 14 days before the password expires</para>
+
+          <screenshot>
+            <mediaobject>
+              <imageobject>
+                <imagedata fileref="images/jobs_shadow1.png" />
+              </imageobject>
+            </mediaobject>
+          </screenshot>
+
+          <table>
+            <title>Options</title>
+
+            <tgroup cols="2">
+              <tbody>
+                <row>
+                  <entry><emphasis role="bold">Option</emphasis></entry>
+
+                  <entry><emphasis role="bold">Description</emphasis></entry>
+                </row>
+
+                <row>
+                  <entry>From address</entry>
+
+                  <entry>The email address to set as FROM.</entry>
+                </row>
+
+                <row>
+                  <entry>Reply-to address</entry>
+
+                  <entry>Optional Reply-to address for email.</entry>
+                </row>
+
+                <row>
+                  <entry>Subject</entry>
+
+                  <entry>The email subject line. Supports wildcards, see
+                  below.</entry>
+                </row>
+
+                <row>
+                  <entry>Text</entry>
+
+                  <entry>The email body text. Supports wildcards, see
+                  below.</entry>
+                </row>
+
+                <row>
+                  <entry>Notification period</entry>
+
+                  <entry>Number of days to notify before password
+                  expires.</entry>
+                </row>
+              </tbody>
+            </tgroup>
+          </table>
+
+          <para>Wildcards:</para>
+
+          <para>You can enter LDAP attributes as wildcards in the form
+          @@ATTRIBUTE_NAME@@. E.g. to add the user's common name use "@@cn@@".
+          For the common name it would be "@@cn@@".</para>
+        </section>
       </section>
 
       <section id="confTypicalScenarios">