SWAT, the web based tool for managing Samba, expects its help documents to be placed along a path that the package installation process within Yast2 fails to honor. This results in SWAT being unable to show Samba help documents when a user clicks on a link for them.

The expected path that SWAT wants is

/usr/share/samba/swat/help/manpages

but Yast2 installed the package for the Samba documentation at

/usr/share/doc/packages/samba/htmldocs/manpages

To fix the problem I had to manually create a soft link in the directory /usr/share/samba/swat/help for manpages so it points to the location that Yast2 installed the documents at -

manpages -> /usr/share/doc/packages/samba/htmldocs/manpages

I did NOT check to see if ALL the help and document links in the SWAT html pages expect this same paradigm so whoever resolves this problem should check very carefully to make sure all the links work and documents are installed where SWAT expects them to be.

This problem has been around for at least a couple of releases now, I finally got annoyed enough to spend the time to figure out how to report this problem (NOT VERY OBVIOUS IMHO!!! The process of reporting bugs and giving feedback needs to be much easier and more intuitive, I almost walked away again and about gave up, suspect others will!)