Re: How to Setup Multiple System Distro Manpages

2018-07-15 Thread Thomas Wolff

Am 15.07.2018 um 14:19 schrieb john doe:

On 7/15/2018 9:21 AM, Brian Inglis wrote:

On 2018-07-15 00:39, john doe wrote:

On 7/14/2018 10:50 PM, Brian Inglis wrote:
I've installed a few WSL distros for comparison and downloaded a 
bunch of other

manpage sets and unpacked them:
$ l /proc/cygdrive/c/usr/local/share/man/
cat1/  debian@  man1p/ mann/   
SunOS-5.10/
cat3/  Debian-8.1.0/    man2/ netbsd@ 
suse@
cat5/  freebsd@ man3/ NetBSD-7.1/ 
SuSE-11.3/

...
but despite reading docs, adding links and changing configs, I'm 
unable to get

man/-db to access these with or without the -m system switch.
I know I must be missing some essential point, but searching has 
not come up

with anything to help me fix this.
Has anyone here set this up and can suggest an approach that will 
work?
In addition to the other answers; maybe exporting those directories 
in the

'PATH' env variable...


I already tried listing them all at the end of man-db.conf and MANPATH.


I was talking about the env 'PATH' var and not 'MANPATH' but that does 
not make any difference. :)

Of course it does. man does not look at PATH.


$ cat ${HOME}/try/mann/bogus.n
[boring contents skipped]
$ man --manpath=${HOME}/try bogus
[...]
Redirecting the manpath and adding alternative systems as man domains 
are two separate issues.
Both work just fine, adding another system (whether also redirected or 
not) works without any additional configuration.


--
Problem reports:   http://cygwin.com/problems.html
FAQ:   http://cygwin.com/faq/
Documentation: http://cygwin.com/docs.html
Unsubscribe info:  http://cygwin.com/ml/#unsubscribe-simple



Re: How to Setup Multiple System Distro Manpages

2018-07-15 Thread john doe

On 7/15/2018 9:21 AM, Brian Inglis wrote:

On 2018-07-15 00:39, john doe wrote:

On 7/14/2018 10:50 PM, Brian Inglis wrote:

I've installed a few WSL distros for comparison and downloaded a bunch of other
manpage sets and unpacked them:
$ l /proc/cygdrive/c/usr/local/share/man/
cat1/  debian@  man1p/  mann/   SunOS-5.10/
cat3/  Debian-8.1.0/    man2/   netbsd@ suse@
cat5/  freebsd@ man3/   NetBSD-7.1/ SuSE-11.3/
cat7/  FreeBSD-12-current/  man3p/  openbsd@    ubuntu@
cat8/  FreeBSD-ports-11.1-RELEASE/  man4/   OpenBSD-6.2/    x@
centos@    hpux@    man5/   ports@  X11R7.4/
CentOS-7.1/    HP-UX-11.22/ man6/   redhat@
darwin@    man0p/   man7/   RedHat-9-i386/
Darwin-7.0.1/  man1/    man8/   solaris@
but despite reading docs, adding links and changing configs, I'm unable to get
man/-db to access these with or without the -m system switch.
I know I must be missing some essential point, but searching has not come up
with anything to help me fix this.
Has anyone here set this up and can suggest an approach that will work?

In addition to the other answers; maybe exporting those directories in the
'PATH' env variable...


I already tried listing them all at the end of man-db.conf and MANPATH.



I was talking about the env 'PATH' var and not 'MANPATH' but that does 
not make any difference. :)


From the test I've done and using:

https://www.cyberciti.biz/faq/linux-unix-creating-a-manpage/

$ cat ${HOME}/try/mann/bogus.n
.\" Manpage for bogus.
.\" Contact vi...@nixcraft.net.in to correct errors or typos.
.TH man 8 "06 May 2010" "1.0" "bogus man page"
.SH NAME
bogus \- create a new LDAP user
.SH SYNOPSIS
bogus [USERNAME]
.SH DESCRIPTION
bogus is high level shell program for adding users to LDAP server.  On 
Debian, administrators should usually use bogus.debian(8) instead.

