[Samba] Installing manpages
E M
erm337 at bell.net
Thu Dec 20 11:25:52 MST 2012
Hi,
I'm working on Ubuntu 12.04, and compiling from the git source. I created
the html version of the manuals like this (my samba-master tree is
~/samba-master).
sudo apt-get install docbook-utils xsltproc
cd ~/samba-master/docs-xml
cp Makefile.settings.in Makefile.settings
I edited Makefile.settings, and changed 2 lines:
XSLTPROC = xsltproc # was @XSLTPROC@
.
.
.
OUTPUTDIR = /usr/local/samba/share # was output
sudo make htmlman
sudo make manpages
This creates /usr/local/samba/share/htmldocs/manpages/index.html and many
other pages in that same directory. It also creates
/usr/local/samba/share/manpages. I can get at the html files using the
browser. I haven't had success accessing the manpages using the man system
yet.
Endel
-----Original Message-----
From: samba-bounces at lists.samba.org [mailto:samba-bounces at lists.samba.org]
On Behalf Of Tom McArthur
Sent: Friday, December 14, 2012 7:06 PM
To: samba at lists.samba.org
Subject: [Samba] Installing manpages
According to the Samba documentation, the manpages are supposed to be
installed with Samba. Quote:
docs/manpages: You don't need to worry about these yet; during the
installation, the files will be installed so that you can use the man
command to read them. But you can take a look in the directory to see
which manpages are available.
My problem:
Samba4 on 64bit Fedora 17 will not install the manpages, other than a
bare-bones "samba" page. Specifically, it will not install the
"smb.conf" page.
What I tried:
I tried reinstalling Samba with the following commands:
sudo yum reinstall samba4
sudo yum reinstall samba4-devel
sudo yum reinstall samba4-common
sudo yum reinstall samba4-libs
No luck - "man smb.conf" still gave a "No manual entry for smb.conf" error.
After googling some more, I found the "make installman" command. So I
downloaded the source for Samba4, and ran ./configure, make, and then
make installman. That returned the following error:
No rule to make target `installman'
Wow, this is a PITA. Googling for that error didn't reveal anything helpful.
Next, I reinstalled from source (which I just finished compiling),
thinking the manpages might be installed with a full, manual
installation: sudo make install. Still no luck - "man smb.conf" still
gives the same error.
During my googling, I remember reading about pointing the "man" command
to the location of the manpages. So, I used the following command to
look for the man pages:
locate smb|grep man
Next, "man man" told me the location of the local man config file. I
wasn't sure which PATH to use, so I added these to /etc/man_db.conf:
MANPATH_MAP /bin /usr/local/samba/share/man
MANPATH_MAP /usr/bin /usr/local/samba/share/man
MANPATH_MAP /sbin /usr/local/samba/share/man
That finally fixed my manpage problem.
Why must the Samba man pages be so $#@%#! difficult to install? Every
other Linux application that I have ever installed automatically
installs the man pages. Why can't Samba do the same thing?
PS: This email would be a lot easier to read if mailing lists supported
<code> tags, or if Samba had a forum or bulletin board. :)
--
To unsubscribe from this list go to the following URL and read the
instructions: https://lists.samba.org/mailman/options/samba
More information about the samba
mailing list