WORKLOG(1)

💖 WORKLOG(1) 💖

okay bestie, welcome to the General Commands Manual, section 1, and today's main character is worklog 💅

---

✨ NAME ✨

worklog — a program for keeping track of time spent on different projects 🕐✨

---

🌸 SYNOPSIS 🌸

worklog [<project config file> [<log file>]]

---

🦋 DESCRIPTION 🦋

so worklog is literally a program that helps you keep track of your time. it's a simple ncurses based based program that runs a clock and logs time to a logfile 🕰️ no cap, that's the whole vibe.

when worklog is invoked, it reads the project configuration file, and then periodically appends to the log file throughout the extent of its run. like, the whole time it's running. constantly. it's committed 🫶

individual logfiles are also kept on a per-project basis. the key of each project is used to construct a separate log file made unique by appending .X to the name of the main log file, where X is the key character. so yes, every project gets its own little diary 📓✨

press Control-L to redraw the screen — sometimes useful when resizing the window. it's giving "my screen is glitching bestie" energy and this fixes it 💅

---

🎀 THE PROJECT CONFIGURATION FILE 🎀

the project configuration file is a text file containing a project and its associated key-character on separate lines. the format of a project line is :

<key>:<name>

comments may be preceded by the # character 💬

---

🌈 EXAMPLE PROJECT CONFIGURATION FILE 🌈

# Worklog project file
# note that projects appear in Worklog in REVERSE order

B:BOWER consultation
L:LIS consultation
R:Research
D:DEC system administration
P:Problems email
S:Sugar administration
r:Reading NetNews

bestie read that comment again — projects appear in Worklog in REVERSE order. not a drill. lowercase r for Reading NetNews and uppercase R for Research are two entirely different projects, so watch your shift key 🔥

---

👑 AUTHOR 👑

worklog was written by Truxton King Fulton II 🫶

---

💀 BUGS 💀

if you find one, please report it to trux@truxton.com — she's not mad, she just wants to know 🙈

---

and that's the whole page, bestie!! it's a General Commands Manual situation, section 1, WORKLOG(1), and yeah the footer is just WORKLOG(1) again because it's an icon and it said so. go log some hours, you absolute legend 💖✨🎀