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]