Skip to content

Commit c92e57f

Browse files
FrostyXpraiskup
authored andcommitted
doc: document manual createrepo feature
Fix #908
1 parent 9ac8907 commit c92e57f

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

doc/user_documentation.rst

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -563,6 +563,27 @@ only in Copr and ignored by Koji. It is easy to do::
563563
%endif
564564

565565

566+
Creating repositories manually
567+
------------------------------
568+
569+
After a build is finished, Copr automatically adds its results to the project RPM
570+
repository. When maintaining a large software stack consisting of hundreds of
571+
packages (e.g. KDE or Gnome), it may be useful to disable this feature and
572+
create repositories manually. That way you can atomically move your repository
573+
from one consistent state to another.
574+
575+
In such case, after a build is finished, Copr adds the results only to an
576+
internal ``devel/repodata`` repository. It's results are not available to
577+
users but the repository is enabled for all subsequent builds in the project.
578+
Once you are ready to publish the changes to users, click the
579+
"Regenerate Repositories" button in your project overview.
580+
581+
Please note that there are some historical inconsistencies in the naming of this
582+
feature. There is a "Create repositories manually" checkbox in the project
583+
settings, ``copr-cli create --disable_createrepo`` in CLI, and ``devel_mode`` in
584+
the API. They are all the same feature.
585+
586+
566587
Modularity
567588
----------
568589

0 commit comments

Comments
 (0)