A plugin for the deskbar applet that searches for MAN pages and displays them in Yelp (the GNOME documentation viewer)
Python
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
INSTALL
README.textile
TODO
deskbar-plugin-gman.py
gpl-3.0.txt

README.textile

ABOUT

deskbar-plugin-gman is a plugin for the deskbar applet. It allows searching of locally stored MAN pages. The selected MAN page is displayed using the GNOME documentation viewer (Yelp).

deskbar-plugin-gman is loosely based on G-MAN (hence the name of the plugin), a “quick n’ dirty” Bash script that accomplishes a similar goal.

DEPENDENCIES

deskbar-plugin-gman assumes that you have installed and are running the GNOME desktop environment, as well as the deskbar-applet itself. It has also been tested with XFCE, with the help of xfapplet (which allows you to load a GNOME applet in the XFCE panel).

There are no build dependencies. To actually run the plugin, you need to have Yelp (basic component of GNOME), as well as the man-db package (fundamental part of most Linux distributions). To use the configuration dialog you need to have python-gtk (should be automatically installed on your system with deskbar-applet itself).

If you are missing any of those two (Yelp and/or man-db), the plugin will refuse to load and will inform you of the problem.

INSTALLATION

Please follow the steps described in the INSTALL file.

USAGE

Provided that you have added the plugin to the list of available handlers in the preferences dialog of the deskbar-applet and you have enabled it, the basic usage is the same as for every other deskbar plugin: you type a query and you get a list of results.

A couple of points that will help you understand and use more efficiently this plugin:

  • The plugin does not display any results for single character queries. It starts searching after you’ve typed the second character (unless a ‘!’ is the first character, in which case the plugin waits until you type the third character. See below for an explanation on ‘!’).
  • When you type something, the plugin tries to match it to the name of a MAN page, starting from its first letter. In other words, if you type “rsyn” (and you have installed the “rsync” application) the plugin will match “rsync” and “rsyncd.conf”, but not “wcursyncup”.
  • If you would like to type “rsyn” and get a match for “wcursyncup” as well, you should add the prefix ‘!’ to your query (eg. “!rsyn”).
  • The plugin limits by default the number of results to 20.
  • You can modify the number of displayed results and the character used to enable full substring searches, by accessing the configuration options of the plugin.
  • The options can be found in deskbar-applet→preferences→G-Man→More. These options are saved between sessions in the configuration file.
  • The plugin configuration file can be found inside your home folder, in .config/deskbar-applet/deskbar-plugin-gman.conf
  • If you modify these values directly on the file (eg. with an editor), you need to reload the plugin (from the deskbar-applet configuration window)
  • If the configuration file is missing, or it is corrupted, it will be recreated with the default values