Bwana is a manual page viewer for your Browser. It parses man pages in real time to provide the most up to date pages in an easy to read format. The pages have links to other man pages, http and email references--the way man pages should have been from the start.
DRDUL Excellent app! The best way I've found to view man pages. I'm slowly learning UNIX, and having Bwana available to quickly pop up a man page is great. Even better is that Bwana provides hyperlinks to other man pages ('cuz I often start out with the wrong command and need to find the correct one). (Version 2.4)
BRUJI To add man paths to your system include them in man configuration file located in /usr/share/misc/man.conf. The format for including another path is a new line with: MANPATH /usr/share/mynewpath. To open a temporary page in a path you don't want to include as part of your man configuration then pass the entire path to Bwana with man:/Users/myuser/Desktop/mansource.1 or man:///Users/myuser/Desktop/mansource.1 (Version 2.1)
8BIT-WINTERMUTE This is a great program but it seems not to be using MANPATH because I can't make it find any of the Darwinports / fink installed manual pages.
This really limits the usefulness for me (Version 2.1)
GREG RAVEN The new version is even better than the previous, and as you can see below, I really liked the previous version. The two main improvements as far as I'm concerned are the addition af a search box on each results page, and the link to the "index" page. Fabulous stuff! (Version 2.0)
GREG RAVEN I've seen several other ways of reading man pages that don't involve going to Terminal.app, but Bwana is far and away the best method. I virtually always have Safari open, so man pages are seldom more than a click away. Bwana formats the man pages very nicely, and adds links to other man pages. As nice as Bwana is, it's a shame that most man pages are so poorly written. Bwana deserves better! (Version 1.9)
BRUJI If you want to use Bwana with OmniWeb, add the following lines to the scripts.strings file. (You can access the file by ctlr-clicking the Bwana icon and then navigate to Show package contents/Contents/Resources/scripts.strings) These are the lines you need to include in the script:
OmniWeb
tell application "OmniWeb"
GetURL "file://%@"
end tell
(Code comes courtesty of Bwana user Tim M.)
After that save the file and you'll be good to go. (Version 1.9)
0
May 5 2005
FUNNELLPD Simple and easy, no-hassle install. And you can't beat free. (Version 1.6)
KEVIN BALLARD I think Bwana is really neat, but I think it would be even better if it was done as an internet plugin. That way it would work in all browsers that support internet plugins, it would work transparently in browsers (i.e. no more URL bar going blank, then sitting and waiting and it magically changing to a temporary HTML file). (Version 1.4)
CONOR It looks into all the directories. If a directory is empty it won't list it. So probably at those locations man2, man3..etc are empty directories or don't exist at all. if you do have source files in there let me know I will give it a closer look. Don't have a "man:bwana" I guess I should put one in, but the application is so light and simple at 100k, it hasn't achieved easter egg status yet. :) (Version 1.3)
0
Jan 23 2005
ALEX KADIS man://whatever seems to work (of course replacing whatever with what you are looking up.) and if you us it with Sogudi you can use it like you would in the terminal:
man whatever (Version 1.5)
0
Nov 11 2004
THE_WEBMAESTRO I like it a lot! It was so easy to set up. Drag it to your hard drive (mine's in /Applications/Utilities like they suggested) and you're done!
A couple of things I'd like to see:
- (IMO) the URL should still say 'man:diff' instead of the PATH to the man file (although this could be configurable and/or the PATH could display at the top of the man'd page.
- the URL in the readme file has a ';' instead of a ':' (http;//www.bruji.com/)
- the bruji.com has no entry for Bwana--just their bread & butter products (I like the name now that I understand it!) (Version 1.2)
CONOR If anybody knows how to tell Safari to load a file but keep the URL different, please let me know. So I can leave the URL "man:diff". If you know how to do it in Javascript that will work as well. Frames are not an elegant solution, so I don't want that. (Version 1.3)