Validate messages from mandb

[gngrossi]

mandb_output.txt mandb_output2.txt

[gngrossi]

mandb_output4.txt

[gngrossi]

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]

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]

/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]

investigating

[MikeFultonDev]

@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]

@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]

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]

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

[MikeFultonDev]

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]

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]

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]

mandb output mandb_output_6-22-2023.txt

[gngrossi]

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]

mandb output mandb_output_6-23-2023.txt

[gngrossi]

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]

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]

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]

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]

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]

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]

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]

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]

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]

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

[MikeFultonDev]

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

[AnthonyGiorgio]

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

[gngrossi]

Here's one.

[MikeFultonDev]

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]

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

[gngrossi]

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]