.\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "GRIP-OVERRIDEREPLACE 1"
.TH GRIP-OVERRIDEREPLACE 1 "2011-03-27" "perl v5.12.3" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
grip\-overridereplace.pl \- refresh a package to enact an override
.SH "Synopsis"
.IX Header "Synopsis"
.Vb 2
\& grip\-overridereplace.pl \-s|\-\-suite STRING \-b|\-\-base\-path PATH [\-c|\-\-component COMPONENT] [\-\-grip\-name STRING] BINARIES ...
\& grip\-overridereplace.pl \-?|\-h|\-\-help|\-\-version
\&
\& Commands:
\& \-s|\-\-suite STRING:        Name of the distribution to override [required]
\& \-b|\-\-base\-path PATH:      path to the top level repository directory [required]
\&
\& \-?|\-h|\-\-help|\-\-version:   print this help message and exit
\&
\& Options:
\&    \-\-grip\-name STRING:    alternative name for the grip repository
\& \-c|\-\-component COMPONENT: Section override from the Debian Packages file.
.Ve
.PP
Only the specified binary package(s) will be affected, each architecture
in turn. Packages are copied out of pool/ into a temporary directory,
removed and then replaced into the architecture concerned.
.PP
Overrides take place in the Packages file, not within the binary package
itself \- check the results by parsing the relevant Packages file, not
using the output of dpkg \-I \f(CW$deb\fR or other .deb tools.
.PP
Note that overrides will need to be enacted for the versions in testing
as well, so repeat the process once you are happy with the effects.
.PP
Components that are supported by reprepro are read from the .deb Section
field but this can sometimes be out of step with the Section set by the
Debian ftp-master in the Packages file. Use the \f(CW\*(C`\-\-component\*(C'\fR option to
set a particular Section. If the relevant component has not been 
configured in reprepro for the Section name, \f(CW\*(C`main\*(C'\fR will be used
instead.
.SH "Description"
.IX Header "Description"
Overrides need to be updated from time to time so this script provides
a way to implement overrides restrospectively.
.PP
Section / component overrides are read from the filter repository
Packages file  \- use the \f(CW\*(C`\-\-component\*(C'\fR option to set other values. If
the component has not been configured in reprepro, \f(CW\*(C`main\*(C'\fR is used
instead.
.SH "Override usage with reprepro"
.IX Header "Override usage with reprepro"
Sections are not particularly reliable and may disappear completely in
future releases of Debian. Some packages are in the wrong sections and
will cause problems for users if left unchanged. One example is
\&\f(CW\*(C`xulrunner\-1.9\*(C'\fR which is an important dependency of iceweasel (the
Debian flavour of Firefox) but xulrunner\-1.9 is \f(CW\*(C`Section: devel\*(C'\fR for
an unknown reason. To prevent the need for every Grip user to need the
\&\f(CW\*(C`dev\*(C'\fR repository to get a working web browser, an override is set in
the reprepro configuration. (See reprepro (1)).
.PP
Add the name of the override file to the distribution by editing
\&\fIconf/distributions\fR:
.PP
.Vb 6
\& Origin: Debian
\& Label: EmdebianGrip
\& Suite: unstable
\& Codename: sid
\& ...
\& DebOverride: override.sid.main
.Ve
.PP
In the override file, set a more usable Section:
.PP
.Vb 2
\& xulrunner\-1.9 Section web
\& geany Section editors
.Ve
.PP
It's worth setting a real Section (rather than assuming \f(CW\*(C`main\*(C'\fR) in
case that component is added at a later date.
.PP
grip\-overridereplace.pl will then use that override to allow the
package to be moved back from \f(CW\*(C`dev\*(C'\fR into \f(CW\*(C`main\*(C'\fR and \fIreprepro\fR
will use the override file for future updates.
.SH "Copyright and Licence"
.IX Header "Copyright and Licence"
.Vb 1
\& Copyright (C) 2007\-2009  Neil Williams <codehelp@debian.org>
\&
\& This package is free software; you can redistribute it and/or modify
\& it under the terms of the GNU General Public License as published by
\& the Free Software Foundation; either version 3 of the License, or
\& (at your option) any later version.
\& 
\& This program is distributed in the hope that it will be useful,
\& but WITHOUT ANY WARRANTY; without even the implied warranty of
\& MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
\& GNU General Public License for more details.
\& 
\& You should have received a copy of the GNU General Public License
\& along with this program.  If not, see <http://www.gnu.org/licenses/>.
.Ve
