Paludis Logo Introduction   accounts unwritten
Bugs, Requests, Support   ebuild and exheres VDB
Overview   exndbam  
FAQ   installed_accounts  
Clients   installed_unpackaged  
Configuration repositories/ repository  
API   unavailable  

repository Repository Format

The repository repository format is used to automatically create configuration files for new repositories whose information is published in unavailable format repositories, which can be installed using packages named like repository/foo. It is supported on Exherbo and Gentoo.

As well as the general keys supported for all repositories, the following keys have meaning for repository format repositories:

config_template
The template file to use when creating configuration files. Mandatory. Most users will want to set this to /etc/paludis/repository.template, which will then need to be created as described below.
config_filename
The filename to use when creating configuration files. Most users will want to set this to /etc/paludis/repositories/%{repository_template_name}.conf (note the %, which is not a $).

Repository Template

On Gentoo, a typical /etc/paludis/repository.template will look like:

format = %{repository_template_format}
location = /var/db/paludis/repositories/%{repository_template_name}
sync = %{repository_template_sync}
master_repository = gentoo

Note that after a repository is 'installed', it may be necessary to remove the master_repository line from the generated repository configuration if a repository specifies its own masters via layout.conf. Paludis will issue a warning when this is necessary.

On Exherbo, a typical /etc/paludis/repository.template will look like:

format = %{repository_template_format}
location = /var/db/paludis/repositories/%{repository_template_name}
sync = %{repository_template_sync}

There is no need to specify a master_repository, since all Exherbo repositories specify their own masters.

In both cases, note again the % variables. Percent variables are replaced when creating the repository template file; variables using the conventional dollar syntax are written without substitution to the configuration file.