1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
<page xmlns="http://projectmallard.org/1.0/"
type="topic"
id="input">
<info>
<link type="guide" xref="index"/>
<desc>Tricks to speed up activity entry.</desc>
</info>
<title>Input</title>
<p>
To start tracking, press the <gui style="button">+</gui> button,
type in the activity name in the entry,
and hit the <key>Enter</key> key.
To specify more detail on the fly, use this syntax:
`time_info activity name@category, some description, #tag #other tag with spaces`.
</p>
<steps>
<item><p>Specify specific times as `13:10-13:45`, and "started 5 minutes ago" as `-5`.</p></item>
<item><p>Next comes the activity name</p></item>
<item><p>Place the category after the activity name, and start it with an at sign `@`, e.g. `@garden`</p></item>
<item><p>If you want to add a description and/or tags, add a comma `,`.</p></item>
<item><p>The description is just freeform text immediately after the comma, and runs until the end of the string or until the beginning of tags.</p></item>
<item><p>Place tags at the end right after a comma, and start each tag with a hash mark `#`.</p></item>
</steps>
<p>Note that you can embed single-word tags in the description just by
prepending a hash to any word. Note that sequences of alphanumeric
characters that start with a digit are not considered as words so if you
use <code>Fix bug #123</code> as your description, the hash will be kept
and there will be no supplementary tag named <code>123</code>.</p>
<p>
A few examples:
</p>
<example>
<code>12:30-12:45 watering flowers</code>
<p>Forgot to note the important act of watering flowers over lunch.</p>
</example>
<example>
<code>tomatoes@garden, digging holes</code>
<p>
Need more tomatoes in the garden. Digging holes is purely informational,
so added it as a description.
</p>
</example>
<example>
<code>-7 existentialism, thinking about the vastness of the universe</code>
<p>
Corrected information by informing application that I've been
doing something else for the last seven minutes.
</p>
</example>
<example>
<code>Hamster@Software, doing some #reviews of pull requests</code>
<code>Hamster@Software, doing some reviews of pull requests, #reviews</code>
<p>
Those two syntaxes are equivalent. Single word tags can be embedded in the
description (except on the first word).
</p>
</example>
<note style="info">
<title>Time input</title>
<list>
<item>
<p>Relative times work both for <var>start</var> and <var>end</var>,
provided they are preceded by an explicit sign,
and <em>separated by a space</em>.</p>
<p><code>-30 -10</code> means started 30 minutes ago and stopped 10 minutes ago.</p>
<p><code>-5 +30</code> means started 5 minutes ago and will stop in 30 minutes
(duration of 35 minutes).</p>
</item>
<item>
<p>Duration can be given instead of <var>end</var>,
as 1, 2 or 3 digits without any sign.</p>
<p><code>-50 30</code> means started 50 minutes ago and lasted 30 minutes
(so it ended 20 minutes ago).</p>
</item>
<item>
<p>Times can be entered with a colon (<code>hh:mm</code>),
with a dot (<code>hh.mm</code>) or just the 4 digits (<code>hhmm</code>).</p>
</item>
<item>
<p>Date can be specified in ISO format (YYYY-MM-DD), e.g. `2019-12-24 19:00`. Otherwise, the time belongs to the current hamster day or, in the gui, to the day selected in the timeline.</p>
</item>
</list>
</note>
</page>
|
