getting closer

....

1 files changed, 109 insertions, 101 deletions

diff --git a/docs/manpages/smbcontrol.1 b/docs/manpages/smbcontrol.1
index 2dbe1212cfe..02cd2ca6c44 100644
--- a/docs/manpages/smbcontrol.1
+++ b/docs/manpages/smbcontrol.1
@@ -1,102 +1,110 @@
-.TH SMBCONTROL 1 "23 Nov 2000" "smbcontrol 2.2.0-alpha1"
-.PP 
-.SH "NAME" 
+.\" This manpage has been automatically generated by docbook2man-spec
+.\" from a DocBook document.  docbook2man-spec can be found at:
+.\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> 
+.\" Please send any bug reports, improvements, comments, patches, 
+.\" etc. to Steve Cheng <steve@ggi-project.org>.
+.TH "SMBCONTROL" "1" "22 February 2001" "" ""
+.SH NAME
 smbcontrol \- send messages to smbd or nmbd processes
-.PP 
-.SH "SYNOPSIS" 
-.PP 
-\fBsmbcontrol\fP -i
-.PP 
-\fBsmbcontrol\fP destination message-type parameters
-.PP 
-.SH "DESCRIPTION" 
-.PP 
-This program is part of the \fBSamba\fP suite\&.
-.PP 
-\fBsmbcontrol\fP is a very small program, which sends messages to an 
-\fBsmbd\fP or an \fBnmbd\fP daemon 
-running on the system\&.
-.PP 
-.SH "OPTIONS" 
-.PP 
-.IP 
-.IP "\fB-i\fP" 
-Run interactively\&. Individual commands of the form
-destination message-type parameters
-can be entered on STDIN\&. An empty command line or a "q" will quit the program\&.
-.IP 
-.IP "\fBdestination\fP" 
-is one of "nmbd", "smbd" or a process ID\&.
-.IP 
-The \fBsmbd\fP destination causes the message to be "broadcast" to all
-smbd daemons\&.
-.IP 
-The \fBnmbd\fP destination causes the message to be sent to the nmbd
-daemon specified in the \fBnmbd\&.pid\fP file\&.
-.IP 
-If a single process ID is given, the message is sent to only that
-process\&.
-.IP 
-.IP "\fBmessage-type\fP" 
-is one of: debug, force-election, ping, profile,
-debuglevel, profilelevel, or printer-notify\&.
-.IP 
-The \fBdebug\fP message-type allows the debug level to be set to the value
-specified by the parameter\&. This can be sent to any of the destinations\&.
-.IP 
-The \fBforce-election\fP message-type can only be sent to the \fBnmbd\fP
-destination\&. This message causes the \fBnmbd\fP daemon to force a
-new browse master election\&.
-.IP 
-The \fBping\fP message-type sends the number of "ping" messages specified 
-by the parameter and waits for the same number of 
-reply "pong" messages\&. This can be sent to any of the destinations\&.
-.IP 
-The \fBprofile\fP message-type sends a message to an smbd to change the profile
-settings based on the parameter\&. The parameter can be "on" to turn on
-profile stats collection, "off" to turn off profile stats collection, "count"
-to enable only collection of count stats (time stats are disabled), and
-"flush" to zero the current profile stats\&.
-This can be sent to any of the destinations\&.
-.IP 
-The \fBdebuglevel\fP message-type sends a "request debug level" message\&.
-The current debug level setting is returned by a 
-"debuglevel" message\&. This can be sent to any of the destinations\&.
-.IP 
-The \fBprofilelevel\fP message-type sends a "request profile level" message\&.
-The current profile level setting is returned by a 
-"profilelevel" message\&. This can be sent to any of the destinations\&.
-.IP 
-The \fBprinter-notify\fP message-type sends a message to smbd which in turn 
-sends a printer notify message to any Windows NT clients connected to 
-a printer\&.  This message-type takes an argument of the printer name to 
-send notify messages to\&.   This message can only be sent to smbd\&.
-.IP 
-.IP "\fBparameters\fP" 
-is any parameters required for the message-type
-.IP 
-.PP 
-.SH "VERSION" 
-.PP 
-This man page is correct for version 2\&.2\&.0 of the Samba suite\&.
-.PP 
-.SH "SEE ALSO" 
-.PP 
-\fBsmbd (8)\fP, \fBnmbd (8)\fP
-.PP 
-.SH "AUTHOR" 
-.PP 
-The original Samba software and related utilities were created by
-Andrew Tridgell \fIsamba@samba\&.org\fP\&. Samba is now developed
-by the Samba Team as an Open Source project similar to the way the
-Linux kernel is developed\&.
-.PP 
-This man page source was written in YODL format (another excellent piece of Open
-Source software, available at
-\fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP)
-for the Samba 2\&.2\&.0 release by Herb Lewis\&.
-\fIsamba@samba\&.org\fP\&.
-.PP 
-See \fBsamba (7)\fP to find out how to get a full
-list of contributors and details on how to submit bug reports,
-comments etc\&.
+.SH SYNOPSIS
+.sp
+\fBsmbcontrol\fR [ \fB-i\fR ] 
+.sp
+\fBsmbcontrol\fR [ \fBdestination\fR ]  [ \fBmessage-type\fR ]  [ \fBparameter\fR ] 
+.SH "DESCRIPTION"
+.PP
+This tool is part of the  Samba <URL:samba.7.html> suite.
+.PP
+\fBsmbcontrol\fR is a very small program, which 
+sends messages to an smbd(8) <URL:smbd.8.html> or 
+an nmbd(8) <URL:nmbd.8.html> daemon running on the 
+system.
+.SH "OPTIONS"
+.TP
+\fB-i>\fR
+Run interactively. Individual commands 
+of the form destination message-type parameters can be entered 
+on STDIN. An empty command line or a "q" will quit the 
+program.
+.TP
+\fBdestination\fR
+One of \fInmbd\fR
+\fIsmbd\fR or a process ID.
+
+The \fIsmbd\fR destination causes the 
+message to "broadcast" to all smbd daemons.
+
+The \fInmbd\fR destination causes the 
+message to be sent to the nmbd daemon specified in the 
+\fInmbd.pid\fR file.
+
+If a single process ID is given, the message is sent 
+to only that process.
+.TP
+\fBmessage-type\fR
+One of: debug, 
+force-election, ping
+, profile,  debuglevel, profilelevel, 
+or printer-notify.
+
+The debug message-type allows 
+the debug level to be set to the value specified by the 
+parameter. This can be sent to any of the destinations.
+
+The force-election message-type can only be 
+sent to the nmbd destination. This message 
+causes the \fBnmbd\fR daemon to force a new browse
+master election.
+
+The ping message-type sends the 
+number of "ping" messages specified by the parameter and waits 
+for the same number of reply "pong" messages. This can be sent to 
+any of the destinations.
+
+The profile message-type sends a 
+message to an smbd to change the profile settings based on the 
+parameter. The parameter can be "on" to turn on profile stats 
+collection, "off" to turn off profile stats collection, "count"
+to enable only collection of count stats (time stats are 
+disabled), and "flush" to zero the current profile stats. This can 
+be sent to any of the destinations.
+
+The debuglevel message-type sends 
+a "request debug level" message. The current debug level setting 
+is returned by a "debuglevel" message. This can be 
+sent to any of the destinations.
+
+The profilelevel message-type sends 
+a "request profile level" message. The current profile level 
+setting is returned by a "profilelevel" message. This can be sent 
+to any of the destinations.
+
+The printer-notify message-type sends a 
+message to smbd which in turn sends a printer notify message to 
+any Windows NT clients connected to a printer. This message-type 
+takes an argument of the printer name to send notify messages to. 
+This message can only be sent to smbd.
+.TP
+\fBparameters\fR
+any parameters required for the message-type
+.SH "VERSION"
+.PP
+This man page is correct for version 2.2 of 
+the Samba suite.
+.SH "SEE ALSO"
+.PP
+\fBnmbd(8)\fR <URL:nmbd.8.html>, 
+and \fBsmbd(8)\fR <URL:smbd.8.html>.
+.SH "AUTHOR"
+.PP
+The original Samba software and related utilities 
+were created by Andrew Tridgell. Samba is now developed
+by the Samba Team as an Open Source project similar 
+to the way the Linux kernel is developed.
+.PP
+The original Samba man pages were written by Karl Auer. 
+The man page sources were converted to YODL format (another 
+excellent piece of Open Source software, available at
+ftp://ftp.icce.rug.nl/pub/unix/ <URL:ftp://ftp.icce.rug.nl/pub/unix/>) and updated for the Samba 2.0 
+release by Jeremy Allison. The conversion to DocBook for 
+Samba 2.2 was done by Gerald Carter