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-boun...@lists.samba.org [mailto:samba-boun...@lists.samba.org] > On Behalf Of Tom McArthur > Sent: Friday, December 14, 2012 7:06 PM > To: samba@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 > -- To unsubscribe from this list go to the following URL and read the instructions: https://lists.samba.org/mailman/options/samba
