Prima::HelpViewer(3)

💖 NAME 💖

This is Prima::HelpViewer(3), bestie — coming at you from the User Contributed Perl Documentation crew. It's the manual for Prima::HelpViewer, aka the built-in POD browser. Iconic. 🫶

---

🌈 USAGE 🌈

Okay so the module presents two packages, Prima::HelpViewer and Prima::PodViewWindow. Their whole purpose? Be the mediator between the Prima::PodView package, the toolkit help interface, and the user. Slay.

Prima::PodViewWindow includes all the user functionality needed — text search, color and font setup, printing, etc. It's giving full-feature energy. ✨

Prima::HelpViewer provides two methods — open and close — used by Prima::Application for invocation of the help viewer. Periodt. 👑

The browser can be used to view and print POD ( plain old documentation ) files. See the command overview below for a more detailed description. 💅

---

🌸 Help 🌸

Here's the full menu tour, bestie — every command, no skips, no cap. 💖

🗂️ File

• Open — Presents a file selection dialog, when the user can select a file to browse. The file must contain POD content, otherwise, a warning is displayed.
• Goto — Asks for a manpage, that is searched in PATH and the perl installation directories.
• New window — Opens the new viewer window with the same context.
• Run Commands in this group call external processes
  • prima-class — prima-class is the utility for displaying the widget class hierarchies. The command asks for the Prima class to display the hierarchy information.
• Print — Provides a dialog where the user can select the appropriate printer device and its options. Prints the current topic to the selected printer. If Full text view menu item is checked, prints the whole manpage.
• Close window — Closes the window.
• Close all windows — Closes all help viewer windows.

👀 View

• Increase font — Increases the currently selected font by 2 points.
• Decrease font — Decreases the currently selected font by 2 points.
• Full text view — If checked, the whole manpage is displayed. Otherwise, its content is presented as a set of topics, and only a single topic is displayed.
• Find — Presents a text find dialog where the user can type the text to search, and select the search options — the search direction, scope, etc.
• Find again — Starts search for the text, entered in the last text find dialog, with the same search options.
• Fast find — The following commands provide a simple vi-style text search functionality — character keys ?, /, n, N bound to the commands below:
  • Forward — Presents an input line where a text can be entered; the text search is performed parallel to the input.
  • Backward — Same as the Forward option, except that the search direction is backward.
  • Repeat forward — Repeats the search in the same direction as the initial search
  • Repeat backward — Repeat the search in the reverse direction from the initial search
• Setup — Presents a setup dialog where the user can select appropriate fonts and colors.

🧭 Go

• Back — Displays the previously visited manpage or topic
• Forward — Displays the previously visited manpage or topic that was left via the Back command.
• Up — Displays the upper-level topic within the manpage
• Previous — Moves to the previous topic within the manpage
• Next — Moves to the next topic within the manpage

🆘 Help

• About — Displays the information about the help viewer.
• Help — Displays the information about the usage of the help viewer

---

✍️ AUTHOR ✍️

The author is Dmitry Karasik, <dmitry@karasik.eu.org>. 🫶

---

🎀 COPYRIGHT 🎀

This program is distributed under the BSD License. 🌈

---

Mwah 💋 — this page comes from perl v5.42.0, dated 2024-08-20, and it's Prima::HelpViewer(3). Bye bestie! 🫶✨