diff options
author | gramanas <anastasis.gramm2@gmail.com> | 2019-03-27 19:56:24 +0200 |
---|---|---|
committer | gramanas <anastasis.gramm2@gmail.com> | 2020-12-25 21:34:36 +0200 |
commit | 5b4a10af81c60c6c4787d95f82004094f358459c (patch) | |
tree | 6f7b358288926bd5c501755d1e8f2872fb68d046 /quart.5.scd | |
download | quart-5b4a10af81c60c6c4787d95f82004094f358459c.tar.gz quart-5b4a10af81c60c6c4787d95f82004094f358459c.tar.bz2 quart-5b4a10af81c60c6c4787d95f82004094f358459c.zip |
Initial..
Diffstat (limited to 'quart.5.scd')
-rw-r--r-- | quart.5.scd | 90 |
1 files changed, 90 insertions, 0 deletions
diff --git a/quart.5.scd b/quart.5.scd new file mode 100644 index 0000000..438dfad --- /dev/null +++ b/quart.5.scd @@ -0,0 +1,90 @@ +quart(5) + +; Tabs are required for indentation (<C-q tab> in emacs) + +# NAME + +quart - document format for *quart*(1) schedules + +# SYNTAX + +*quart* files are inspired by emacs' org-mode. The header contains the time +that the schedule begins and each line represents a quarter of time, or 15 +minures. + +## HEADER + +Before any task, every *quart* file must contain a header with the starting +time of the schedule. It looks like this: + +``` +#+START: 9:15 +``` + +It is case insenstive. + +## COMMENTS + +Every line beginning with `#` is ignored. Comments must start at the beginning +of the line. + +## BODY + +The body of the document contains the tasks. Each task is a line starting with `\* ` +(asterisk and space). The full definition of a task looks like this: + + \* [_REPETITION_] [_FLAG_] <*DESCRIPTION*> + +_FLAG_ and _REPETION_ are optional. See the respective sections below. + +The description can be any arbitrary string. + +## FLAGS + +Each task can have a _flag_ set to make it pop out. There are three flags avaliable: + +|- *Char* +:] *Flag* +:[ *Description* +|- \! +: _Urgent_ +:[ Mark task as important. +|- ? +: _Maybe_ +:[ Mark task as mayhap. +|- @ +: _Depends_ +:[ Task that depends on someone else. + +Use them by adding the required _char_ after the `\* ` in a task: + +``` +#+start: 9:30 +\* ! Meet with Knuth. +``` + +If used with _repetition_ it must go *after* it. + +## REPETITION + +Allows repetition of a task for as many quarters as needed in succession. + +Use them by adding a number right after the `\* ` in a task: + +``` +#+start: 11:30 +* 8 Boring 2h meeting. +``` + +If used with _flags_ it must go *before* any. + +## SPECIAL + +There are two special symbols the _DESCRIPTION_ can contain: + +*=* + Repeat the previous task. It will only carry over the description + so it can contain a different _flag_ or _repetition_ number. + +*-* + None, the most important thing. 15 minutes of doing nothing.
\ No newline at end of file |