forked from r-lib/usethis
-
Notifications
You must be signed in to change notification settings - Fork 0
/
licenses.Rd
92 lines (78 loc) · 2.98 KB
/
licenses.Rd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/license.R
\name{licenses}
\alias{use_mit_license}
\alias{use_gpl_license}
\alias{use_agpl_license}
\alias{use_lgpl_license}
\alias{use_apache_license}
\alias{use_cc0_license}
\alias{use_ccby_license}
\alias{use_proprietary_license}
\alias{use_gpl3_license}
\alias{use_agpl3_license}
\alias{use_apl2_license}
\title{License a package}
\usage{
use_mit_license(copyright_holder = NULL)
use_gpl_license(version = 3, include_future = TRUE)
use_agpl_license(version = 3, include_future = TRUE)
use_lgpl_license(version = 3, include_future = TRUE)
use_apache_license(version = 2, include_future = TRUE)
use_cc0_license()
use_ccby_license()
use_proprietary_license(copyright_holder)
}
\arguments{
\item{copyright_holder}{Name of the copyright holder or holders. This
defaults to "{package name} authors"; you should only change this if you
use a CLA to assign copyright to a single entity.}
\item{version}{License version. This defaults to latest version all licenses.}
\item{include_future}{If \code{TRUE}, will license your package under the current
and any potential future versions of the license. This is generally
considered to be good practice because it means your package will
automatically include "bug" fixes in licenses.}
}
\description{
Adds the necessary infrastructure to declare your package as licensed
with one of these popular open source licenses:
Permissive:
\itemize{
\item \href{https://choosealicense.com/licenses/mit/}{MIT}: simple and permissive.
\item \href{https://choosealicense.com/licenses/apache-2.0/}{Apache 2.0}: MIT +
provides patent protection.
}
Copyleft:
\itemize{
\item \href{https://choosealicense.com/licenses/gpl-2.0/}{GPL v2}: requires sharing
of improvements.
\item \href{https://choosealicense.com/licenses/gpl-3.0/}{GPL v3}: requires sharing
of improvements.
\item \href{https://choosealicense.com/licenses/agpl-3.0/}{AGPL v3}: requires sharing
of improvements.
\item \href{https://choosealicense.com/licenses/lgpl-2.1/}{LGPL v2.1}: requires sharing
of improvements.
\item \href{https://choosealicense.com/licenses/lgpl-3.0/}{LGPL v3}: requires sharing
of improvements.
}
Creative commons licenses appropriate for data packages:
\itemize{
\item \href{https://creativecommons.org/publicdomain/zero/1.0/}{CC0}: dedicated
to public domain.
\item \href{https://creativecommons.org/licenses/by/4.0/}{CC-BY}: Free to share and
adapt, must give appropriate credit.
}
See \url{https://choosealicense.com} for more details and other options.
Alternatively, for code that you don't want to share with others,
\code{use_proprietary_license()} makes it clear that all rights are reserved,
and the code is not open source.
}
\details{
CRAN does not permit you to include copies of standard licenses in your
package, so these functions save the license as \code{LICENSE.md} and add it
to \code{.Rbuildignore}.
}
\seealso{
For more details, refer to the the
\href{https://r-pkgs.org/license.html}{license chapter} in \emph{R Packages}.
}