.SH OPTIONS
The bogus does not take any options. However, you can supply username.
.SH SEE ALSO
bogus(8), passwd(5), bogus.debian(8)
.SH BUGS
No known bugs.
.SH AUTHOR
Vivek Gite (vi...@nixcraft.net.in)

$ man --manpath=${HOME}/try bogus
man(8) 
bogus man page 
 man(8)


NAME
   bogus - create a new LDAP user

SYNOPSIS
   bogus [USERNAME]

DESCRIPTION
   bogus is high level shell program for adding users to LDAP 
server.  On Debian, administrators should usually use bogus.debian(8) 
instead.


OPTIONS
   The bogus does not take any options. However, you can supply 
username.


SEE ALSO
   bogus(8), passwd(5), bogus.debian(8)

BUGS
   No known bugs.

AUTHOR
   Vivek Gite (vi...@nixcraft.net.in)

1.0 
  06 May 2010 
 man(8)


HTH

--
John Doe

--
Problem reports:   http://cygwin.com/problems.html
FAQ:   http://cygwin.com/faq/
Documentation: http://cygwin.com/docs.html
Unsubscribe info:  http://cygwin.com/ml/#unsubscribe-simple



Re: How to Setup Multiple System Distro Manpages

2018-07-15 Thread Brian Inglis
On 2018-07-15 00:39, john doe wrote:
> On 7/14/2018 10:50 PM, Brian Inglis wrote:
>> I've installed a few WSL distros for comparison and downloaded a bunch of 
>> other
>> manpage sets and unpacked them:
>> $ l /proc/cygdrive/c/usr/local/share/man/
>> cat1/  debian@  man1p/  mann/   
>> SunOS-5.10/
>> cat3/  Debian-8.1.0/    man2/   netbsd@ suse@
>> cat5/  freebsd@ man3/   NetBSD-7.1/ 
>> SuSE-11.3/
>> cat7/  FreeBSD-12-current/  man3p/  openbsd@    ubuntu@
>> cat8/  FreeBSD-ports-11.1-RELEASE/  man4/   OpenBSD-6.2/    x@
>> centos@    hpux@    man5/   ports@  X11R7.4/
>> CentOS-7.1/    HP-UX-11.22/ man6/   redhat@
>> darwin@    man0p/   man7/   RedHat-9-i386/
>> Darwin-7.0.1/  man1/    man8/   solaris@
>> but despite reading docs, adding links and changing configs, I'm unable to 
>> get
>> man/-db to access these with or without the -m system switch.
>> I know I must be missing some essential point, but searching has not come up
>> with anything to help me fix this.
>> Has anyone here set this up and can suggest an approach that will work?
> In addition to the other answers; maybe exporting those directories in the
> 'PATH' env variable...

I already tried listing them all at the end of man-db.conf and MANPATH.

-- 
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada

--
Problem reports:   http://cygwin.com/problems.html
FAQ:   http://cygwin.com/faq/
Documentation: http://cygwin.com/docs.html
Unsubscribe info:  http://cygwin.com/ml/#unsubscribe-simple



Re: How to Setup Multiple System Distro Manpages

2018-07-15 Thread Brian Inglis
On 2018-07-14 22:25, Wayne Davison wrote:
> On Sat, Jul 14, 2018 at 1:51 PM Brian Inglis wrote:
>> $ l /proc/cygdrive/c/usr/local/share/man/
> 
> Shouldn't those be under /usr/local instead of
> /proc/cygdrive/c/usr/local?  Typically /usr is something like
> C:/cygwin64/usr, which is not the C:/usr dir you've used.

Shouldn't be any problem as long as the search path is in man-db.conf or 
MANPATH.
Under Filesystem Hierarchy Standard:
- /usr/share/man/ is for system supplied package manpages;
- /usr/local/share/man/ is for locally built package manpages for that system:
  /opt/man/ on some systems; comes *before* system paths in MANPATH;
