30

Are there any tools to view man pages in a GUI?

I personally dislike the command line interface. It lacks easy scrolling, searching and so on. Is there any tool with some more intuitive user interface and features?

Preferably for KDE.

11 Answers 11

9

Gman

From the Ubuntu man page, Gman is a "GTK+ based front-end for man, a good replacement for xman."

Gman provides an index of the man pages installed on your local system and offers several options for viewing the man pages. The default option is to have gman open the man pages within an xterm session. This can be modified to suit your taste with four other options.

The other viewing options available are:

  • ghostview
  • Evince
  • LocalBrowse
  • NetBrowse

In order to change the application used for viewing, select View from the menu and then select the radio button next to your preferred application, as shown below:

The last two options require having the man2html package installed on your system and will bring up the man pages in your default browser.

  • 1
    -1 Too simple. No command line options. Fails to load index. And now unsupported, e.g. homex.coolconnect.com/user/xkwang/gman given at bottom of man gman is broken (bad url). – Elliptical view Apr 8 '18 at 21:07
  • I also don't like how it piggy-backs off of gnome terminal – Jonathan Neufeld Jun 11 at 20:29
  • @JonathanNeufeld It doesn't 'piggy-back' off gnome terminal. It runs fine on a system without it installed. – Kevin Bowen Jun 11 at 22:22
  • @Ellipticalview The OP asked for a GUI solution, not cli. Gman is currently available in the 19.04 repos and runs without issue, for me. Personally, I primarily use the cli. shrug – Kevin Bowen Jun 11 at 22:25
  • @KevinBowen my bad, I meant xTerm, but I see now this is configurable from the view menu. – Jonathan Neufeld Jun 13 at 20:30
19

At the command line try examples:

yelp man:printf
yelp 'man:printf(3)'

or use

yelp man:printf & 

to carry on working at the command line. For a more permanent solution try adding

man () { yelp "man:$@"; }

to the last line of your .bashrc file. Then at the command line try examples:

man printf
man printf &

for the yelp viewer to come up. I like having the scroll-able window next to my CLI to alt-tab to.

  • 3
    This solution is great since yelp is the standard help viewer of GNOME, so it might very likely already be installed. – Rörd Apr 2 '15 at 11:32
  • Wow, it also supports the info format! You can get the interactive pages for some commands by typing "info:command" – undercat Dec 14 '17 at 18:56
13

KDE Helpcenter

KDE Menu > Applications > Help > Unix manual pages

enter image description here

Quick launch

By the khelpcenter help

:~$ khelpcenter --help
Usage: khelpcenter [Qt-options] [KDE-options] [url] 

The KDE Help Center

Generic options:
  --help                    Show help about options
  --help-qt                 Show Qt specific options
  --help-kde                Show KDE specific options
  --help-all                Show all options
  --author                  Show author information
  -v, --version             Show version information
  --license                 Show license information
  --                        End of options

Arguments:
  url                       URL to display

Command: khelpcenter man:apt will show the apt man page via the KDE help center.

With the quick launcher /1/ Mangonel:

enter image description here

The Mangonel is available from the Ubuntu repositories: http://packages.ubuntu.com/search?keywords=mangonel&searchon=names&suite=all&section=all

KDE kio-man

KDE Help center > Kioslaves > man

Using the man ioslave you are able to read the man pages installed on your system. It is easy to use...

As with any other KDE ioslave, it is possible to enter a URL, like man:/socket in any KDE application.

With the Konqueror - "man:apt"

enter image description here

Other browsers - The KDE System Settings > File Assosiations > html.

enter image description here

How good or bad the parsing of the kio-man html output is depending the picked browser.

enter image description here

The browser can be launched from the KRunner /1/.

enter image description here

The Kubuntu Forums has a topic: 'Graphical man page viewer' /2/ in the How To's section.

Links

  1. KDE Launchers: http://www.kubuntuforums.net/showthread.php?59851-KDE-Application-Launchers
  2. http://www.kubuntuforums.net/showthread.php?62631-Graphical-man-page-viewer
  • +1 That's certainly better than my answer considering the user's DE. – Kevin Bowen Feb 21 '13 at 9:42
