=head1 NAME

Mozilla::Persona::Setup - setup a persona server

=head1 INHERITANCE

 Mozilla::Persona::Setup
   is a Exporter

=head1 SYNOPSIS

  # command-line script
  persona setup <options>

  # or from your own program
  use Mozilla::Persona::Setup 'setup_persona';

=head1 DESCRIPTION

This module organizes the server-side Persona adminstration, with
a few helpers which can have alternative implementations.

=head1 Functions

=over 4

=item B<setup_persona>(OPTIONS)

 -Option --Default
  docroot  <required>
  domain   <required>
  group    <required>
  restart  <false>
  secrets  <required>

=over 2

=item docroot => DIRECTORY

Location of the website's files.

=item domain => DOMAIN

Which domain we are serving.

=item group => USERNAME

The groupname used by the webserver, to set permissions correctly.

=item restart => BOOLEAN

Whether to overwrite existing configuration files.

=item secrets => DIRECTORY

Where can we put the secrets in a save way?  Not under docroot!

=back

=back

=head1 SEE ALSO

This module is part of Mozilla-Persona distribution version 0.12,
built on November 22, 2012. Website: F<http://perl.overmeer.net>.  The code is based on the MulkyID code by
Matthias Benkard.

Persona is described at F<http://www.mozilla.org/persona/>

=head1 COPYRIGHTS

Copyrights of the perl code and the related documentation by
2012 by [Mark Overmeer]. For other contributors see ChangeLog.

This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
See F<http://www.perl.com/perl/misc/Artistic.html>

