grepping all manfiles
 

From man(1):So obviously, the manfiles aren't all in a single directory tree. So is there a nice terse command I can use to be able to grep through all manual page files as defined by these settings?

I'll write a script if I have to, but I'd like to avoid it so I can do it on whatever box I'm faced with. My linux/bash skillz are getting better all the time, but they aren't yet good enough to figure this one out.

The manual comes with two commands for identifying pages which contain keywords:
It's not quite like grep, but it might do what you want?

No, I know about apropos, but far too often it returns "nothing appropriate". I like my regular expressions.

Well, I worked on it a bit more. Here's the best I've come up with so far:
it's popping up some error messages about not being able to find the occasional path/name.n.gz which is vexing as in those cases path/name.n already exists. Anyway, can anyone beat that command?

apropos will allow you to search for regular expressions:
Or you can search for shell-style glob wildcards:
If you still want to do it yourself for fun, here's how I would approach it.

1. All the following in a Perl script
2. Parse /etc/manpath.sections - extract SECTIONS and base PATH
3. Make a list of MANDATORY_PATHs
4. Add the list from the MANPATH environment variable if defined
5. Iterate over the list of paths adding sections. This'll give you the list of directories to search
6. Iterate over the list of directories opening files with gunzip if necessary, and extracting the info you want. Be aware the manpage markup is a little weird.

hmm...my apropos has no options...Probably because it dates back from 1991. Well that's interesting.

I only know a little about the manpage markup. I suppose I can send it to man2html and then parse past the tags pretty easily...

You could use nroff -man to process them too. Thing is, parsing thousands of man pages will take quite some time. You'll probably want to build an index and search that with your tool. If you do that, you'll need some sort of index update job. This is a similar approach to updatedb/locate.

aha yes. This helps. I haven't used groff/nroff much yet.

If your system uses catman, you'll have pre-processed versions of some files, which could save you quite a bit of time.