search

zopencommunity / man-dbport

Tool for generating manual pages for Unix programs
Apache License 2.0
0 stars 2 forks source link

Validate messages from mandb #33

Open gngrossi opened 1 year ago

gngrossi commented 1 year ago

mandb_output.txt mandb_output2.txt

gngrossi commented 1 year ago

mandb_output4.txt

gngrossi commented 1 year ago

After running mandb . there is an index.db file created. Ok to remove or keep?

-rw-r--r-- 1 @02858 @ISCICS1 3088 Jun 1 10:42 index.db

gngrossi commented 1 year ago

appears "man" is no longer working...

RC=(0) [SYSA] bash-5.2$ man iconv man: command exited with status 127: (cd /hewitt/zopentools/guild/libiconv-master/share/man && /u/jenkins/zopen/prod/man-db-2.11.2/libexec/man-db/zsoelim) | (cd /hewitt/zopentools/guild/libiconv-master/share/man && /u/jenkins/zopen/prod/man-db-2.11.2/libexec/man-db/manconv -f UTF-8:ISO-8859-1 -t UTF-8//IGNORE) | (cd /hewitt/zopentools/guild/libiconv-master/share/man && preconv -e UTF-8) | (cd /hewitt/zopentools/guild/libiconv-master/share/man && tbl) | (cd /hewitt/zopentools/guild/libiconv-master/share/man && nroff -mg -msafe -mpadj -mandoc -rLL=175n -rLT=175n -Tlocale) | (cd /hewitt/zopentools/guild/libiconv-master/share/man && col)

gngrossi commented 1 year ago

/hewitt/zopentools/guild/man-db-2.11.2/bin/man RC=(0) [SYSA] bash-5.2$ man builtins No manual entry for builtins No manual entry for builtins

MikeFultonDev commented 1 year ago

investigating

MikeFultonDev commented 1 year ago

@gngrossi - unfortunately - 'works for me'... I am wondering if perhaps something is out of sync on your system.

When you issue:

man --version

what do you get? It should be man 2.11.2. If it's 2.10.2, then you might have some symbolic links messed up (I did). If so, manually delete man-db-2.11.2 directory and ensure that the symbolic link for man-db points to man-db-2.11.2 by doing:

rm man-db
ln -s man-db-2.11.2 man-db

from your /hewitt/zopentools/guild directory

If that all looks good, please confirm you have the latest libpipeline by doing a 

zopen upgrade libpipeline

from your /hewitt/zopentools/guild directory.

MikeFultonDev commented 1 year ago

@gngrossi ignore my last comment. It does appear that man-db-2.11.2 is busted. If you have an older version (2.10.2) that should work. I'll figure out what I did 😩 The zopen-setup that sets up 'boot' should have a working man-db since it's a bit older. Apologies

gngrossi commented 1 year ago

bash-5.2$ man --version man 2.11.2 bash-5.2$ mandb --version mandb 2.11.2

bash-5.2$ man builtins No manual entry for builtins No manual entry for builtins

bash-5.2$ whatis iconv iconv (1) - character set conversion iconv (3) - perform character set conversion

the man output looks good

RC=(0) [SYSA] bash-5.2$ man 1 iconv RC=(0) [SYSA] bash-5.2$ man 3 iconv

gngrossi commented 1 year ago

When is it recommended to run a mandb . command? thanks

MikeFultonDev commented 1 year ago

still investigating, but i deleted the bad builds on github, so if you a) delete all your man* files and then issue a new zopen install man-db you should be back in business.

MikeFultonDev commented 1 year ago

When is it recommended to run a mandb . command? thanks

