ManOpen v2.6 by Carl Lindberg February 2012
Please send any comments, suggestions or bug reports to
lindberg@clindberg.org.
This program is provided ``AS IS'' and without any warranty.
ManOpen is a graphical interface for viewing Unix manual pages,
which are the standard documentation for Unix command line programs,
programmer libraries, and other system information. It can open files
directly or be given titles, in which case it will display the output
from the "man" command-line program. An apropos interface is also
provided, which is basically a quick-and-dirty search of the man page
databases. Services are provided to other applications to open selected
files/titles or do apropos searches using the selected text.
Version 2.6 changes:
- Requires MacOS X 10.4; works on 10.7
- Updated to use more current MacOS interface
- Added a "Copy URL" function to copy the current page URL
to the clipboard (suggested by Quinn)
- Handle versions of groff/grotty which use ANSI escape sequences
(reported by Kim Holburn)
- Preference on Lion to disable saving of open windows upon quit
ManOpen can be useful for opening a man page without dropping
down to the command line, browsing and searching through long and
complex man pages, or simply for printing them out.
Also included is an "openman" command line tool, which is similar
to "man" except it will display the man pages in ManOpen.app instead
of directly to the terminal.
ManOpen should run on MacOS X 10.4 and higher. Source code is
available. To install the app, put ManOpen.app in one of the standard
Application directories, such as /Network/Applications, /Applications
or ~/Applications. You may have to log out and back to have the
services work.
To install the "openman" tool, put it in one of the directories in
the Unix $PATH, such as /usr/local/bin. Put its "openman.1" man page
in a standard man page directory, such as /usr/local/man/man1.
[Note that /usr/local/bin may not be part of the default PATH.
Adding "set path = (/usr/local/bin $path)" to your
~/.cshrc file is one way to set it back, for tcsh users.]
For those who remember, there was a ManOpen 1.0 application
by Harald Schlangmann that ran on NEXTSTEP computers. This is a much
updated version that adds many features. Thanks are due to
Mr. Schlangmann for the inspiration, and his internal cat2rtf tool
which is also used in this version.
Hope you find this useful,
-Carl Lindberg
lindberg@clindberg.org
lindberg@mac.com
* Copyright (c) 2000-2012 Carl Lindberg
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS''
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.