54 lines
1.5 KiB
Groff
54 lines
1.5 KiB
Groff
.TH "NPM\-UNPUBLISH" "1" "November 2019" "" ""
|
|
.SH "NAME"
|
|
\fBnpm-unpublish\fR \- Remove a package from the registry
|
|
.SS Synopsis
|
|
.P
|
|
.RS 2
|
|
.nf
|
|
npm unpublish [<@scope>/]<pkg>[@<version>]
|
|
.fi
|
|
.RE
|
|
.SS Warning
|
|
.P
|
|
\fBIt is generally considered bad behavior to remove versions of a library
|
|
that others are depending on!\fR
|
|
.P
|
|
Consider using the \fBdeprecate\fP command
|
|
instead, if your intent is to encourage users to upgrade\.
|
|
.P
|
|
There is plenty of room on the registry\.
|
|
.SS Description
|
|
.P
|
|
This removes a package version from the registry, deleting its
|
|
entry and removing the tarball\.
|
|
.P
|
|
If no version is specified, or if all versions are removed then
|
|
the root package entry is removed from the registry entirely\.
|
|
.P
|
|
Even if a package version is unpublished, that specific name and
|
|
version combination can never be reused\. In order to publish the
|
|
package again, a new version number must be used\. Additionally,
|
|
new versions of packages with every version unpublished may not
|
|
be republished until 24 hours have passed\.
|
|
.P
|
|
With the default registry (\fBregistry\.npmjs\.org\fP), unpublish is
|
|
only allowed with versions published in the last 72 hours\. If you
|
|
are trying to unpublish a version published longer ago than that,
|
|
contact support@npmjs\.com\|\.
|
|
.P
|
|
The scope is optional and follows the usual rules for npm help \fBscope\fP\|\.
|
|
.SS See Also
|
|
.RS 0
|
|
.IP \(bu 2
|
|
npm help deprecate
|
|
.IP \(bu 2
|
|
npm help publish
|
|
.IP \(bu 2
|
|
npm help registry
|
|
.IP \(bu 2
|
|
npm help adduser
|
|
.IP \(bu 2
|
|
npm help owner
|
|
|
|
.RE
|