4

In KDE we can search and display Unix manpages from the KDE Help Center or we can open and display the content of any locally stored manpage with Ark.

According to the Debian FHS user program manpages are .gz compressed and stored in /usr/share/man/man1 or /usr/local/share/man/man1, but there are more manpages stored in various subdirectories of /usr/share/man, named after the corresponding application name. This should also include manpages from installed applications not available through the Ubuntu repositories (e.g. installed manually or through a ppa).

In GNOME we may browse to the corresponding /usr/share/man subdirectory to open the manpage with file-roller and gedit.

By performing a custom search on Manpages Ubuntu only manpages of applications available from the official repositories will be found.

To edit manpages also see:

2

If you are willing to use your browser, you can visit The Ubuntu Manpage Repository. Here's a quote from that page:

Welcome to the Ubuntu Manpage Repository This site contains hundreds of thousands of dynamically generated manuals, extracted from every package of every supported version of Ubuntu, and updated on a daily basis. Traditionally, manpages are browsed on the command line. This project renders all such manuals included in Ubuntu into an HTML, web-browsable format.

1

In Kubuntu via Krunner (Alt+F2) type #ls or any other command. Just add a '#' in front.

see also: http://userbase.kde.org/Plasma/Krunner#Issue_.28shell.29_commands

1

I find GTKMan very promising.

Here a screenshot of it in action:

a busy cat

1

I liked Justin Solm's answer in that he added a line to his .bashrc to replace the man command with his gui man of choice, yelp. That is what I wanted, however sometimes I am running w/o X (such as through SSH). I wanted it to automatically fall back to the commandline.

At another post I found answers about how to do that, mostly those were checking the DISPLAY variable. That is good but one answer included a C program called RunningX that actually checked to ensure the DISPLAY variable is actually valid rather than just defined and non-empty. Even better! I recommend going over there and getting it!

Here is what I ended up with:

man () {
    if RunningX
    then
        yelp "man:$@";
    else
        /usr/bin/man "$@";
    fi
}

I'm sure this could be adapted for use with Gman, KDE's help center or whatever man viewer one prefers. It could be adapted for other uses besides manpage browsing as well.

0

So out of all this answer I usually use this way, when I need to refer any manual.

man ls>/tmp/ls.txt && gedit /tmp/ls.txt

instead of gedit use any text editor.

  • if there is any command line expert please shorten this command as I am newbie in terminal :) – Rohith Raveendran Feb 11 '13 at 23:29
  • 1
    See here: askubuntu.com/a/36023/25656 – user25656 Feb 12 '13 at 10:26
  • man ls | gedit - is simpler and avoids the tmp file – Elliptical view Apr 8 '18 at 20:58
0

If you know Emacs -- it has a woman command, where you should type in the page you'd like to read. woman has a top level menu and there you can, in particular, generate a clickable TOC.

0

I'm using this trick that works for man pages well:

man bash |yad --text-info #or |zenity --text-info

(requires yad or zenity, usually exists in your linux distro).

In this way you have GUI interface without the need of any external tool other than yad/zenity which usually exist in your system.
You can scroll with mouse, and most important for me using gtk3.0 version of yad (default today) i can scroll even with my touchscreen.

PS: You need to maximize the yad / zenity window to see all the contents correctly.

As a more permanent solution, i created a tiny script called mang (no extension) under /usr/bin and as soon as i chmod +x mang i was able to call mang (instead of man) from anywhere as simple as `mang cat' .

For those guys who like to play, this is the content of mang script:

#!/bin/bash
# place this file under /usr/bin , and chmod +x this file in order to be able to call it 
if [[ -z $1 ]];then
    echo "You need to provide a manual"
else
    man $1 |yad --text-info --height=500 --width=800 --center --title="Man Pages of $1" --wrap --show-uri &
fi
exit

Tips : --show-uri makes the links inside man pages clickable . Operator & sends the yad window to background , mang is terminated and terminal is free.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.