.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH ND-CONFIGUREREPO "1" "September 2023" "nd-configurerepo 0.1" "User Commands"
.SH NAME
nd-configurerepo \- configure APT to use NeuroDebian repository
.SH SYNOPSIS
.B nd-configurerepo
[\fI\,options\/\fR]
.SH DESCRIPTION
Enables NeuroDebian repository for the current Debian or Ubuntu release.
.SH OPTIONS
.HP
\fB\-r\fR, \fB\-\-release\fR=\fI\,RELEASE\/\fR
.IP
Name of the Debian/Ubuntu release to be used. If not specified,
it is deduced from the 'apt\-cache policy' output, by taking repository
of Debian or Ubuntu origin with highest priority.
.HP
\fB\-\-print\-releases\fR
.IP
Print a list of releases present in NeuroDebian repository.
.HP
\fB\-\-print\-release\fR
.IP
Print the release deduced from the output of apt\-cache policy.
.HP
\fB\-f\fR, \fB\-\-flavor\fR=\fI\,full\/\fR|libre
.IP
Which flavor of the repository should be enabled:
.TP
libre
Only 'main' component, containing only DFSG\-compliant content.
.TP
full
Includes 'main', 'contrib', and 'non\-free'.
.IP
If not specified \fB\-\-\fR deduced from the output of apt\-cache policy.
.HP
\fB\-\-print\-flavor\fR
.IP
Print the flavor deduced from the output of apt\-cache policy.
.HP
\fB\-c\fR, \fB\-\-components\fR=\fI\,c1\/\fR,c2,c3
.IP
Comma separated list of components to enable among:
.TP
software
primary software repository
.TP
data
data packages
.TP
devel
"overlay" of development versions (like Debians' "experimental").
Not sufficient on its own and available only from the main site
.IP
If not specified \fB\-\-\fR "software,data"
.HP
\fB\-m\fR, \fB\-\-mirror\fR=\fI\,NAME\/\fR|URL
.IP
Which mirror to use. Could be a mirror code\-name (as specified in
\fI\,/etc/neurodebian/neurodebian.cfg\/\fP), or a URL.
.HP
\fB\-\-print\-mirrors\fR
.IP
Return a list (with abbreviation) of known NeuroDebian mirrors.
.HP
\fB\-\-overwrite\fR,
.IP
If apt file already present, it would not be overridden (by default).
Use this option to overwrite.
.HP
\fB\-\-suffix\fR=\fI\,SUFFIX\/\fR
.IP
Which suffix to add to the apt file, in case you are trying to enable
multiple repositories
.HP
\fB\-\-sources\fR, \fB\-\-no\-sources\fR
.IP
Either to enable deb\-src lines. If none specified \fB\-\-\fR would be enabled if
sources for a core package (apt) are available.
.HP
\fB\-n\fR, \fB\-\-dry\-run\fR
.IP
Do not perform any changes \fB\-\-\fR generated configurations and commands will
simply be printed to stdout
.HP
\fB\-\-install\fR
.IP
If found absent, all necessary tools (wget, netselect) if available will
be apt\-get installed
.HP
\fB\-v\fR, \fB\-\-verbose\fR
.IP
Enable additional progress messages. Could be used multiple times
.HP
\fB\-q\fR, \fB\-\-quiet\fR
.IP
Make operation quiet \fB\-\-\fR only error messages would be output
.HP
\fB\-h\fR, \fB\-\-help\fR
.IP
Print short description, usage summary and option list.
.HP
\fB\-\-version\fR
.IP
Print version information and exit.
.PP
Exit status:
.IP
non\-0 exit status in case of error.
Error exit code would depend on which command has failed.
.SH EXAMPLES
.IP
nd\-configurerepo
.IP
Enable software and data components from the optimal (according to
netselect) mirror.  Some information about progress will be printed
.IP
nd\-configurerepo \-q \-\-suffix=\-devel \-c devel
.IP
Quietly enable \-devel repository for the current release, and place apt
configuration into /etc/apt/sources.list.d/neurodebian.sources\-devel.list
.IP
nd\-configurerepo \-q \-\-suffix=\-de\-sid\-full \-c software,data,devel \-m jp
.IP
Force sid distribution, all the components, from the Japan mirror
.SH AUTHOR
Written by Yaroslav Halchenko for the NeuroDebian project.
.SH COPYRIGHT
Copyright \(co 2014\-2023 Yaroslav Halchenko <debian@onerussian.com>
.PP
Licensed under GNU Public License version 3 or later.
.br
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.