[Samba] Installing manpages

[Bob Miller]

I recently crossed this path as well.  My experience was slightly
different.  I installed xsltproc and docbook, but I did not have to do a
'make manpages', they just compiled with everything else and installed
them at /usr/local/samba/share.  I then configured the man system
in /etc/manpath.config by adding a line like:
MANDATORY_MANPATH /usr/local/samba/share/man
The best information I found on the web about that was an irc log of a
conversation on one of the #samba* channels.
-- 
Computerisms
Bob Miller      
867-334-7117 / 867-633-3760
http://computerisms.ca


On Thu, 2012-12-20 at 13:25 -0500, E M wrote:
> 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
>