Tidied up references to samba (7).

Added smbtar.1.yo.
Jeremy.

5 files changed, 131 insertions, 4 deletions

diff --git a/docs/yodldocs/make_smbcodepage.1.yo b/docs/yodldocs/make_smbcodepage.1.yo
index fe29d94e869..fbf9c0f3af1 100644
--- a/docs/yodldocs/make_smbcodepage.1.yo
+++ b/docs/yodldocs/make_smbcodepage.1.yo
@@ -139,6 +139,6 @@ sources were converted to YODL format (another excellent piece of Open
 Source software) and updated for the Samba2.0 release by Jeremy
 Allison, email(samba-bugs@samba.anu.edu.au).
 
-See url(bf(samba (8)))(samba.7.html) to find out how to get a full
+See url(bf(samba (7)))(samba.7.html) to find out how to get a full
 list of contributors and details on how to submit bug reports,
 comments etc.
diff --git a/docs/yodldocs/smbclient.1.yo b/docs/yodldocs/smbclient.1.yo
index 0ff1c006c24..5346f4ac6c3 100644
--- a/docs/yodldocs/smbclient.1.yo
+++ b/docs/yodldocs/smbclient.1.yo
@@ -153,6 +153,7 @@ machine's hostname (in uppercase) as its NetBIOS name. This parameter
 allows you to override the host name and use whatever NetBIOS name you
 wish.
 
+label(minus_d)
 dit(bf(-d debuglevel)) debuglevel is an integer from 0 to 10, or the
 letter 'A'.
 
@@ -707,6 +708,6 @@ sources were converted to YODL format (another excellent piece of Open
 Source software) and updated for the Samba2.0 release by Jeremy
 Allison, email(samba-bugs@samba.anu.edu.au).
 
-See url(bf(samba (8)))(samba.7.html) to find out how to get a full
+See url(bf(samba (7)))(samba.7.html) to find out how to get a full
 list of contributors and details on how to submit bug reports,
 comments etc.
