s3-smbd: longer explanation of smbd_shim code

Pair-Programmed-With: Andrew Bartlett <abartlet@samba.org>

Autobuild-User: Andrew Tridgell <tridge@samba.org>
Autobuild-Date: Tue Jun 21 09:05:37 CEST 2011 on sn-devel-104

diff --git a/source3/lib/smbd_shim.h b/source3/lib/smbd_shim.h
index 415f81bf362f6871998ded241d34b3b27cb3c085..89cae2b694df07bb1eef73d2d7a38bbd626f41c1 100644 (file)
--- a/source3/lib/smbd_shim.h
+++ b/source3/lib/smbd_shim.h
@@ -19,8 +19,13 @@
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
-/* Shim functions required due to the horrible dependency mess
-   in Samba. */
+/* 
+   shim functions are used required to allow library code to have
+   references to smbd specific code. The smbd daemon sets up the set
+   of function calls that it wants used by calling
+   set_smbd_shim(). Other executables don't make this call, and get
+   default (dummy) versions of these functions.
+*/
 
 struct smbd_shim
 {