- /proc/cygdrive/c/usr/local/ is not FHS but follows those rules, where I store
  my system top level distros, including AST, DJGPP, Cygwin, etc., links to
  WSL distros' rootfs; and native, common, or shared stuff goes under
  subdirectories:
  . bin/native user .exe .cmd .reg;
  . etc/configs .ini etc.;
  . lib/support or addins .dll .exe;
  . sbin/   native system admin .exe .cmd .reg;
  . share/  data, docs, etc. including:
~ man/  misc and old stuff, like alt.sysadmin.recovery (**) and
funny manpages (**NSFW); *after* system paths in MANPATH;
~ cat1/ cmd.exe internal and external command and
native Windows utilities help;
  . src/native utility and package sources e.g. from net or github;

where these are not part of a distro, and if I wipe out a distro, they remain;
similar to, and could become, a network mount instead of local storage.

-- 
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada

--
Problem reports:   http://cygwin.com/problems.html
FAQ:   http://cygwin.com/faq/
Documentation: http://cygwin.com/docs.html
Unsubscribe info:  http://cygwin.com/ml/#unsubscribe-simple



Re: How to Setup Multiple System Distro Manpages

2018-07-14 Thread john doe

On 7/14/2018 10:50 PM, Brian Inglis wrote:

Hi folks,
I've installed a few WSL distros for comparison and downloaded a bunch of other
manpage sets and unpacked them:
$ l src/man/*[0-9].tar.gz
src/man/CentOS_7.1.tar.gz  src/man/NetBSD_7.1.tar.gz
src/man/Darwin_7.0.1.tar.gzsrc/man/OpenBSD_6.2.tar.gz
src/man/Debian_8.1.0.tar.gzsrc/man/Red_Hat_Linux_i386_9.tar.gz
src/man/FreeBSD_12.tar.gz  src/man/SunOS_5.10.tar.gz
src/man/FreeBSD_Ports_11.1.tar.gz  src/man/SuSE_Linux_i386_11.3.tar.gz
src/man/HP-UX_11.22.tar.gz src/man/X11_R7.4.tar.gz

$ l /proc/cygdrive/c/usr/local/share/man/
cat1/  debian@  man1p/  mann/   SunOS-5.10/
cat3/  Debian-8.1.0/man2/   netbsd@ suse@
cat5/  freebsd@ man3/   NetBSD-7.1/ SuSE-11.3/
cat7/  FreeBSD-12-current/  man3p/  openbsd@ubuntu@
cat8/  FreeBSD-ports-11.1-RELEASE/  man4/   OpenBSD-6.2/x@
centos@hpux@man5/   ports@  X11R7.4/
CentOS-7.1/HP-UX-11.22/ man6/   redhat@
darwin@man0p/   man7/   RedHat-9-i386/
Darwin-7.0.1/  man1/man8/   solaris@

but despite reading docs, adding links and changing configs, I'm unable to get
man/-db to access these with or without the -m system switch.

I know I must be missing some essential point, but searching has not come up
with anything to help me fix this.

Has anyone here set this up and can suggest an approach that will work?



In addition to the other answers; maybe exporting those directories in 
the 'PATH' env variable...


--
John Doe

--
Problem reports:   http://cygwin.com/problems.html
FAQ:   http://cygwin.com/faq/
Documentation: http://cygwin.com/docs.html
Unsubscribe info:  http://cygwin.com/ml/#unsubscribe-simple



Re: How to Setup Multiple System Distro Manpages

2018-07-14 Thread Thomas Wolff




On 07/14/2018 04:50 PM, Brian Inglis wrote:

I've installed a few WSL distros for comparison and downloaded a bunch of other
manpage sets and unpacked them:
$ l /proc/cygdrive/c/usr/local/share/man/
cat1/  debian@  man1p/  mann/   SunOS-5.10/
cat3/  Debian-8.1.0/    man2/   netbsd@ suse@
cat5/  freebsd@ man3/   NetBSD-7.1/ SuSE-11.3/
cat7/  FreeBSD-12-current/  man3p/  openbsd@    ubuntu@
cat8/  FreeBSD-ports-11.1-RELEASE/  man4/   OpenBSD-6.2/    x@
centos@    hpux@    man5/   ports@  X11R7.4/
CentOS-7.1/    HP-UX-11.22/ man6/   redhat@
darwin@    man0p/   man7/   RedHat-9-i386/
Darwin-7.0.1/  man1/    man8/   solaris@

but despite reading docs, adding links and changing configs, I'm unable to get
man/-db to access these with or without the -m system switch.

I know I must be missing some essential point, but searching has not come up
with anything to help me fix this.

Has anyone here set this up and can suggest an approach that will work?

Works fine for me, in the usual place however, not using /usr/local:
/usr/share/man/alt/man1/foo.1
man -m alt foo

--
Problem reports:   http://cygwin.com/problems.html
FAQ:   http://cygwin.com/faq/
Documentation: http://cygwin.com/docs.html
Unsubscribe info:  http://cygwin.com/ml/#unsubscribe-simple



Re: How to Setup Multiple System Distro Manpages

2018-07-14 Thread Wayne Davison
On Sat, Jul 14, 2018 at 1:51 PM Brian Inglis wrote:
> $ l /proc/cygdrive/c/usr/local/share/man/

Shouldn't those be under /usr/local instead of
/proc/cygdrive/c/usr/local?  Typically /usr is something like
C:/cygwin64/usr, which is not the C:/usr dir you've used.

..wayne..

--
Problem reports:   http://cygwin.com/problems.html
FAQ:   http://cygwin.com/faq/
Documentation: http://cygwin.com/docs.html
Unsubscribe info:  http://cygwin.com/ml/#unsubscribe-simple



Re: How to Setup Multiple System Distro Manpages

2018-07-14 Thread Brian Inglis
On 2018-07-14 16:40, Jack wrote:
> On 07/14/2018 04:50 PM, Brian Inglis wrote:

>> I've installed a few WSL distros for comparison and downloaded a bunch of 
>> other
>> manpage sets and unpacked them:
>> $ l /proc/cygdrive/c/usr/local/share/man/
>> cat1/  debian@  man1p/  mann/   
>> SunOS-5.10/
>> cat3/  Debian-8.1.0/    man2/   netbsd@ suse@
>> cat5/  freebsd@ man3/   NetBSD-7.1/ 
>> SuSE-11.3/
>> cat7/  FreeBSD-12-current/  man3p/  openbsd@    ubuntu@
>> cat8/  FreeBSD-ports-11.1-RELEASE/  man4/   OpenBSD-6.2/    x@
>> centos@    hpux@    man5/   ports@  X11R7.4/
>> CentOS-7.1/    HP-UX-11.22/ man6/   redhat@
>> darwin@    man0p/   man7/   RedHat-9-i386/
>> Darwin-7.0.1/  man1/    man8/   solaris@
>>
>> but despite reading docs, adding links and changing configs, I'm unable to 
>> get
>> man/-db to access these with or without the -m system switch.
>>
>> I know I must be missing some essential point, but searching has not come up
>> with anything to help me fix this.
>>
>> Has anyone here set this up and can suggest an approach that will work?
>>
> Purely a guess on my part, but should those directories all start with "man" 
> (or
> "cat") ?

>From docs I have checked, man is the default name for the current system e.g.
man -m man, and freebsd, debian, etc. should be at the same level, with man?,
cat?, xx_XX, directories below that, so I have linked and moved them up and down
the hierarchy, modified /etc/man_db.conf to match, rerun mandb, and tried using
"man -m freebsd ...", etc. without any success as far as I can tell.

I have other system man and cat directories in my MANPATH at various levels
above and under Cygwin, and can access those manpages, just not the alternative
systems.
I am sure I must have missed something unobvious in the docs, and noticed
nothing about this in the books, which I have checked.

-- 
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada

--
Problem reports:   http://cygwin.com/problems.html
FAQ:   http://cygwin.com/faq/
Documentation: http://cygwin.com/docs.html
Unsubscribe info:  http://cygwin.com/ml/#unsubscribe-simple



Re: How to Setup Multiple System Distro Manpages

2018-07-14 Thread Jack

On 07/14/2018 04:50 PM, Brian Inglis wrote:

Hi folks,
I've installed a few WSL distros for comparison and downloaded a bunch of other
manpage sets and unpacked them:
$ l src/man/*[0-9].tar.gz
src/man/CentOS_7.1.tar.gz  src/man/NetBSD_7.1.tar.gz
src/man/Darwin_7.0.1.tar.gzsrc/man/OpenBSD_6.2.tar.gz
src/man/Debian_8.1.0.tar.gzsrc/man/Red_Hat_Linux_i386_9.tar.gz
src/man/FreeBSD_12.tar.gz  src/man/SunOS_5.10.tar.gz
src/man/FreeBSD_Ports_11.1.tar.gz  src/man/SuSE_Linux_i386_11.3.tar.gz
src/man/HP-UX_11.22.tar.gz src/man/X11_R7.4.tar.gz

$ l /proc/cygdrive/c/usr/local/share/man/
cat1/  debian@  man1p/  mann/   SunOS-5.10/
cat3/  Debian-8.1.0/man2/   netbsd@ suse@
cat5/  freebsd@ man3/   NetBSD-7.1/ SuSE-11.3/
cat7/  FreeBSD-12-current/  man3p/  openbsd@ubuntu@
cat8/  FreeBSD-ports-11.1-RELEASE/  man4/   OpenBSD-6.2/x@
centos@hpux@man5/   ports@  X11R7.4/
CentOS-7.1/HP-UX-11.22/ man6/   redhat@
darwin@man0p/   man7/   RedHat-9-i386/
Darwin-7.0.1/  man1/man8/   solaris@

but despite reading docs, adding links and changing configs, I'm unable to get
man/-db to access these with or without the -m system switch.

I know I must be missing some essential point, but searching has not come up
with anything to help me fix this.

Has anyone here set this up and can suggest an approach that will work?

Purely a guess on my part, but should those directories all start with 
"man" (or "cat") ?


Jack

--
Problem reports:   http://cygwin.com/problems.html
FAQ:   http://cygwin.com/faq/
Documentation: http://cygwin.com/docs.html
Unsubscribe info:  http://cygwin.com/ml/#unsubscribe-simple



How to Setup Multiple System Distro Manpages

2018-07-14 Thread Brian Inglis
Hi folks,
I've installed a few WSL distros for comparison and downloaded a bunch of other
manpage sets and unpacked them:
$ l src/man/*[0-9].tar.gz
src/man/CentOS_7.1.tar.gz  src/man/NetBSD_7.1.tar.gz
src/man/Darwin_7.0.1.tar.gzsrc/man/OpenBSD_6.2.tar.gz
src/man/Debian_8.1.0.tar.gzsrc/man/Red_Hat_Linux_i386_9.tar.gz
src/man/FreeBSD_12.tar.gz  src/man/SunOS_5.10.tar.gz
src/man/FreeBSD_Ports_11.1.tar.gz  src/man/SuSE_Linux_i386_11.3.tar.gz
src/man/HP-UX_11.22.tar.gz src/man/X11_R7.4.tar.gz

$ l /proc/cygdrive/c/usr/local/share/man/
cat1/  debian@  man1p/  mann/   SunOS-5.10/
cat3/  Debian-8.1.0/man2/   netbsd@ suse@
cat5/  freebsd@ man3/   NetBSD-7.1/ SuSE-11.3/
cat7/  FreeBSD-12-current/  man3p/  openbsd@ubuntu@
cat8/  FreeBSD-ports-11.1-RELEASE/  man4/   OpenBSD-6.2/x@
centos@hpux@man5/   ports@  X11R7.4/
CentOS-7.1/HP-UX-11.22/ man6/   redhat@
darwin@man0p/   man7/   RedHat-9-i386/
Darwin-7.0.1/  man1/man8/   solaris@

but despite reading docs, adding links and changing configs, I'm unable to get
man/-db to access these with or without the -m system switch.

I know I must be missing some essential point, but searching has not come up
with anything to help me fix this.

Has anyone here set this up and can suggest an approach that will work?

-- 
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada

--
Problem reports:   http://cygwin.com/problems.html
FAQ:   http://cygwin.com/faq/
Documentation: http://cygwin.com/docs.html
Unsubscribe info:  http://cygwin.com/ml/#unsubscribe-simple