openbsd-ports/infrastructure/man/man1/portimport.1

67 lines
2.2 KiB
Groff
Raw Normal View History

.\" $OpenBSD: portimport.1,v 1.1 2013/04/09 19:51:37 rpe 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: April 9 2013 $
.Dt PORTIMPORT 1
.Os
.Sh NAME
.Nm portimport
.Nd import a new port to the ports cvs repository
.Sh SYNOPSIS
.Nm portimport
.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
verifies that a minimal directory and file structure for a port is in
place and that no bogus files exist.
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.
.Sh SEE ALSO
.Xr cvs 1
.Sh HISTORY
This command is based on the portimport script of Marc Espie, lightly
modified by Stuart Henderson and rewritten by Robert Peichaer.
.Sh CAVEATS
The
.Ev CVSROOT
environment variable is not used.
.Sh BUGS
The login name of the current user is used for the
.Xr ssh 1
connection to the
.Ox
cvs server, to compose the vendortag and the releasetag.
The value of the
.Va user
variable has to be changed in the sourcecode if a different login name is
used to connect to the cvs server.