| All Forums |
Register |
Login |
Search |
Subscriptions |
My Profile |
Inbox |
| Tool Warehouse |
FAQs |
Resources |
Help |
Member List |
Address Book |
Logout |
|
|
GNU man: no entry for anything
|
Logged in as: Guest |
| Users viewing this topic: none |
|
Login  |
|
|
 GNU man: no entry for anything - Apr. 11, '06, 4:31:56 PM
|
|
|
woehlkmp
Posts: 102
Status: offline
|
Has anyone been able to build GNU's 'man' on SFU... and get it to work? It builds fine, but always states 'No manual entry for <topic>'. I did note that 'man /usr/share/cat1/man.1' works almost as expected (there are a few minor formatting issues, but nothing significantly detrimental); this is good as it means GNU's 'man' won't break my ability to read Microsoft's man pages... but I do want it so I can read my GNU man pages! (The shipped 'man' doesn't know how to format them on the fly  .) Am I stuck needing to pre-format all of my GNU man pages?
[EDIT] Correction: it is not a GNU package, although it is the GPL version. Also, the problem seems to be in glob.c; glob_filename fails to find files. [/EDIT]
[EDIT] ...And before someone tells me to use the one from here, I tried it and it doesn't know how to format GNU man pages. [/EDIT]
Given how obviously severe this problem is, I can't imagine that it is not specific to Interix...
Some further information:
$ type man
man is hashed (/usr/gnu/bin/man)
$ echo $MANPATH
/usr/gnu/man:/usr/share/man:/usr/X11R6/man:/usr/X11R5/man
$ ls /usr/gnu/man/man1
addftinfo.1 bzdiff.1 cp.1 gawk.1 grops.1 lookbib.1 pdfroff.1 soelim.1 xxd.1
afmtodit.1 bzegrep.1 dd.1 gdiffmk.1 grotty.1 ls.1 pfbtops.1 sync.1 zcat.1
apropos.1 bzfgrep.1 df.1 grap2graph.1 gunzip.1 make.1 pgawk.1 tbl.1 zcmp.1
autoconf.1 bzgrep.1 dir.1 grep.1 gzexe.1 man.1 pic.1 tfmtodit.1 zdiff.1
autoheader.1 bzip2.1 dircolors.1 grn.1 gzip.1 man2html.1 pic2graph.1 touch.1 zforce.1
autom4te.1 bzless.1 du.1 grodvi.1 hpftodit.1 mkdir.1 refer.1 troff.1 zgrep.1
autoreconf.1 bzmore.1 egrep.1 groff.1 ifnames.1 mkfifo.1 rm.1 vdir.1 zmore.1
autoscan.1 chgrp.1 eqn.1 groffer.1 igawk.1 mknod.1 rmdir.1 view.1 znew.1
autoupdate.1 chmod.1 eqn2graph.1 grog.1 indxbib.1 mmroff.1 rview.1 vim.1
bash.1 chown.1 evim.1 grohtml.1 install.1 mv.1 rvim.1 vimdiff.1
bashbug.1 config.guess.1 ex.1 grolbp.1 lkbib.1 neqn.1 sed.1 vimtutor.1
bzcmp.1 config.sub.1 fgrep.1 grolj4.1 ln.1 nroff.1 shred.1 whatis.1
$ man -d man
Reading config file /usr/gnu/lib/man.conf
Looked whether there exists a message catalog man, but there is none
(and for English messages none is needed)
found man directory /usr/gnu/man
found man directory /usr/man
found man directory /usr/share/man
found man directory /usr/local/man
found man directory /usr/local/share/man
found man directory /usr/X11R6/man
found manpath map /bin --> /usr/share/man
found manpath map /sbin --> /usr/share/man
found manpath map /usr/bin --> /usr/share/man
found manpath map /usr/sbin --> /usr/share/man
found manpath map /usr/local/bin --> /usr/local/share/man
found manpath map /usr/local/sbin --> /usr/local/share/man
found manpath map /usr/X11R6/bin --> /usr/X11R6/man
found manpath map /usr/bin/X11 --> /usr/X11R6/man
found manpath map /usr/bin/mh --> /usr/share/man
using /bin/less -is as pager
using /bin/less -is as browser
using /bin/cat to dump HTML pages as text
adding /usr/gnu/man to manpath
adding /usr/share/man to manpath
adding /usr/X11R6/man to manpath
adding /usr/X11R5/man to manpath
No manual entry for man
< Message edited by woehlkmp -- Apr. 11, '06, 5:36:44 PM >
|
|
|
|
|
RE: GNU man: no entry for anything - Apr. 11, '06, 7:35:46 PM
|
|
|
Rodney
Posts: 3728
Joined: Jul. 9, '02,
From: /Tools lab
Status: offline
|
> ... I tried it and it doesn't know how to format GNU man pages.
This would be really unlikely because groff is the underlying program
used by man when formating the pages "on the fly".
The 'man' format is a standard markup.
What problem is it that you are having?
|
|
|
|
|
RE: GNU man: no entry for anything - Apr. 12, '06, 11:39:15 AM
|
|
|
woehlkmp
Posts: 102
Status: offline
|
Hi, Rodney,
I should clarify "doesn't know how to format"... specifically, I determined that etc/man.conf is wildly broken; all lines for _build need to be changed from '<path>/tbl %s | <path>/nroff -man' to 'groff -Tascii -pet -mandoc -P-c %s' (and why are tbl and nroff specifically path'd, anyway?). Otherwise I get something only marginally more readable than the raw markup.
I'm also disappointed with this version in several ways:
- It does not build and save cat pages.
- It does not pipe, which leads to the pager ('less -irs') displaying a temporary file name.
- Its handling for gzip'd pages seems poor. It can handle them given enough rules in man.conf, but apparently cannot combine rules (may relate to [1]).
Maybe some time I'll feel like fixing glob_filename in man-1.6c.
|
|
|
|
|
RE: GNU man: no entry for anything - Apr. 12, '06, 2:06:42 PM
|
|
|
Rodney
Posts: 3728
Joined: Jul. 9, '02,
From: /Tools lab
Status: offline
|
The "_build" part is a pretty traditional specification.
The first goal was to match traditional behavior on Unix systems.
Generating the temporary manual pages when no "cat" version exists is common.
For more permanent generation the catman utility has been available
for a number of years -- it works at things in bulk and finds files needed
to be generated/updated automagically.
Tbl is for the table pre-processing of a file. There are still files
using the table markup. Specific paths must be specified because the user
environment variable PATH cannot be guaranteed to be set with these paths.
"wildly broken" you still haven't explained. The specifications work.
They are nearly the same as on the BSD systems. Broken means doesn't work.
Saving to a temporary file is efficient. Particularly when the man page
is large; pipes are not that large. The pager would have to do something
similar and we don't guarantee what pager the user has chosen (yes, there
is a default, but the user can choose any he/she wants).
|
|
|
|
|
RE: GNU man: no entry for anything - Apr. 12, '06, 2:22:14 PM
|
|
|
woehlkmp
Posts: 102
Status: offline
|
No, the specifications provided in the packages as it is today do not work. I need a 'man' that will display the man pages from the (rather sizable) set of GNU utilities I built. To achieve that, my nroff command must be 'groff -mandoc[j] [-pet] -P-c -T<type>' (for the record, '-t' invokes tbl as a preprocessor).
Illustration:
GAWK(1) Utility Commands GAWK(1)
ESC[1mNAMEESC[0m
gawk - pattern scanning and processing language
ESC[1mSYNOPSISESC[0m
ESC[1mgawk ESC[22m[ POSIX or GNU style options ] ESC[1m-f ESC[4mESC[22mprogram-fileESC[24m [ ESC[1m-- ESC[22m] fi
le ...
ESC[1mgawk ESC[22m[ POSIX or GNU style options ] [ ESC[1m-- ESC[22m] ESC[4mprogram-textESC[24m file ...
ESC[1mpgawk ESC[22m[ POSIX or GNU style options ] ESC[1m-f ESC[4mESC[22mprogram-fileESC[24m [ ESC[1m-- ESC[22m] f
ile ...
ESC[1mpgawk ESC[22m[ POSIX or GNU style options ] [ ESC[1m-- ESC[22m] ESC[4mprogram-textESC[24m file ...
...and so forth. I'm not sure what your definition of "broken" is, but that sure fits mine.
With man-1.6c reconfigure as per my previous post (the only critical change is adding '-P-c'), I can view my GNU man pages, even after I bzip2'd the originals  ! Unfortunately, I can only view the SFU-native cat pages if my tty is 80-columns (another wonderful decision on Microsoft's part, although man should probably favor a mis-formatted cat page over nothing).
|
|
|
|
|
RE: GNU man: no entry for anything - Apr. 12, '06, 3:02:45 PM
|
|
|
Rodney
Posts: 3728
Joined: Jul. 9, '02,
From: /Tools lab
Status: offline
|
> ESC[1mNAMEESC[0m
Okay, now I can see what it is that you see.
But this isn't what I see when running the gawk raw man page
through the /Tools man.
This indicates something else is set wrong in your environment such
as TERM, MANPAGER or PAGER. The terminal escape codes are being displayed
when they should be getting interpreted by the terminal for formating.
So do you have MANPAGER or PAGER set to something?
What is TERM and what terminal type are you on?
|
|
|
|
|
RE: GNU man: no entry for anything - Apr. 12, '06, 3:49:43 PM
|
|
|
woehlkmp
Posts: 102
Status: offline
|
TERM=interix
MANPAGER is unset
PAGER is unset
I'm in a console windows on the CRT; nothing remote going on here (unfortunately ).
Hmm, another advantage of man-1.6c... I can '-d' it and see what it's trying to do. Can't do that with the /tools version.
Anyway, checking in its man.conf, I don't see it specifying a pager anywhere, so maybe it's being "dumb" and using 'less' without args? However, without '-P-c' I had the same problem with man-1.6c, which is using 'less -is'.
However... this is all academic. 'less -irs' still doesn't work, as it is not translating '^[[22m' as cancelling the previous '^[[1m', which therefore still results in incorrect display. 'groff <options> -P-c' is the only solution I've found. The reason it doesn't work is because the correct formatting method is that described by 'less -U'. This can be verified both by redirecting the output of 'man <something>' to a file, or by directly editing one of the SFU-provided cat files. The '^[[...m' syntax is wrong; it is meant to be used as markup for a FURTHER preprocessing step that is being ommitted.
|
|
|
|
|
RE: GNU man: no entry for anything - Apr. 12, '06, 4:08:51 PM
|
|
|
Rodney
Posts: 3728
Joined: Jul. 9, '02,
From: /Tools lab
Status: offline
|
It uses more with '-s' as the default. Args shouldn't be needed since it's
a curses application and TERM should be enough. The MANPAGER and PAGER can set it to
something else.
The "<ESC>[[m" stuff is the terminal escape sequences.
From the quote you provided, the sequences are correct for turning bold on/off.
These are markups.
Have you replaced more on your system?
|
|
|
|
|
RE: GNU man: no entry for anything - Apr. 12, '06, 5:24:06 PM
|
|
|
woehlkmp
Posts: 102
Status: offline
|
> Have you replaced more on your system?
Nope...
$ type more
more is /bin/more
|
|
|
|
 New Messages |
 No New Messages |
 Hot Topic w/ New Messages |
 Hot Topic w/o New Messages |
|
 Locked w/ New Messages |
 Locked w/o New Messages |
|
 Post New Thread
Reply to Message
Post New Poll
Submit Vote
Delete My Own Post
Delete My Own Thread
Rate Posts |
|
|
|
Printable Version
.