Update function reference; remove unused functions

Removed
chronometrist-report-format-date
chronometrist-statistics-format-date
chronometrist-interval
This commit is contained in:
contrapunctus 2020-05-21 08:36:35 +05:30
parent b2c7d2763c
commit b5c5cfd4a2
4 changed files with 76 additions and 93 deletions

View File

@ -94,14 +94,6 @@ The first date is the first occurrence of
(vector))))))
chronometrist-task-list)))
(defun chronometrist-report-format-date (format-string time-date)
"Extract date from TIME-DATE and format it according to FORMAT-STRING."
(->> time-date
(-take 6)
(-drop 3)
(reverse)
(apply #'format format-string)))
(defun chronometrist-report-print-keybind (command &optional description firstonly)
"Insert one or more keybindings for COMMAND into the current buffer.
DESCRIPTION is a description of the command.

View File

@ -166,11 +166,6 @@ If FIRSTONLY is non-nil, return only the first keybinding found."
" - "
(if description description "")))
(defun chronometrist-statistics-format-date (date)
"Return DATE (YEAR MONTH DAY) as a string in the form \"YYYY-MM-DD\"."
(-let [(year month day) date]
(format "%04d-%02d-%02d" year month day)))
(defun chronometrist-statistics-print-non-tabular ()
"Print the non-tabular part of the buffer in `chronometrist-statistics'."
(let ((w "\n ")

View File

@ -98,14 +98,6 @@ SECONDS must be a positive integer."
(h (/ seconds 3600)))
(list h m s)))
(defun chronometrist-interval (event)
"Return the period of time covered by EVENT as a time value.
EVENT should be a plist (see `chronometrist-file')."
(let ((start (plist-get event :start))
(stop (plist-get event :stop)))
(time-subtract (parse-iso8601-time-string stop)
(parse-iso8601-time-string start))))
(provide 'chronometrist-time)
;; Local Variables:

View File

@ -74,7 +74,7 @@
4. Variable - chronometrist-task-list
5. Internal Variable - chronometrist--fs-watch
6. Function - chronometrist-current-task ()
7. Function - chronometrist-format-time (seconds &optional blank)
7. Function - chronometrist-format-time (seconds &optional (blank " "))
* seconds -> "h:m:s"
8. Function - chronometrist-common-file-empty-p (file)
9. Function - chronometrist-common-clear-buffer (buffer)
@ -108,47 +108,47 @@
5. Function - chronometrist-common-create-file ()
6. Function - chronometrist-task-active? (task)
* String -> Boolean
7. Function - chronometrist-activity-indicator ()
8. Function - chronometrist-entries ()
9. Function - chronometrist-task-at-point ()
10. Function - chronometrist-goto-last-task ()
11. Function - chronometrist-print-keybind (command &optional description firstonly)
12. Function - chronometrist-print-non-tabular ()
13. Function - chronometrist-goto-nth-task (n)
14. Function - chronometrist-refresh (&optional ignore-auto noconfirm)
15. Function - chronometrist-refresh-file (fs-event)
16. Command - chronometrist-query-stop ()
17. Command - chronometrist-in (task &optional prefix)
18. Command - chronometrist-out (&optional prefix)
19. Variable - chronometrist-before-in-functions
20. Variable - chronometrist-after-in-functions
21. Variable - chronometrist-before-out-functions
22. Variable - chronometrist-after-out-functions
23. Function - chronometrist-run-functions-and-clock-in (task)
24. Function - chronometrist-run-functions-and-clock-out (task)
25. Keymap - chronometrist-mode-map
26. Major Mode - chronometrist-mode
27. Function - chronometrist-toggle-task-button (button)
28. Function - chronometrist-add-new-task-button (button)
29. Command - chronometrist-toggle-task (&optional prefix inhibit-hooks)
30. Command - chronometrist-toggle-task-no-hooks (&optional prefix)
31. Command - chronometrist-add-new-task ()
32. Command - chronometrist (&optional arg)
7. Function - chronometrist-use-goals? ()
8. Function - chronometrist-activity-indicator ()
9. Function - chronometrist-entries ()
10. Function - chronometrist-task-at-point ()
11. Function - chronometrist-goto-last-task ()
12. Function - chronometrist-print-keybind (command &optional description firstonly)
13. Function - chronometrist-print-non-tabular ()
14. Function - chronometrist-goto-nth-task (n)
15. Function - chronometrist-refresh (&optional ignore-auto noconfirm)
16. Function - chronometrist-refresh-file (fs-event)
17. Command - chronometrist-query-stop ()
18. Command - chronometrist-in (task &optional _prefix)
19. Command - chronometrist-out (&optional _prefix)
20. Variable - chronometrist-before-in-functions
21. Variable - chronometrist-after-in-functions
22. Variable - chronometrist-before-out-functions
23. Variable - chronometrist-after-out-functions
24. Function - chronometrist-run-functions-and-clock-in (task)
25. Function - chronometrist-run-functions-and-clock-out (task)
26. Keymap - chronometrist-mode-map
27. Major Mode - chronometrist-mode
28. Function - chronometrist-toggle-task-button (button)
29. Function - chronometrist-add-new-task-button (button)
30. Command - chronometrist-toggle-task (&optional prefix inhibit-hooks)
31. Command - chronometrist-toggle-task-no-hooks (&optional prefix)
32. Command - chronometrist-add-new-task ()
33. Command - chronometrist (&optional arg)
*** chronometrist-events.el
1. Variable - chronometrist-events
* keys - iso-date
2. Function - chronometrist-list-midnight-spanning-events ()
3. Function - chronometrist-day-start (timestamp)
2. Function - chronometrist-day-start (timestamp)
* iso-timestamp -> encode-time
4. Function - chronometrist-file-clean ()
3. Function - chronometrist-file-clean ()
* commented out, unused
5. Function - chronometrist-events-maybe-split (event)
6. Function - chronometrist-events-populate ()
7. Function - chronometrist-tasks-from-table ()
8. Function - chronometrist-events-subset (start end)
4. Function - chronometrist-events-maybe-split (event)
5. Function - chronometrist-events-populate ()
6. Function - chronometrist-tasks-from-table ()
7. Function - chronometrist-events-subset (start end)
* ts ts -> hash-table
9. Function - chronometrist-events-query-spec-match-p (plist specifiers)
10. Function - chronometrist-events-query (table &key get specifiers except)
8. Function - chronometrist-events-query-spec-match-p (plist specifiers)
9. Function - chronometrist-events-query (table &key get specifiers except)
*** chronometrist-migrate.el
1. Variable - chronometrist-migrate-table
2. Function - chronometrist-migrate-populate (in-file)
@ -165,12 +165,12 @@
*** chronometrist-queries.el
1. Function - chronometrist-last ()
* -> plist
2. Function - chronometrist-task-time-one-day (task &optional (date-string (chronometrist-queries-date)))
* String &optional iso-date -> seconds
2. Function - chronometrist-task-time-one-day (task &optional (ts (ts-now)))
* String &optional ts -> seconds
3. Function - chronometrist-active-time-one-day (&optional ts)
* &optional ts -> seconds
4. Function - chronometrist-statistics-count-active-days (task &optional (table chronometrist-events))
5. Function - chronometrist-task-events-in-day (task date-string)
5. Function - chronometrist-task-events-in-day (task ts)
*** chronometrist-report-custom.el
1. Custom variable - chronometrist-report-buffer-name
2. Custom variable - chronometrist-report-week-start-day
@ -184,16 +184,15 @@
* ts-1 -> (ts-1 ... ts-7)
6. Function - chronometrist-report-date->week-dates ()
7. Function - chronometrist-report-entries ()
8. Function - chronometrist-report-format-date (format-string time-date)
9. Function - chronometrist-report-print-keybind (command &optional description firstonly)
10. Function - chronometrist-report-print-non-tabular ()
11. Function - chronometrist-report-refresh (&optional ignore-auto noconfirm)
12. Function - chronometrist-report-refresh-file (fs-event)
13. Keymap - chronometrist-report-mode-map
14. Major Mode - chronometrist-report-mode
15. Function - chronometrist-report (&optional keep-date)
16. Function - chronometrist-report-previous-week (arg)
17. Function - chronometrist-report-next-week (arg)
8. Function - chronometrist-report-print-keybind (command &optional description firstonly)
9. Function - chronometrist-report-print-non-tabular ()
10. Function - chronometrist-report-refresh (&optional _ignore-auto _noconfirm)
11. Function - chronometrist-report-refresh-file (_fs-event)
12. Keymap - chronometrist-report-mode-map
13. Major Mode - chronometrist-report-mode
14. Function - chronometrist-report (&optional keep-date)
15. Function - chronometrist-report-previous-week (arg)
16. Function - chronometrist-report-next-week (arg)
*** chronometrist-key-values.el
1. Internal Variable - chronometrist--tag-suggestions
2. Internal Variable - chronometrist--value-suggestions
@ -228,19 +227,18 @@
*** chronometrist-statistics.el
1. Internal Variable - chronometrist-statistics--ui-state
2. Internal Variable - chronometrist-statistics--point
3. Keymap - chronometrist-statistics-mode-map
4. Function - chronometrist-statistics-count-average-time-spent (task &optional (table chronometrist-events))
3. Function - chronometrist-statistics-count-average-time-spent (task &optional (table chronometrist-events))
* string &optional hash-table -> seconds
5. Function - chronometrist-statistics-entries-internal (table)
6. Function - chronometrist-statistics-entries ()
7. Function - chronometrist-statistics-print-keybind (command &optional description firstonly)
8. Function - chronometrist-statistics-format-date (date)
9. Function - chronometrist-statistics-print-non-tabular ()
10. Function - chronometrist-statistics-refresh (&optional ignore-auto noconfirm)
11. Major Mode - chronometrist-statistics-mode
12. Command - chronometrist-statistics (&optional preserve-state)
13. Command - chronometrist-statistics-previous-range (arg)
14. Command - chronometrist-statistics-next-range (arg)
4. Function - chronometrist-statistics-entries-internal (table)
5. Function - chronometrist-statistics-entries ()
6. Function - chronometrist-statistics-print-keybind (command &optional description firstonly)
7. Function - chronometrist-statistics-print-non-tabular ()
8. Function - chronometrist-statistics-refresh (&optional ignore-auto noconfirm)
9. Keymap - chronometrist-statistics-mode-map
10. Major Mode - chronometrist-statistics-mode
11. Command - chronometrist-statistics (&optional preserve-state)
12. Command - chronometrist-statistics-previous-range (arg)
13. Command - chronometrist-statistics-next-range (arg)
*** chronometrist-time.el
1. Function - chronometrist-iso-timestamp->ts (timestamp)
* iso-timestamp -> ts
@ -260,17 +258,23 @@
5. Command - chronometrist-force-restart-timer ()
6. Command - chronometrist-change-update-interval (arg)
*** chronometrist-goals
1. Custom Variable - chronometrist-goals-list nil
2. Function - chronometrist-run-at-time (time repeat function &rest args)
3. Function - chronometrist-seconds->alert-string (seconds)
4. Function - chronometrist-approach-alert (task goal spent)
5. Function - chronometrist-complete-alert (task goal spent)
6. Function - chronometrist-exceed-alert (task goal spent)
7. Function - chronometrist-no-goal-alert (task goal spent)
8. Custom Variable - chronometrist-goals-alert-functions
9. Function - chronometrist-get-goal (task &optional (goals-list chronometrist-goals-list))
* String &optional List -> minutes
10. Internal Variable - chronometrist--timers-list
1. Internal Variable - chronometrist--timers-list
2. Custom Variable - chronometrist-goals-list nil
3. Function - chronometrist-run-at-time (time repeat function &rest args)
4. Function - chronometrist-seconds->alert-string (seconds)
* seconds -> string
5. Function - chronometrist-approach-alert (task goal spent)
* string minutes minutes
6. Function - chronometrist-complete-alert (task goal spent)
* string minutes minutes
7. Function - chronometrist-exceed-alert (task goal spent)
* string minutes minutes
8. Function - chronometrist-no-goal-alert (task goal spent)
* string minutes minutes
9. Custom Variable - chronometrist-goals-alert-functions
* each function is passed - string minutes minutes
10. Function - chronometrist-get-goal (task &optional (goals-list chronometrist-goals-list))
* String &optional List -> minutes
11. Function - chronometrist-goals-run-alert-timers (task)
12. Function - chronometrist-goals-stop-alert-timers (&optional _task)
13. Function - chronometrist-goals-on-file-change ()