From acb37c3eb355afb1e3884458b614b9cf00cb71b1 Mon Sep 17 00:00:00 2001 From: Karl Voit Date: Sat, 3 Mar 2012 12:23:58 +0100 Subject: [PATCH] created README.org --- README.org | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 README.org diff --git a/README.org b/README.org new file mode 100644 index 0000000..99d668e --- /dev/null +++ b/README.org @@ -0,0 +1,37 @@ +* Handling time-stamps and date-stamps in file names + +Per default, date2name gets the modification time of matching files +and directories and adds a datestamp in standard ISO 8601+ format +YYYY-MM-DD (http://datestamp.org/index.shtml) at the beginning of +the file- or directoryname. + +If an existing timestamp is found, its style will be converted to the +selected ISO datestamp format but the numbers stays the same. +Executed with an examplefilename "file" this results e.g. in +"2008-12-31_file". + +Note: Other that defined in ISO 8601+ the delimiter between hours, +minutes, and seconds is not a colon but a dot. Colons are causing +several problems on different file systems and are there fore replaced +with the (older) DIN 5008 version with dots. + +: Usage: +: date2name [options] file ... + +Run "date2name --help" for usage hints + +: Options: +: -h, --help show this help message and exit +: -d, --directories modify only directory names +: -f, --files modify only file names +: --compact use compact datestamp (YYYYMMDD) +: --month use datestamp with year and month (YYYY-MM) +: --withtime use datestamp including seconds (YYYY-MM-DDThh.mm.ss) +: -m, --mtime take modification time for datestamp [default] +: -c, --ctime take creation time for datestamp +: -q, --quiet do not output anything but just errors on console +: -v, --verbose enable verbose mode +: --nocorrections do not convert existing datestamps to new format +: -s, --dryrun enable dryrun mode: just simulate what would happen, do +: not modify files or directories +: --version display version and exit