ANNO(1mh)

💖 ANNO — annotate nmh messages 💖

okay bestie, so this is anno, aka the little glow-up tool for your nmh messages ✨ It's from the 1mh manual section, and it does exactly what it says on the tin: it annotates your messages. No cap.

---

🌸 SYNOPSIS 🌸

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

---

🦋 DESCRIPTION 🦋

So anno messes with header fields (or, like, annotations) in messages. A header field is made up of a field name plus an optional field body, as defined by RFC 2822. The -component switch is how you say the field name, and the -text switch is how you say the field body. 🎀

The messages it works on are either the msgs in the folder you named, or the draft — but only if you invoke it with the -draft switch. iykyk.

Normally, the annotating is done for you by dist, forw, and repl, if you hand them the -anno switch. That's how you keep track of your distribution of, forwarding of, and replies to a message. so organized of you 💅

But with anno itself, you can do arbitrary annotations of your own. Every message you select gets annotated with the lines:

field: date
field: body

The -nodate switch shuts the date annotation down, leaving only the body annotation. no date, no drama.

By default, anno prepends the annotations to the message. They get appended instead if you pass -append. 🔥

If you don't specify a -component field when you invoke anno, it will literally prompt you for a field name. It's asking, bestie.

Heads up: the field you specify must be a valid RFC 2822-style message field name — only alphanumeric characters and dashes. Periodt. The body can be arbitrary text, anything goes.

Normally anno does the annotation in place, so that any links to the message stay intact. You can change that with the -noinplace switch. 👑

The -list switch produces a listing of the field bodies for header fields whose names match the specified component, one per line. That listing is numbered, starting at 1, if -number is also used. A tab character separates the number and the field body. The field body is treated as if it is a file name, and only the final path name component is listed. The complete field body is listed if the -text switch is used — and yes, the argument to -text is required here but literally ignored. 🙈

The -delete switch removes header fields from messages. The first header field whose name matches the component is deleted if no other options are specified. If you use -text together with -delete, the first header field whose name matches the component and whose body matches the text gets deleted. That text is treated as if it was a file name: if it begins with a slash, the entire field body must match the text; otherwise just the last path name component of the field body has to match. If you use -number together with -delete, header field number num whose name matches the component is deleted. That number matches the one produced by the -list switch. The special value all works for the number, and it makes all components that match the name get deleted. bye felicia 💀

By default, anno changes the last-accessed and last-modified times on annotated messages to the time of the annotation. anno preserves the original times if you use the -preserve switch. And a matching -nopreserve switch lets you turn time preservation back off, if it was enabled in the profile. ⭐

---

🎀 FILES 🎀

• $HOME/.mh_profile — the user's profile.

---

💜 PROFILE COMPONENTS 💜

• Path: — to determine the user's nmh directory.
• Current-Folder: — to find the default current folder.

---

✨ SEE ALSO ✨

dist(1), forw(1), repl(1)

---

🌈 DEFAULTS 🌈

• +folder — the current folder.
• msgs — the current message.
• -inplace
• -date

---

🫶 CONTEXT 🫶

If a folder is given, it becomes the current folder. And the first message annotated becomes the current message. main character energy fr fr 👑

---

and that's the whole page, bestie!! this one's from nmh-1.8, dated 2005-12-07, and it's filed under ANNO(1mh). slay, go annotate something 💅✨