For now - when you install a new package you can run it if you want the improved indexing. We need to incorporate this into the 'install' process (I'll open an issue for that) so that we can make it automatic. Issue: https://github.com/ZOSOpenTools/meta/issues/339 opened

gngrossi commented 1 year ago

For now, I am required to install the pax files. I remove and re-install for each new build. Attaching the output from the mandb . command.

this looks good

bash-5.2$ man builtins No manual entry for builtins

bash-5.2$ whatis iconv iconv (1) - character set conversion iconv (3) - perform character set conversion

bash-5.2$ man 1 iconv bash-5.2$ man 3 iconv

mandb_output_6-21-2023.txt

gngrossi commented 1 year ago

mandb output mandb_output_6-22-2023.txt

gngrossi commented 1 year ago

bash-5.2$ man --version man 2.10.2 bash-5.2$ mandb --version mandb 2.10.2

bash-5.2$ type whatis whatis is hashed (/hewitt/zopentools/guild/man-db-2.10.2/bin/whatis) bash-5.2$ type apropos apropos is hashed (/hewitt/zopentools/guild/man-db-2.10.2/bin/apropos)

bash-5.2$ apropos iconv iconv: nothing appropriate. bash-5.2$ whatis iconv iconv: nothing appropriate.

gngrossi commented 1 year ago

mandb output mandb_output_6-23-2023.txt

gngrossi commented 1 year ago

RC=(0) [SYSA] bash-5.2$ whatis iconv iconv: nothing appropriate.

RC=(0) [SYSA] bash-5.2$ man builtins No manual entry for builtins No manual entry for builtins mandb_output_6-27-2023.txt

MikeFultonDev commented 1 year ago

I get what you get. I did find a work-around. If you specify just mandb, e.g.

mandb

then it seems to properly update all the pages. I expect there is a compiled-in path to jenkins here now that is causing problems.

Please tell me if this doesn't help. Here is what I got:

mandb
mandb: warning: $MANPATH set, ignoring /u/jenkins/zopen/prod/man-db-2.11.2/etc/man_db.conf
mandb: warning: no MANDB_MAP directives in /u/jenkins/zopen/prod/man-db-2.11.2/etc/man_db.conf, using your manpath
Processing manual pages under /home/fultonm/zopen/prod/ncurses/share/man...
Updating index cache for path `/home/fultonm/zopen/prod/ncurses/share/man/man7'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/prod/ncurses/share/man...
Processing manual pages under /home/fultonm/zopen/prod/ncurses/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/prod/ncurses/share/man/cat3...
Processing manual pages under /home/fultonm/zopen/prod/ncurses/share/man/cat5...
Processing manual pages under /home/fultonm/zopen/prod/ncurses/share/man/cat7...
Processing manual pages under /home/fultonm/zopen/prod/libiconv/share/man...
Updating index cache for path `/home/fultonm/zopen/prod/libiconv/share/man/man3'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/prod/libiconv/share/man...
Processing manual pages under /home/fultonm/zopen/prod/libiconv/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/prod/libiconv/share/man/cat3...
Processing manual pages under /home/fultonm/zopen/prod/less/share/man...
Updating index cache for path `/home/fultonm/zopen/prod/less/share/man/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/prod/less/share/man...
Processing manual pages under /home/fultonm/zopen/prod/less/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/prod/groff/share/man...
Updating index cache for path `/home/fultonm/zopen/prod/groff/share/man/man7'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/prod/groff/share/man...
Processing manual pages under /home/fultonm/zopen/prod/groff/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/prod/groff/share/man/cat5...
Processing manual pages under /home/fultonm/zopen/prod/groff/share/man/cat7...
Processing manual pages under /home/fultonm/zopen/prod/man-db/share/man...
Updating index cache for path `/home/fultonm/zopen/prod/man-db/share/man/man8'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/prod/man-db/share/man...
Processing manual pages under /home/fultonm/zopen/prod/man-db/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/prod/man-db/share/man/cat5...
Processing manual pages under /home/fultonm/zopen/prod/man-db/share/man/cat8...
Processing manual pages under /home/fultonm/zopen/boot/libiconv/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/libiconv/share/man/man3'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/libiconv/share/man...
Processing manual pages under /home/fultonm/zopen/boot/libiconv/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/libiconv/share/man/cat3...
Processing manual pages under /home/fultonm/zopen/boot/groff/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/groff/share/man/man7'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/groff/share/man...
Processing manual pages under /home/fultonm/zopen/boot/groff/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/groff/share/man/cat5...
Processing manual pages under /home/fultonm/zopen/boot/groff/share/man/cat7...
Processing manual pages under /home/fultonm/zopen/boot/man-db/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/man-db/share/man/man8'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/man-db/share/man...
Processing manual pages under /home/fultonm/zopen/boot/man-db/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/man-db/share/man/cat5...
Processing manual pages under /home/fultonm/zopen/boot/man-db/share/man/cat8...
Processing manual pages under /home/fultonm/zopen/boot/gawk/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/gawk/share/man/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/gawk/share/man...
Processing manual pages under /home/fultonm/zopen/boot/gawk/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/grep/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/grep/share/man/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/grep/share/man...
Processing manual pages under /home/fultonm/zopen/boot/grep/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/sed/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/sed/share/man/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/sed/share/man...
Processing manual pages under /home/fultonm/zopen/boot/sed/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/ncurses/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/ncurses/share/man/man7'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/ncurses/share/man...
Processing manual pages under /home/fultonm/zopen/boot/ncurses/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/ncurses/share/man/cat3...
Processing manual pages under /home/fultonm/zopen/boot/ncurses/share/man/cat5...
Processing manual pages under /home/fultonm/zopen/boot/ncurses/share/man/cat7...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/da...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/da/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/da...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/da.ISO8859-1...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/da.ISO8859-1/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/da.ISO8859-1...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/da.UTF-8...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/da.UTF-8/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/da.UTF-8...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/de...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/de/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/de...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/de.ISO8859-1...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/de.ISO8859-1/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/de.ISO8859-1...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/de.UTF-8...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/de.UTF-8/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/de.UTF-8...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/fr...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/fr/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/fr...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/fr.ISO8859-1...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/fr.ISO8859-1/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/fr.ISO8859-1...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/fr.UTF-8...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/fr.UTF-8/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/fr.UTF-8...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/it...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/it/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/it...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/it.ISO8859-1...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/it.ISO8859-1/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/it.ISO8859-1...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/it.UTF-8...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/it.UTF-8/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/it.UTF-8...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/ja...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/ja/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/ja...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/pl...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/pl/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/pl...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/pl.ISO8859-2...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/pl.ISO8859-2/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/pl.ISO8859-2...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/pl.UTF-8...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/pl.UTF-8/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/pl.UTF-8...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/ru.KOI8-R...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/ru.KOI8-R/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/ru.KOI8-R...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/ru.UTF-8...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/ru.UTF-8/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/ru.UTF-8...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/tr...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/tr/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/tr...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/tr.ISO8859-9...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/tr.ISO8859-9/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/tr.ISO8859-9...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/tr.UTF-8...
Updating index cache for path `/home/fultonm/zopen/boot/vim/share/man/tr.UTF-8/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/vim/share/man/tr.UTF-8...
Processing manual pages under /home/fultonm/zopen/boot/vim/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/xz/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/xz/share/man/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/xz/share/man...
Processing manual pages under /home/fultonm/zopen/boot/xz/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/gzip/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/gzip/share/man/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/gzip/share/man...
Processing manual pages under /home/fultonm/zopen/boot/gzip/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/tar/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/tar/share/man/man8'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/tar/share/man...
Processing manual pages under /home/fultonm/zopen/boot/tar/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/tar/share/man/cat8...
Processing manual pages under /home/fultonm/zopen/boot/coreutils/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/coreutils/share/man/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/coreutils/share/man...
Processing manual pages under /home/fultonm/zopen/boot/coreutils/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/findutils/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/findutils/share/man/man5'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/findutils/share/man...
Processing manual pages under /home/fultonm/zopen/boot/findutils/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/findutils/share/man/cat5...
Processing manual pages under /home/fultonm/zopen/boot/diffutils/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/diffutils/share/man/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/diffutils/share/man...
Processing manual pages under /home/fultonm/zopen/boot/diffutils/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/bash/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/bash/share/man/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/bash/share/man...
Processing manual pages under /home/fultonm/zopen/boot/bash/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/jq/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/jq/share/man/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/jq/share/man...
Processing manual pages under /home/fultonm/zopen/boot/jq/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/less/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/less/share/man/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/less/share/man...
Processing manual pages under /home/fultonm/zopen/boot/less/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/git/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/git/share/man/man7'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/git/share/man...
Processing manual pages under /home/fultonm/zopen/boot/git/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/git/share/man/cat5...
Processing manual pages under /home/fultonm/zopen/boot/git/share/man/cat7...
Processing manual pages under /home/fultonm/zopen/boot/make/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/make/share/man/man1'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/make/share/man...
Processing manual pages under /home/fultonm/zopen/boot/make/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/curl/share/man...
Updating index cache for path `/home/fultonm/zopen/boot/curl/share/man/man3'. Wait...done.
Checking for stray cats under /home/fultonm/zopen/boot/curl/share/man...
Processing manual pages under /home/fultonm/zopen/boot/curl/share/man/cat1...
Processing manual pages under /home/fultonm/zopen/boot/curl/share/man/cat3...
67 man subdirectories contained newer manual pages.
2978 manual pages were added.
0 stray cats were added.
0 old database entries were purged.
FULTONM@ZOSCAN2B bash ~/zopen/prod> whatis man
man (1)              - an interface to the system reference manuals
FULTONM@ZOSCAN2B bash ~/zopen/prod> whatis iconv
iconv (1)            - character set conversion
iconv (3)            - perform character set conversion
gngrossi commented 1 year ago

Running mandb for the update looks good.

mandb_output_6-28-2023.txt

RC=(0) [SYSA] bash-5.2$ whatis iconv iconv (1) - character set conversion iconv (3) - perform character set conversion

RC=(0) [SYSA] bash-5.2$ apropos iconv iconv (1) - character set conversion iconv (3) - perform character set conversion iconv_close (3) - deallocate descriptor for character set conversion iconv_open (3) - allocate descriptor for character set conversion iconv_open_into (3) - initialize descriptor for character set conversion iconvctl (3) - control iconv behavior

gngrossi commented 1 year ago

Messages from running the mandb command. mandb_output_6-29-2023.txt

These man pages aren't in /hewitt/zopentools/guild Should they be accessed?

Purging old database entries in /hewitt/coz/current/doc/man... Processing manual pages under /hewitt/coz/current/doc/man... Checking for stray cats under /hewitt/coz/current/doc/man... Processing manual pages under /hewitt/coz/current/doc/man/cat1... Processing manual pages under /hewitt/coz/current/doc/man/cat5... Processing manual pages under /usr/lpp/ported/man/C... mandb: warning: cannot create catdir /usr/lpp/ported/man/C/cat1 Removing obsolete cat directory /hewitt/coz/current/doc/man/cat1/catsearch.1...

gngrossi commented 1 year ago

My MANPATH contains paths that "mandb" likely should ignore. This output is showing paths before sourcing the zopen tools. Thoughts? thanks

$ echo $MANPATH /usr/man/%L:/hewitt/coz/current/doc/man:/usr/lpp/ported/man/C

gngrossi commented 1 year ago

bash-5.2$ man --version man 2.11.2 bash-5.2$ mandb --version mandb 2.11.2

is this expected?

bash-5.2$ man builtins No manual entry for builtins No manual entry for builtins

running mandb...should man pages outside of zopen tools be processed?

Purging old database entries in /hewitt/coz/current/doc/man... Processing manual pages under /hewitt/coz/current/doc/man... Checking for stray cats under /hewitt/coz/current/doc/man... Processing manual pages under /hewitt/coz/current/doc/man/cat1... Processing manual pages under /hewitt/coz/current/doc/man/cat5... Processing manual pages under /usr/lpp/ported/man/C... mandb: warning: cannot create catdir /usr/lpp/ported/man/C/cat1 Removing obsolete cat directory /hewitt/coz/current/doc/man/cat1/catsearch.1...

thanks

MikeFultonDev commented 1 year ago

Hm. I would think it should look at what is in the MANPATH only. I don't think we can 'know' where the man pages are by default unless we decide to make the assumption they are relative to mandb - which might make sense.

What would be 'least surprising' here @gngrossi ?

gngrossi commented 1 year ago

My case, before sourcing all of the tools.

[@02858@SYSA]$ echo $MANPATH /usr/man/%L:/hewitt/coz/current/doc/man:/usr/lpp/ported/man/C

Is it feasible to determine where the tools are installed, process them and ignore all other MANPATH directories? thanks

MikeFultonDev commented 1 year ago

In the general case, I don't think we can know where all the tools are installed. We could solve a 'common case' where the tools are all installed in a common directory that is the same as where mandb is installed, and find the corresponding MANPATH for that common directory. I see that /hewitt/coz is presumably coz tools. Do they use the IBM z/OS 'man' format, the Linux 'man' format, or yet another format? Same question for the tools under /usr/lpp/ported/man/C ? I'm just thinking perhaps another approach is to know what directories to 'exclude' or to detect they are not Linux man pages and therefore shouldn't be processed?

gngrossi commented 1 year ago

I would guess z/OS man format. Does this help?

image

MikeFultonDev commented 1 year ago

unfortunately i don't have the product. maybe if someone from COZ can comment? Do you have any contacts?

AnthonyGiorgio commented 1 year ago

If you could dump the man file directly, via cat or similar, that would show the format.

gngrossi commented 1 year ago

Here's one.

image

MikeFultonDev commented 1 year ago

that looks like something mandb should be able to chew on - which would I think be useful. So perhaps we only need to avoid the actual IBM z/OS man pages? I guess it depends if the Co:Z folks would want their man pages to be put into your database?

AnthonyGiorgio commented 1 year ago

That's definitely in troff or nroff format. Any non-z/OS man should be able to render that.

gngrossi commented 8 months ago

Ran mandb (unset MANPATH && cd /hewitt/zopentools/zopen_repo-current/usr/local/zopen && mandb .)

Are these warnings expected?

Processing manual pages under /hewitt/zopentools/zopen_repo/usr/local/zopen/.... Updating index cache for path `/hewitt/zopentools/zopen_repo/usr/local/zopen/./man-db'. Wait...mandb: warning: /hewitt/zopentools/zopen_repo/usr/local/zopen/./man-db/man-db-2.12.0.20240124_132957.zos: ignoring bogus filename mandb: warning: /hewitt/zopentools/zopen_repo/usr/local/zopen/./man-db/man-db: ignoring bogus filename done.

gngrossi commented 4 months ago

image

gngrossi commented 1 month ago

@MikeFultonDev

Upgraded man-db

cd /hewitt/zopentools/zopen_repo-current/usr/local/zopen && (unset MANPATH && cd /hewitt/zopentools/zopen_repo-current/usr/local/zopen && mandb .)

Processing manual pages under /hewitt/zopentools/zopen_repo/usr/local/zopen/.... mandb: fatal: unable to insert version identifier into /hewitt/zopentools/zopen_repo/usr/local/zopen/./34275865