diff -r 000000000000 -r 6f7a81934006 commands/vsetup.pod
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/commands/vsetup.pod	Wed Jan 16 22:39:43 2008 +0100
@@ -0,0 +1,60 @@
+=head1 NAME
+
+vsetup - Sets up a virtual domain for its first use
+
+=head1 SYNOPSIS
+
+B<vsetup>
+[B<--quiet>]
+
+
+=head1 DESCRIPTION
+
+This program sets up the basic set of necessary files needed to use an
+account as a virtual domain with vmailmgr.
+The users directory is created if it does not exist.
+A F<.qmail-default> file is created with the proper contents.
+If a F<.qmail-default> previously existed, it is renamed to
+F<.qmail-default~>.
+Three system aliases (C<root>, C<mailer-daemon>, and C<postmaster>)
+are created to point to the configured postmaster.
+
+
+=head1 OPTIONS
+
+=over 8
+
+=item B<--quiet>
+
+Suppress all status messages.
+
+=back
+
+=head1 RETURN VALUE
+
+
+0 if all files and directories are successfully created, 1 otherwise.
+
+
+
+=head1 SEE ALSO
+
+
+vdeliver(1), vmailmgrd(8)
+
+
+
+=head1 NOTES
+
+
+This program expects the environment variable C<HOME> to be set, and
+executes a change directory to the contents of it before starting.  It
+is also required that you change user to the domain owner before using
+these utilities.
+
+
+
+=head1 AUTHORS
+
+Bruce Guenter <bruceg@em.ca>
+