ebuild: fetch: Flatten conditionals in _get_fetch_resume_size
[portage.git] / man / quickpkg.1
index a4030676d6e4885b41594d6a65d146c241959eca..a3f6165e4832b91907b849f83a3757f2cbadfcce 100644 (file)
@@ -1,32 +1,47 @@
-.TH "QUICKPKG" "1" "Jul 2003" "Portage 2.0.51" "Portage"
+.TH "QUICKPKG" "1" "Dec 2012" "Portage VERSION" "Portage"
 .SH NAME
 quickpkg \- creates portage packages
 .SH SYNOPSIS
-.B quickpkg <list of pkgs>
+.B quickpkg [options] <list of packages or package\-sets>
 .SH DESCRIPTION
 .I quickpkg
 can be utilized to quickly create a package for portage by
 utilizing the files already on your filesystem.  This package
-then can be emerged on any system.  To review syntax for 
+then can be emerged on any system.  To review syntax for
 emerging binary packages, review \fBemerge\fR(1).  The upside
-of this process is that you don't have to wait for the package 
-to unpack, configure, compile, and install before you can have 
-the package ready to go.  The downside is that the package will 
-contain the files that exist on your filesystem even if they have 
+of this process is that you don't have to wait for the package
+to unpack, configure, compile, and install before you can have
+the package ready to go.  The downside is that the package will
+contain the files that exist on your filesystem even if they have
 modified since they were first installed.
 .br
-The packages, after being created, will be placed in \fBPKGDIR\fR.  
-This variable is defined in \fBmake.conf\fR(5) and defaults to 
-/var/tmp/portage-pkg.
+The packages, after being created, will be placed in \fBPKGDIR\fR.
+This variable is defined in \fBmake.conf\fR(5) and defaults to
+/usr/portage/packages.
 .SH OPTIONS
 .TP
-.B <list of packages>
+.B <list of packages or package\-sets>
 Each package in the list can be of two forms.  First you can
 give it the full path to the installed entry in the virtual
-database.  That is, /var/db/pkg/<CATEGORY>/<PKG-VERSION>/.  
-The second form is a portage depend atom.  This atom is of
-the same form that you would give \fBemerge\fR if you wanted 
-to emerge something.  See \fBebuild\fR(5) for full definition.
+database.  That is, /var/db/pkg/<CATEGORY>/<PKG-VERSION>/.
+The second form is a portage depend atom or a portage package
+set.  The atom or set is of the same form that you would give
+\fBemerge\fR if you wanted to emerge something.
+See \fBebuild\fR(5) for full definition.
+.TP
+.BR "\-\-ignore\-default\-opts"
+Causes the \fIQUICKPKG_DEFAULT_OPTS\fR environment variable to be ignored.
+.TP
+.BR "\-\-include\-config < y | n >"
+Include all files protected by CONFIG_PROTECT (as a security precaution,
+default is 'n').
+.TP
+.BR "\-\-include\-unmodified\-config < y | n >"
+Include files protected by CONFIG_PROTECT that have not been modified
+since installation (as a security precaution, default is 'n').
+.TP
+.BR \-\-umask=UMASK
+The umask used during package creation (default is 0077).
 .SH "EXAMPLES"
 .B quickpkg
 /var/db/pkg/dev-python/pyogg-1.1
@@ -39,18 +54,20 @@ planeshift
 .br
 .B quickpkg
 =net-www/apache-2*
+.br
+.B quickpkg
+@system
 .SH "REPORTING BUGS"
 Please report bugs via http://bugs.gentoo.org/
-.SH "SEE ALSO"
-.BR ebuild (5),
-.BR make.conf (5)
-.SH "FILES"
-.TP
-.B /etc/make.conf
-The \fBPKGDIR\fR variable is defined here.
 .SH AUTHORS
+.nf
 Terry Chan (original author)
-.br
 Mike Frysinger <vapier@gentoo.org> (revamped version)
-.SH "CVS HEADER"
-$Id: /var/cvsroot/gentoo-src/portage/man/quickpkg.1,v 1.3 2004/09/17 00:17:10 vapier Exp $
+.fi
+.SH "FILES"
+.TP
+.B /etc/portage/make.conf
+The \fBPKGDIR\fR variable is defined here.
+.SH "SEE ALSO"
+.BR ebuild (5),
+.BR make.conf (5)