.\" Man page generated from reStructuredText.
.
.TH "PLAINBOX-STARTPROVIDER" "1" "January 05, 2016" "0.25" "Plainbox"
.SH NAME
plainbox-startprovider \- create a new plainbox provider
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
plainbox startprovider [\-h] [\-\-empty] name
.ft P
.fi
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
Creates a new provider from a built\-in skeleton.
.sp
The name of the provider must follow the pattern \(ga\(gaYYYY.example.org:name\(ga\(ga
where \(ga\(gaYYYY\(ga\(ga is a four\-digit year when the author of the provider owned
the domain (here, \(ga\(gaexample.org\(ga\(ga) and \(ga\(ganame\(ga\(ga is arbitrary identifier
that is managed by the owner of that domain. The identifier should be
constrained to ASCII, digits and the dash character.

This naming scheme allows anyone that ever owned a domain name to come up
with non\-clashing provider identifiers. Those identifiers are going to be
used in fully qualified names of various objects.

This command creates a new skeleton test provider for PlainBox. The
generated content should be edited to fit a particular purpose.
.SH OPTIONS
.sp

\fBPositional arguments:\fP
.PP
.INDENT 0.0
.TP
.B
provider name, eg: YYYY.example.org:some\-name
.UNINDENT
.sp

\fBOptional arguments:\fP
.PP
.INDENT 0.0
.TP
.B \-\-empty
create an empty provider
.UNINDENT
.SH ABOUT NAMING PROVIDERS
.sp
Plainbox tries to be intuitive where possible but provider names keep causing
issues and make people struggle with coming up with correct and good names.
See \fBplainbox\-provider\-names\fP for a detailed discussion of provider names.
.SH AUTHOR
Zygmunt Krynicki & Checkbox Contributors
.SH COPYRIGHT
2012-2014 Canonical Ltd
.\" Generated by docutils manpage writer.
.