2f6834a234
ports. Given that you import port once but update it a few times, make the update mode (-CU) default for portcheck, and provide a "new port" switch (-N) instead. This commit updates portcheck(1) and portimport(1): code, documentation and tests. The WWW stuff will be updated separately. Note: regression suite fails now as it detected an actual misconsistence in portcheck's output. This will be handled ASAP, too. Initial prodding by naddy@
80 lines
2.4 KiB
Groff
80 lines
2.4 KiB
Groff
.\" $OpenBSD: portimport.1,v 1.4 2014/02/04 21:18:14 zhuk Exp $
|
|
.\"
|
|
.\" Copyright (c) 2013 Robert Peichaer
|
|
.\"
|
|
.\" Permission to use, copy, modify, and distribute this software for any
|
|
.\" purpose with or without fee is hereby granted, provided that the above
|
|
.\" copyright notice and this permission notice appear in all copies.
|
|
.\"
|
|
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
.\"
|
|
.Dd $Mdocdate: February 4 2014 $
|
|
.Dt PORTIMPORT 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm portimport
|
|
.Nd import a new port to the ports cvs repository
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl p Ar portsdir
|
|
.Op Fl u Ar username
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
is used to import the directories and files of a new port to the
|
|
.Ox
|
|
ports
|
|
.Xr cvs 1
|
|
repository, avoiding common mistakes.
|
|
It has to be executed from within the new port's directory.
|
|
.Pp
|
|
.Nm
|
|
calls the
|
|
.Xr portcheck 1
|
|
internally to verify that directory and file structure for a port is in
|
|
place and that no bogus files exist, and also to detect the
|
|
.Ev PKGPATH
|
|
for a port.
|
|
.Pp
|
|
The import is done in two steps.
|
|
In the first step, the
|
|
.Fl n
|
|
option of the cvs command is used to only check for possible problems
|
|
without changing anything and shows the cvs path where the new port will
|
|
be imported.
|
|
In the second step, the current ports directory is imported to the
|
|
.Ox
|
|
ports cvs repository.
|
|
After the import, the new port is checked out in the respective directory
|
|
of the local ports tree.
|
|
.Pp
|
|
The following options are available:
|
|
.Bl -tag -width Ds
|
|
.It Fl p Ar portsdir
|
|
Forces the given directory to be treated as ports root directory.
|
|
Passed through to
|
|
.Xr portcheck 1 .
|
|
.It Fl u Ar username
|
|
Set the username used for
|
|
.Xr ssh 1 ,
|
|
and to compose vendor and release tags.
|
|
Defaults to the local username.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr cvs 1 ,
|
|
.Xr portcheck 1 .
|
|
.Sh HISTORY
|
|
This command is based on the portimport script of Marc Espie, lightly
|
|
modified by Stuart Henderson and rewritten by Robert Peichaer.
|
|
Later, actual checks were moved to a separate utility,
|
|
.Xr portcheck 1 .
|
|
.Sh CAVEATS
|
|
The
|
|
.Ev CVSROOT
|
|
environment variable is not used.
|