diff --git a/docs/yodldocs/smbtar.1.yo b/docs/yodldocs/smbtar.1.yo
new file mode 100644
index 00000000000..8ef8ef00c16
--- /dev/null
+++ b/docs/yodldocs/smbtar.1.yo
@@ -0,0 +1,126 @@
+mailto(samba-bugs@samba.anu.edu.au) 
+
+manpage(smbtar)(1)(23 Oct 1998)(Samba)(SAMBA)
+
+label(NAME)
+manpagename(smbtar)(shell script for backing up SMB/CIFS shares directly to UNIX tape drives)
+
+label(SYNOPSIS)
+manpagesynopsis()
+
+bf(smbtar) -s server [-p password] [-x service] [-X] [-d directory] [-u user] [-t tape] [-b blocksize] [-N filename] [-i] [-r] [-l log level] [-v] filenames
+
+label(DESCRIPTION)
+manpagedescription()
+
+This program is part of the bf(Samba) suite.
+
+bf(smbtar) is a very small shell script on top of
+url(bf(smbclient))(smbclient.1.html) which dumps SMB shares directly
+to tape.
+
+label(OPTIONS)
+manpageoptions()
+
+startdit()
+
+dit(bf(-s server)) The SMB/CIFS server that the share resides upon.
+
+dit(bf(-x service)) The share name on the server to connect
+to. The default is tt(backup).
+
+dit(bf(-X)) Exclude mode. Exclude filenames... from tar create or
+restore.
+
+dit(bf(-d directory)) Change to initial em(directory) before restoring
+/ backing up files.
+
+dit(bf(-v)) Verbose mode.
+
+dit(bf(-p password)) The password to use to access a share. Default:
+none
+
+dit(bf(-u user)) The user id to connect as. Default: UNIX login name.
+
+label(minust)
+dit(bf(-t tape)) Tape device. May be regular file or tape
+device. Default: em(TAPE) environmental variable; if not set, a file
+called tt(tar.out).
+
+dit(bf(-b blocksize)) Blocking factor. Defaults to 20. See bf(tar (1))
+for a fuller explanation.
+
+dit(bf(-N filename)) Backup only files newer than filename. Could be
+used (for example) on a log file to implement incremental backups.
+
+dit(bf(-i)) Incremental mode; tar files are only backed up if they
+have the archive bit set. The archive bit is reset after each file is
+read.
+
+dit(bf(-r)) Restore. Files are restored to the share from the tar
+file.
+
+dit(bf(-l log level)) Log (debug) level. Corresponds to the
+url(bf(-d))(smbclient.1.html#minus_d) flag of url(bf(smbclient
+(1)))(smbclient.1.html).
+
+enddit()
+
+label(ENVIRONMENT_VARIABLES)
+manpagesection(ENVIRONMENT VARIABLES)
+
+The TAPE variable specifies the default tape device to write to. May
+be overridden with the link(bf(-t))(minust) option.
+
+label(BUGS)
+manpagesection(BUGS)
+
+The bf(smbtar) script has different options from ordinary tar and tar
+called from url(bf(smbclient))(smbclient.1.html).
+
+label(CAVEATS)
+manpagesection(CAVEATS)
+
+Sites that are more careful about security may not like the way the
+script handles PC passwords. Backup and restore work on entire shares,
+should work on file lists. bf(smbtar) works best with GNU tar and may
+not work well with other versions.
+
+label(VERSION)
+manpagesection(VERSION)
+
+This man page is correct for version 2.0 of the Samba suite.
+
+label(SEEALSO)
+manpageseealso()
+
+url(bf(smbclient (1)))(smbclient.1.html), url(bf(smb.conf
+(5)))(smb.conf.5.html)
+
+label(DIAGNOSTICS)
+manpagesection(DIAGNOSTICS)
+
+See the url(bf(DIAGNOSTICS))(smbclient.1.html#DIAGNOSTICS) section for
+the url(bf(smbclient))(smbclient.1.html) command.
+
+label(AUTHOR)
+manpageauthor()
+
+The original Samba software and related utilities were created by
+Andrew Tridgell email(samba-bugs@samba.anu.edu.au). Samba is now developed
+by the Samba Team as an Open Source project similar to the way the
+Linux kernel is developed.
+
+Ricky Poulten email(poultenr@logica.co.uk) wrote the tar extension and
+this man page. The bf(smbtar) script was heavily rewritten and
+improved by Martin Kraemer email(Martin.Kraemer@mch.sni.de). Many
+thanks to everyone who suggested extensions, improvements, bug fixes,
+etc. The man page sources were converted to YODL format (another
+excellent piece of Open Source software) and updated for the Samba2.0
+release by Jeremy Allison, email(samba-bugs@samba.anu.edu.au).
+ 
+See url(bf(samba (7)))(samba.7.html) to find out how to get a full
+list of contributors and details on how to submit bug reports,
+comments etc.
+
+
diff --git a/docs/yodldocs/testparm.1.yo b/docs/yodldocs/testparm.1.yo
index 3cde640f79f..79ed611e424 100644
--- a/docs/yodldocs/testparm.1.yo
+++ b/docs/yodldocs/testparm.1.yo
@@ -89,6 +89,6 @@ sources were converted to YODL format (another excellent piece of Open
 Source software) and updated for the Samba2.0 release by Jeremy
 Allison, email(samba-bugs@samba.anu.edu.au).
 
-See url(bf(samba (8)))(samba.7.html) to find out how to get a full
+See url(bf(samba (7)))(samba.7.html) to find out how to get a full
 list of contributors and details on how to submit bug reports,
 comments etc.
diff --git a/docs/yodldocs/testprns.1.yo b/docs/yodldocs/testprns.1.yo
index 196729061e1..b76fc9f3c41 100644
--- a/docs/yodldocs/testprns.1.yo
+++ b/docs/yodldocs/testprns.1.yo
@@ -89,6 +89,6 @@ sources were converted to YODL format (another excellent piece of Open
 Source software) and updated for the Samba2.0 release by Jeremy
 Allison, email(samba-bugs@samba.anu.edu.au).
 
-See url(bf(samba (8)))(samba.7.html) to find out how to get a full
+See url(bf(samba (7)))(samba.7.html) to find out how to get a full
 list of contributors and details on how to submit bug reports,
 comments etc.