ANNO(1)

✨ NAME ✨

okay bestie, this is the manual page for anno from the General Commands Manual 📚 and it's literally the cutest little tool 🎀 anno is how you annotate nmh messages 💖

---

💅 SYNOPSIS 💅

anno [-help] [-version] [+folder] [msgs] [-component field] [-inplace |
     -noinplace] [-date | -nodate] [-draft] [-append] [-list] [-delete]
     [-number [num|all]] [-preserve | -nopreserve] [-text body]

---

🦋 DESCRIPTION 🦋

okay so anno lets you mess with header fields or annotations inside messages 🫶 a header field is a field name plus an optional field body, and that's defined by RFC 2822 (the nerdy rulebook 🤓). The -component switch sets the field name and the -text switch sets the field body. Easy.

The messages it works on are either the msgs in the folder you name, or the draft if you use -draft ✨

Usually, annotation is handled by dist, forw, and repl if you give them the -anno switch. This is how you keep track of who your message got distributed to, forwarded to, and replied to 💌 so iconic.

But ngl, you can also do your own arbitrary annotations 👑 every message you select gets annotated with these lines:

field: date
field: body

The -nodate switch is for when you want to skip the date line and only keep the body annotation 🙈

By default, anno prepends annotations to the message. If you want them tacked on at the end instead, use -append 🌸

If you don't pass a -component field when you run anno, it'll prompt you for a field name. No stress, it's got you 🧚

The field you pick has to be a valid RFC 2822-style message field name, which means it can only have alphanumeric characters and dashes 💜 The body can be any arbitrary text you want 🍓

Normally anno does the annotation in place so any links to the message stay intact 🔗 if you'd rather it didn't, use -noinplace ✨

The -list switch gives you a listing of the field bodies for header fields whose names match your component, one per line 📋 Add -number and the listing gets numbered starting at 1. A tab separates the number from the field body 🎀 The field body gets treated like a file name, so only the final path name component is listed. Want the whole thing? Use -text. The argument to -text is required but ignored, so just put something there 🙃

The -delete switch removes header fields from messages 🗑️ If you don't use any other options, it deletes the first header field whose name matches the component. If you pair -text with -delete, it deletes the first header field whose name matches the component and whose body matches your text. The text gets treated like a file name too: if it begins with a slash, the entire field body has to match, otherwise just the last path name component of the field body has to match 🧐

If you use -number with -delete, it deletes header field num whose name matches the component. The number matches whatever -list produces 🔢 And the special value all is the main character move: it deletes every component that matches the name 💀

By default, anno changes the last-accessed and last-modified times on annotated messages to the time of the annotation ⏰ If you want to keep the original times, use -preserve. The -nopreserve switch turns time preservation off, which matters if it's been enabled in your profile 🌈

🚨 heads up: the -delete switch removes header fields, so double-check your component and text before you hit enter. no take-backs, bestie 😭

---

🌸 FILES 🌸

• $HOME/.mh_profile — this is the user's profile, the little settings file that anno checks in on 🏡

---

🍓 PROFILE COMPONENTS 🍓

• Path: — this one helps anno figure out the user's nmh directory 📂
• Current-Folder: — this one helps anno find the default current folder 💖

---

🦋 SEE ALSO 🦋

dist(1), forw(1), repl(1) 🫶 these are your besties in the annotation squad

---

👑 DEFAULTS 👑

• +folder — the current folder 📁
• msgs — the current message 💌
• -inplace — the default annotation style, so links stay happy 🔗
• -date — the date annotation is included by default 📅

---

✨ CONTEXT ✨

if you give anno a folder, that folder becomes the current folder 🎀 and the first message it annotates becomes the current message 💅

---

okay that's the whole tea 🫖 this page came from nmh-1.8, dated 2005-12-07, and it's the ANNO(1) manual page. slay, bestie, go annotate something 💖🦋🌈