Beefy Boxes and Bandwidth Generously Provided by pair Networks
Perl Monk, Perl Meditation
 
PerlMonks  

Re: docs for CPAN

by jasonk (Parson)
on Feb 09, 2009 at 02:59 UTC ( #742323=note: print w/ replies, xml ) Need Help??


in reply to docs for CPAN

Any ideas what's wrong?

You probably need to add /usr/local/share/man to your $MANPATH environment variable.

can anyone give me a link to a page or pages about the 'man' system?

Did you try 'man man'?


www.jasonkohles.com
We're not surrounded, we're in a target-rich environment!


Comment on Re: docs for CPAN
Re^2: docs for CPAN
by cmac (Monk) on Feb 09, 2009 at 03:14 UTC
    My system doesn't seem to have a $MANPATH environment variable.
    echo $MANPATH
    yields a blank line! Yet many man commands produce output.

    man man doesn't include anything about the file naming conventions for man, nor about formatting codes although the conversion from .pod would hopefully take care of that...

    Anyway thanks for answering,
    cmac

      Check out the command 'manpath' which is used by 'man' to get the paths to search for manpages (at least on linux)

      Usually at the end of every man page is a paragraph 'See also' where you can find the names of other man pages that are thematically linked. In my case I see nroff mentioned (which is the name of the utility and of the language that the man pages use). Also I see man(7) which is another man page of man, just in another section. You can read that by issuing 'man 7 man' (if your version of man is similar to mine)

        All documentation to the contrary, setting $MANPATH in my login file did not solve my problem of 'man' not being able to see the page posted by 'sudo make install'. But the 'man 7 man' output mentioned '/etc/manpath.config'. Adding a line
        MANDATORY_MANPATH /usr/local/share/man/
        to this file did the trick. It made the documentation of all of the Perl modules that I've installed over the years, visible with 'man' as well as with 'perldoc'.

        What Unix/Linux needs is not so much more drivers for trendy new devices, as reform/centralization of its sprawling mess of configuration files and diffuse technical details. Make new jobs by improving Unix/Linux infrastructure! Add this to the stimulus package! :-)

        cmac
Re^2: docs for CPAN
by Bloodnok (Vicar) on Feb 09, 2009 at 17:52 UTC
    ...or run man with the -M option: man -M/usr/local/share/man 3 ABC, man -M/usr/local/share/man -s 3 ABC etc. - whichever options your system man(1) command implements in support of re-directing man(1) to an alternative location...

    A user level that continues to overstate my experience :-))

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://742323]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others chanting in the Monastery: (11)
As of 2014-09-23 09:44 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    How do you remember the number of days in each month?











    Results (216 votes), past polls