manpath errors -- standard way to set? does anyone even use it anymore?


 
Thread Tools Search this Thread
Top Forums UNIX for Dummies Questions & Answers manpath errors -- standard way to set? does anyone even use it anymore?
# 1  
Old 02-23-2010
Question manpath errors -- standard way to set? does anyone even use it anymore?

Hello I'm finding a lot of results come up in google about manpath but none of them seem to help. I would like to add some files to my man path so that I can type things like `man -k fluxbox` and even though I don't have fluxbox installed at all, man will find that I have some personal notes on fluxbox. I'd also like to be able to type `man 7 fluxbox` because you can see here that 7 is a section for "miscellanea" (personal documentation).

After putting the following in my ~/.bashrc, I would type `manpath` and it would reveal no sign of my desired path:

Code:
MANPATH=$MANPATH:$HOME/new/path/

So, then I tried:

Code:
export MANPATH=$MANPATH:$HOME/new/path

but now I get the following when typing `manpath`:
Code:
$ manpath
manpath: warning: $MANPATH set, prepending /etc/manpath.config
/usr/local/man:/usr/local/share/man:/usr/share/man:/home/me/public/man:/home/me/public/man

(i don't know why my desired path is repeated twice, but I also don't know whatto do about the warning manpath gave me)

See my directory of documents/pages below; I believe I have it set up correctly -- however, I'm hoping someone can tell me:
  • "no, everything has to be plain text" --OR--
  • "no you can leave those PDF/html files there and man will do its best"

Code:
$pwd
/home/me/

$ ls -a public/man/
.
..
man7

$ ls -a public/man/man7/
.
..
apt-get_cli-tool.html
auto-mount-partition.pdf
bookmark_me
cron_unix-geeks.html
fhs_wikipedia.html
file-system-hierarchy_standard-v2.3.html
file_sysytem_hierarchy
fluxbox_keys.html
intro-to-git.pdf
linux-permissions.html
LowMemorySystems.html
mutt_mail_scripts.html
ports_iana
redirect_std_output-error.html
setup_postfix
unix_haters.pdf
vim_advanced.html
vimrc_sample.html

# 2  
Old 02-23-2010
You need to (re) build the apropos database to get man -k to work properly.

Have you looked at the man page for mandb?

Quote:


mandb is used to initialise or manually update index database caches
that are usually maintained by man. The caches contain information
relevant to the current state of the manual page system and the infor-
mation stored within them is used by the man-db utilities to enhance
their speed and functionality.

When creating or updating an index, mandb will warn of bad ROFF .so
requests, bogus manual page filenames and manual pages from which the
whatis cannot be parsed.

Supplying mandb with an optional colon-delimited path will override the
internal system manual page hierarchy search path, determined from
information found within the man-db configuration file
.
# 3  
Old 02-23-2010
Neo has hit the nail on the head. "man" pages must be presented in a strict text format known only to unix and its predecessors called "nroff" (i.e. not html, pdf, etc.). On the PDP/11 the format was called "runoff".

See "man catman" "man nroff" "man 5 man" etc. etc. . When you read about this, understand it and finally succeed in creating a "man" page which works from "man" and "apropos" or ("man -k") commands that is the ultimate achievement in unix systems administration. I may get comments here.

Once you understand how "man" works you will understand the inner workings of computer typesetting software and of word processors such as Wordstar, Word Perfect, ... and the ultimate copycat M$ Word. I may get comments here too.
 
Login or Register to Ask a Question

Previous Thread | Next Thread

9 More Discussions You Might Find Interesting

1. Red Hat

Cannot set 'soft limits' for 'maximum stack size' for a standard user

Hi Guys, I'm trying to install Oracle Database on to Oracle Linux 7.6 but when the database install package checks the OS set-up, it keeps on failing on the soft limits for the stack. It's default value is 8192 but I'm trying to set it to 10240. This is what I added to... (2 Replies)
Discussion started by: ASGR
2 Replies

2. Slackware

Anyone Using Slackware Anymore?

We used to use Slackware, but then moved all our servers to Ubuntu Linux. Does anyone use Slackware anymore? (8 Replies)
Discussion started by: Neo
8 Replies

3. UNIX for Dummies Questions & Answers

man page in MANPATH not found

dear unix experts, the 'man' command on my system isn't finding a manpage that is in a MANPATH directory, or even when I specify the path directly: 12:56pm ilya@node1390 /idi/sabetilab/ilya/usr/share/man $ man -M . xemacs No manual entry for xemacs 12:56pm ilya@node1390... (4 Replies)
Discussion started by: notestaff
4 Replies

4. Shell Programming and Scripting

MANPATH undefined error

Hello All, I m using Linux OS and the default shell is C shell. Till today the startup file (.login ) was invoking first and the environment variable set there working properly but after some software installation - now the .login file is not invoking at the startup and subsequently the... (1 Reply)
Discussion started by: jambesh
1 Replies

5. Red Hat

Where set manpath?

I know that the manpath varable /etc/man.config: # Every automatically generated MANPATH includes these fields # MANPATH /usr/man MANPATH /usr/share/man MANPATH /usr/local/man MANPATH /usr/local/share/man MANPATH /usr/X11R6/man but run manpath result: # manpath... (0 Replies)
Discussion started by: lazycat79
0 Replies

6. UNIX for Dummies Questions & Answers

Redirect Standard output and standard error into spreadsheet

Hey, I'm completely new at this and I was wondering if there is a way that I would be able to redirect the log files in a directories standard output and standard error into and excel spreadsheet in anyway? Please remember don't use too advanced of terminology as I just started using shell... (6 Replies)
Discussion started by: killaram
6 Replies

7. UNIX for Dummies Questions & Answers

Input of char 's' is not possible anymore

Hello, I have a big problem and no idea how to solve it. I was looking up commands in /bin with 'man' as I found 'sh'. In mistake I started the command. Now after that I can not input the character 's' in shell anymore! Even after restarting system the problem is still there. Mysterious... (7 Replies)
Discussion started by: daWonderer
7 Replies

8. Shell Programming and Scripting

standard error to standard out question

Hi there how can i get the result of a command to not give me its error. For example, on certain systems the 'zfs' command below is not available, but this is fine becaues I am testing against $? so i dont want to see the message " command not found" Ive tried outputting to /dev/null 2>&1 to no... (5 Replies)
Discussion started by: hcclnoodles
5 Replies

9. UNIX for Advanced & Expert Users

How does the PATH and MANPATH environment variable get set?

Hi, How does the PATH and MANPATH environment variable get set? I want to add "/opt/SUNWspro/bin" to the search path for all the users. Where can I access this variable. I know in my home directory, depend on which shell I use, there are files such as .profile and .cshrc which I can edit to... (3 Replies)
Discussion started by: vtran4270
3 Replies
Login or Register to Ask a Question