From 9a57073dd69c48f17abf0aa20dd8a7f8164a0b6e Mon Sep 17 00:00:00 2001 From: gennyble Date: Thu, 24 Aug 2023 19:27:11 -0500 Subject: readme --- readme.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/readme.md b/readme.md index 50c4119..522ffe6 100644 --- a/readme.md +++ b/readme.md @@ -1,2 +1,17 @@ +`whenwasit path` little thing meant to be called in a git-hook as to keep track of -file creation and modification dates, which are important to me. \ No newline at end of file +file creation and modification dates, which are important to me. +dumps csv output on stdout, errors abort with a panic. + +**CSV Output Defintion:** +data is output on `stdout` in a CSV format. because there are +varying ways to make a CSV, it's described in detail below. + +- there is no data header; the first row is data +- the data rows are in the format `path,btime,mtime,atime` + - `path`: file path relative to the root that was provided on the command line + - `btime`: time of file creation; birth time + - `mtime`: time file was last modified + - `atime`: time file was last accessed +- if the `path` contains a comma (`,`) or a backslash (`\`), it is escape with a backslash +- if any one of the time cannot be attained, the field is left empty. \ No newline at end of file -- cgit 1.4.1-3-g733a5