Skip to content

Editing DSU Entries

Gene M. Angelo, Jr edited this page Jan 7, 2024 · 7 revisions

You can edit DSU entry groups by date. dsu will allow you to edit a DSU entry group using the dsu edit SUBCOMMAND date (n|today|t|tomorrow|y|yesterday|date DATE) you specify. dsu edit will open your DSU entry group entries in your editor, where you'll be able to perform editing functions against one or all of the entries. See "Customizing the dsu configuration file" in order to configure dsu to use the editor of your choice, in order to make editing more convenient.

If no entries exist for the DSU date, the editor will open and allow you to add entries for that date. If you have the :carry_over_entries_to_today configuration option setting set to true, entries from the last DSU date will be copied into the editor for your convenience. Understand that duplicate entries are not allowed; that is, the entry DESCRIPTION must be unique within an entry group (date), so non-unique entries will not be saved. The same holds true for entries that do not pass validation (DESCRIPTION must be between 2 and 256 characters (inclusive) in length).

  • dsu edit today
  • dsu e n # Equivalent to the above, only using shortcuts
  • dsu edit tomorrow
  • dsu e t # Equivalent to the above, only using shortcuts
  • dsu edit yesterday
  • dsu e y # Equivalent to the above, only using shortcuts
  • dsu edit date DATE
  • dsu e d DATE # Equivalent to the above, only using shortcuts

Examples

The following will edit your DSU entry group entries for "Today", where Time.now == '2023-05-09 12:13:45.8273 -0400'. Simply follow the directions in the editor file, then save and close your editor to apply the changes.

Any editor line that starts with a # in the first character position will be considered a comment and ignored (not saved). Any editor line that does not start with a # in the first character position will be considered an entry and saved.

dsu edit today
dsu e n # Equivalent to the above, only using shortcuts
image

Edit an Entry

To edit an existing entry, simply change the entry description text in your editor and save.

Add an Entry

To add a new entry, simply type a new entry on a separate line in your editor and save.

Delete an Entry

To delete an existing entry, simply delete the entry in your editor and save.

Reorder Entries

To reorder entries, simply reorder the entries in your editor and save.