From 8d1351064e927481a7dfbc4aad57ec646d3d4730 Mon Sep 17 00:00:00 2001
From: vincent <vincent@groupe-sa.fr>
Date: Mon, 4 Jan 2016 11:57:55 +0100
Subject: [PATCH] TODO file.

---
 TODO | 75 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)
 create mode 100644 TODO

diff --git a/TODO b/TODO
new file mode 100644
index 0000000..1c73613
--- /dev/null
+++ b/TODO
@@ -0,0 +1,75 @@
+The following is greatly inspired by python-crontab (https://pypi.python.org/pypi/python-crontab), Wikipedia (https://en.wikipedia.org/wiki/Cron#CRON_expression).
+
+Field Name    Mandatory Allowed Values  Special Characters      Extra Values
+Minutes       Yes       0-59            * / , -                 < >
+Hours         Yes 	0-23            * / , -         	< >
+Day of month  Yes 	1-31            * / , -                 < >
+Month         Yes 	1-12 or JAN-DEC * / , -         	< >
+Day of week   Yes 	0-6 or SUN-SAT 	* / , -         	< >
+Year          No        2015-2100       * , -
+
+Extra Values are < for minimum value, such as 0 for minutes or 1 for
+months. And > for maximum value, such as 23 for hours or 12 for
+months.
+
+Supported special cases allow crontab lines to not use fields. These
+are the supported aliases which are not available in SystemV mode:
+Case            Meaning
+@reboot         Every boot
+@hourly         0 * * * *
+@daily          0 0 * * *
+@weekly         0 0 * * 0
+@monthly        0 0 1 * *
+@yearly         0 0 1 1 *
+@annually       0 0 1 1 *
+@midnight       0 0 * * *
+
+Comma ( , ) Commas are used to separate items of a list. For example,
+    using "MON,WED,FRI" in the 5th field (day of week) means Mondays,
+    Wednesdays and Fridays.
+
+Hyphen ( - ) Hyphens define ranges. For example, 2000-2010 indicates
+    every year between 2000 and 2010 AD, inclusive.
+
+Percent ( % ) Percent-signs (%) in the command, unless escaped with
+    backslash (\), are changed into newline characters, and all data
+    after the first % are sent to the command as standard input.
+
+L 'L' stands for "last". When used in the day-of-week field, it allows
+    you to specify constructs such as "the last Friday" ("5L") of a
+    given month. In the day-of-month field, it specifies the last day
+    of the month.
+
+W The 'W' character is allowed for the day-of-month field. This
+    character is used to specify the weekday (Monday-Friday) nearest
+    the given day. As an example, if you were to specify "15W" as the
+    value for the day-of-month field, the meaning is: "the nearest
+    weekday to the 15th of the month." So, if the 15th is a Saturday,
+    the trigger fires on Friday the 14th. If the 15th is a Sunday, the
+    trigger fires on Monday the 16th. If the 15th is a Tuesday, then
+    it fires on Tuesday the 15th. However, if you specify "1W" as the
+    value for day-of-month, and the 1st is a Saturday, the trigger
+    fires on Monday the 3rd, as it does not 'jump' over the boundary
+    of a month's days. The 'W' character can be specified only when
+    the day-of-month is a single day, not a range or list of days.
+
+Hash ( # ) '#' is allowed for the day-of-week field, and must be
+    followed by a number between one and five. It allows you to
+    specify constructs such as "the second Friday" of a given
+    month.[13]
+
+Question mark ( ? ) In some implementations, used instead of '*' for
+    leaving either day-of-month or day-of-week blank. Other cron
+    implementations substitute "?" with the start-up time of the cron
+    daemon, so that ? ? * * * * would be updated to 25 8 * * * * if
+    cron started-up on 8:25am, and would run at this time every day
+    until restarted again.[14]
+    (WON'T BE IMPLEMENTED)
+
+Slash ( / ) In vixie-cron, slashes can be combined with ranges to
+    specify step values.[6] For example, */5 in the minutes field
+    indicates every 5 minutes (see note). It is shorthand for the more
+    verbose POSIX form 5,10,15,20,25,30,35,40,45,50,55,00. POSIX does
+    not define a use for slashes; its rationale (commenting on a BSD
+    extension) notes that the definition is based on System V format
+    but does not exclude the possibility of extensions.[5]