=head1 NAME

/etc/extrepo/config.yaml - config file for extrepo

=head1 SYNOPSIS

    url: https://extrepo-team.pages.debian.net/extrepo-data
    dist: debian
    version: bookworm
    enabled_policies:
    - main
    tor: auto

=head1 DESCRIPTION

The file /etc/extrepo/config.yaml allows to configure options for
extrepo. It is a simple YAML file that is parsed with YAML::XS (i.e.,
libyaml); so any formatting options that are supported by that
implementation will be supported by the extrepo config file.

=head1 OPTIONS

The following options are supported:

=over

=item url

The URL where extrepo will download metadata from. This should usually
be left to its default of
L<https://extrepo-team.pages.debian.net/extrepo-data>. However, if the
system is behind a firewall, it may be necessary to use a local mirror
or reverse proxy for the extrepo-data repository. In that case, fill out
the URL for that mirror or reverse proxy here.

=item dist

It is foreseen that perhaps some downstream distributions of Debian may
want to add support for their own extrepo configuration. In that case,
they would use a different distribution name for this configuration
item.

Currently, however, the only supported value for this configuration
option is C<debian>.

=item version

The codename of the distribution that you are using. Supported values
here include all active code names for Debian, although the extrepo
program itself is only supported from Debian buster onwards.

=item enabled_policies

The package licensing policies that are enabled for this system. By
default, only the "main" policy is enabled. This policy requires that
all packages in the distribution adhere to the Debian Free Software
Guidelines, or DFSG, and that software in such a repository may only
depend on other repositories that have "main" as a policy, as in
Debian's "main" repository.

Additional valid options for this key are "contrib", which requires that
licenses for software in the repository also adhere to the DFSG (but
makes no such requirements on any dependencies), and "non-free", which
has no restrictions whatsoever.

While every effort is made that software repositories are labelled
correctly, the maintainers of the extrepo-data repository make no
guarantee as to its correctness.

=item tor

The default tor mode to be used for installed repositories. If not
specified, defaults to "off". Can be overridden with the C<--tor> option
to the extrepo command; see the documentation of that option in
L<extrepo(1)> for a list of the valid options here.

=back

=head1 SEE ALSO

L<extrepo(1)>

=head1 AUTHOR

Wouter Verhelst
