Updated the AndTrigger example to use CalendarIntervalTrigger instead…

… of IntervalTrigger

apscheduler/triggers/combining.py

@@ -50,6 +50,15 @@ class AndTrigger(BaseCombiningTrigger):
 
     Trigger alias: ``and``
 
+    .. warning:: This trigger should only be used to combine triggers that fire on
+        specific times of day, such as
+        :class:`~apscheduler.triggers.cron.CronTrigger` and
+        class:`~apscheduler.triggers.calendarinterval.CalendarIntervalTrigger`.
+        Attempting to use it with
+        :class:`~apscheduler.triggers.interval.IntervalTrigger` will likely result in
+        the scheduler hanging as it tries to find a fire time that matches exactly
+        between fire times produced by all the given triggers.
+
     :param list triggers: triggers to combine
     :param int|None jitter: delay the job execution by ``jitter`` seconds at most
     """

docs/modules/triggers/combining.rst

@@ -17,18 +17,19 @@ API
 Examples
 --------
 
-Run ``job_function`` every 2 hours, but only on Saturdays and Sundays::
+Run ``job_function`` every 3 days (at midnight), but only when that date lands on on a
+Saturday or Sunday::
 
     from apscheduler.triggers.combining import AndTrigger
-    from apscheduler.triggers.interval import IntervalTrigger
+    from apscheduler.triggers.calendarinterval import CalendarIntervalTrigger
     from apscheduler.triggers.cron import CronTrigger
 
 
-    trigger = AndTrigger([IntervalTrigger(hours=2),
+    trigger = AndTrigger([CalendarIntervalTrigger(days=3),
                           CronTrigger(day_of_week='sat,sun')])
     scheduler.add_job(job_function, trigger)
 
-Run ``job_function`` every Monday at 2am and every Tuesday at 3pm::
+Run ``job_function`` every Monday at 2 am and every Tuesday at 3 pm::
 
     trigger = OrTrigger([CronTrigger(day_of_week='mon', hour=2),
                          CronTrigger(day_of_week='tue', hour=15)])