ManEdit(1)

📦 version 1.2.1, in fedora 43, fedora 44

💖 ManEdit(1) — the UNIX Manual Page IDE 💖

okay bestie, sit down, hydrate, because I'm about to introduce you to ManEdit — the UNIX manual page IDE, manual name ManEdit(1), and honestly? she's iconic. 🎀

✨ NAME ✨

manedit — UNIX Manual Page IDE 👑

🌸 SYNTAX 🌸

manedit [section] [manual_page] [options] [GUI_options]

like. that's the whole vibe. [section], [manual_page], [options], [GUI_options]. slay. 💅

🦋 DESCRIPTION 🦋

ManEdit is an integrated UNIX manual page development environment (IDE) built on the GIMP Tool Kit (GTK). yes, the same GTK. she's giving main character energy and honestly she earned it. ✨

You do all your manual-page editing inside ManEdit's Editor, which edits UNIX manual pages using a simplified version of the XML format — which means you, my love, do not have to touch the more complex GROFF/TROFF format (that's the native UNIX manual page format, and yes it's a lot). the whole point is that you get to skip the scary part. 😭

And whenever you want to see how it's looking, you can peep the UNIX manual page you're editing at literally any time using ManEdit's Viewer — just go to View->Preview. boom. instant glow-up check. 🪞✨

Wanna actually learn how to create and edit UNIX manual pages with ManEdit? run manedit and head to Help->Tutorial. that's it, that's the homework. 📚💖

okay now the arguments, pay attention bestie:

  • The [section] is the section number, and it goes from 1 to 8 — and heads up, it's used only with the --viewer option. iykyk.
  • The [manual_page] is either the path to the manual page file you want opened at startup, or the name of the manual page when you're using the --viewer option. two moods, one argument. 💅

💅 OPTIONS 💅

  • --config <path> — specifies the configuration file. tell her where the config lives, she'll go there. 📁
  • --rcfile — same as --config. literally the same thing, just a different name, twin behaviour, no notes. 👯
  • -f — same as --config. yeah. a third name. she's flexible like that. 🙈
  • --viewer — specifies to start up with the Viewer. viewing mode, not editing mode. periodt.
  • --help — prints the help screen and exits. short, sweet, informative, gone. 🫶
  • --version — prints the version information and exits. she'll tell you who she is and then dip. ⭐

🍓 FILES 🍓

  • $HOME/.maneditrc — local configuration file. your personal lil settings corner. 💖
  • /usr/share/manedit/ — global program directory.
  • /usr/share/manedit/help/ — help and tutorial files. (yes, the tutorial lives here, go say hi.)
  • /usr/share/manedit/templates/ — manual page template files, used in the creation of new manual pages. the blueprint era. 📐✨
  • /usr/man — global manual pages directory.
  • /usr/share/man — global manual pages directory (used by newer UNIX distributions).
  • /usr/share/man — global X11 manual pages directory.
  • /usr/local/share/man — global local manual pages directory.
ok bestie look at those last four real close — the paths are exactly what they are, even the ones that look like twins. don't go "fixing" them, don't go merging them, they're all listed, all real, all staying. 🌸

🌈 ENVIRONMENT VARIABLES 🌈

  • BROWSER — fallback for HELPBROWSER. the understudy. 🎭
  • HELPBROWSER — specifies the command to execute the preferred help browser. the main character browser. 👑
  • HOME — specifies the path to the user's home directory.
  • TMPDIR — specifies the path to the temporary files directory.
  • USER — fallback for USERNAME.
  • USERNAME — specifies the user's name.

✨ EXAMPLES ✨

Wanna run this program the standard way? type:

# manedit &

Wanna run this program and load a manual page at startup? type:

# manedit [manual_page] &

And you can run it as a viewer by specifying the --viewer option, so that it starts up with a viewer instead of an editor window:

# manedit --viewer [manual_page] &

see? three lines, three vibes, all correct. go forth and run them. 🔥

🫶 AUTHORS 🫶

  • Tara Milana — Head programmer. 👑
  • Dan Stimits — Programmer. 💜

👀 SEE ALSO 👀

man(1) manview(1)

and that's the whole page, bestie!! this gem comes to you from WolfPack Entertainment, version 1.2.1, and yes we're saying it one more time at the end because she deserves her flowers. 💐✨ go write some gorgeous manual pages. mwah. 💖🦋🎀

📦 where this page comes from