mma-libdoc(8)

💖 mma-libdoc — bestie's guide to keeping your mma library docs cute and current 💖

okay so this is mma-libdoc(8), and it lives in the System Manager's Manual section of the Unix world. It's a little script, it does one job, and honestly? It eats. Let's get into it. ✨

---

🌸 NAME 🌸

mma-libdoc — maintain mma library files. That's it. That's the whole girl. 🎀

---

✨ SYNOPSIS ✨

mma-libdoc

no args, no flags, no drama. she just runs. 💅

---

🦋 DESCRIPTION 🦋

So here's the tea: mma-libdoc updates and maintains the HTML documentation for the MMA library. If you're one of those gorgeous people adding 3rd party files to the lib tree, this one's literally recommended for you. 🫶

If you've already downloaded and installed MMA, then the HTML documentation should already be sitting pretty on your system. The docs for the library files live in /usr/local/share/mma/docs/html/lib — or somewhere similar, depending on your installation and your system. iykyk, paths be pathing. 🌈

Now, if you add or modify the library files? You literally just run mma-libdoc and boom — the library documentation gets updated. that's the whole vibe check. ⭐

Note: to run this program, root privileges may be needed. It depends on your installation and your operating system. no cap. 👑

When mma-libdoc runs, it checks the installation and then installs or updates the docs in the root tree where mma is installed. main character energy fr fr. 💖

💀 Caveats 💀 (the "not me" section)

• Old/unused HTML files are NOT deleted. So if you move files around or delete .mma files, you can end up with a whole bunch of unused files just... vibing there. If it becomes a problem, just delete the whole bunch every once in awhile. spring cleaning era. 🧹
• The program assumes you already have the html documentation installed. So it doesn't do a very good job of creating the complete directory tree. If you find that you get an error right off the top of the program, you will need to create the directories by hand. Assuming you have installed in /usr/local/share/mma, a command like:

mkdir -p /usr/local/share/mma/docs/html/lib

• Depending on how your system is set up, you will most likely need to be the root user for any of this to work. If you get "permission" or "access denied" errors, run as root or fix the permissions. that's the whole thing. 😭

---

🎀 SEE ALSO 🎀

mma(1), mma-renum(1). go give them a read, bestie. 💜

---

🌟 RESOURCES 🌟

The latest version of this program is always distributed with MMA and is available at http://www.mellowood.ca/mma — go check it out. 🔥

---

👑 AUTHOR 👑

Bob van der Poel <bob@mellowood.ca> — icon, legend, the moment. 🫶

---

🌈 LICENSE 🌈

mma-libdoc is Copyright 2003-2017 Bob van der Poel. Free use of this software is granted under the terms of the GNU General Public License. periodt. 💅

---

and that's the page, babes — it's mma-libdoc(8) from the System Manager's Manual, and it says so right there in the footer too. mwah. 💖✨