.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'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 >0, 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.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "SETUPDISTARCH 1"
.TH SETUPDISTARCH 1 2023-07-25 "perl v5.38.0" "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
setupdistarch \- Script to set CPANPLUS::Dist::Arch as the default packager for CPANPLUS
.SH SYNOPSIS
.IX Header "SYNOPSIS"
Run this script from your command shell to set CPANPLUS to package all
modules through CPANPLUS::Dist::Arch by default or to disable
automatic packaging in CPANPLUS.  setupdistarch also turns on recursive
package installation and warns if sudo is not installed.
.PP
.Vb 3
\&  $ setupdistarch
\&  Are you sure you want to auto\-package CPAN installs? [Yn] 
\&  CPANPLUS will now auto\-package modules.
\&
\&  $ setupdistarch \-\-force
\&  CPANPLUS will now auto\-package modules.
\&
\&  $ setupdistarch \-\-remove \-\-force
\&  CPANPLUS will no longer auto\-package modules.
\&
\&  $ setupdistarch \-h
\&  (Displays this usage information.)
.Ve
.PP
DO NOT run this script with sudo or your configuration file will now
be owned by root.
.SH OPTIONS
.IX Header "OPTIONS"
.IP "\fB\-h, \-\-help\fR" 4
.IX Item "-h, --help"
Print a brief help message and exit.
.IP "\fB\-m, \-\-man\fR" 4
.IX Item "-m, --man"
Prints the manual page and exists.
.IP "\fB\-r, \-\-remove\fR" 4
.IX Item "-r, --remove"
Configures CPANPLUS to not use any packager when installing modules.
.IP "\fB\-f, \-\-force\fR" 4
.IX Item "-f, --force"
Forces the changes to CPANPLUS configuration without prompting for
confirmation.  Might be useful when running as root uninteractively,
for example.
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This script was created to make setting up or disabling
CPANPLUS::Dist::Arch a little easier.  Without using the force
option, the user must confirm they want to change CPANPLUS's
configuration.
.PP
If you run this script as root, it will change the \fBSYSTEM-WIDE\fR
default for all CPANPLUS users.  A warning message is displayed
when run as root.
.SH TROUBLESHOOTING
.IX Header "TROUBLESHOOTING"
.IP \fBsudo\fR 4
.IX Item "sudo"
DO NOT run this script with sudo or your CPANPLUS configuration file
will become owned by root.  To change it back, use sudo and chown
on your configuration file.  For example:
.Sp
.Vb 1
\&  sudo chown <yourname>.<yourgroup> ~/.cpanplus/lib/CPANPLUS/Config/User.pm
.Ve
.IP \fBPATH\fR 4
.IX Item "PATH"
\&\fIThis problem has been fixed in recent versions of Archlinux.\fR
.Sp
Archlinux currently installs binaries from perl modules (like this one
here) under the \f(CW\*(C`/usr/bin/perlbin/vendor\*(C'\fR directory.  Make sure this
is in your PATH environment variable if you are not typing the entire
path.
.Sp
To the perl binary directories to your runtime PATH add something like
the following to your /home/(username)/.profile file:
.Sp
.Vb 1
\&  export PATH=/bin:/usr/bin:/usr/bin/perlbin/core:/usr/bin/perlbin/vendor
.Ve
.SH AUTHOR
.IX Header "AUTHOR"
Created by: Justin Davis \f(CW\*(C`<juster at cpan dot org>\*(C'\fR
.PP
Serendipitously maintained by: John D Jones III \f(CW\*(C`<jnbek at cpan dot org>\*(C'\fR
.SH "COPYRIGHT & LICENSE"
.IX Header "COPYRIGHT & LICENSE"
Copyright 2010\-2015 Justin Davis, all rights reserved.
.PP
Copyright 2015 John D Jones III, all rights reserved
.PP
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.