Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 14 additions & 2 deletions reference/conanfile/attributes.rst
Original file line number Diff line number Diff line change
Expand Up @@ -125,10 +125,22 @@ be computed. It can take three different values:
When ``scm`` or ``scm_folder`` is selected, the Git commit will be used, but by default
the repository must be clean, otherwise it would be very likely that there are uncommitted
changes and the build wouldn't be reproducible. So if there are dirty files, Conan will raise
an error. If there are files that can be dirty in the repo, but do not belong at all to the
recipe or the package, then it is possible to exclude them from the check with the ``core.scm:excluded``
an error.

If there are files that can be dirty in the repo, but do not belong at all to the
recipe or the package, then it is possible to exclude them from the check with the
``revision_mode_excluded`` recipe attribute or the ``core.scm:excluded``
configuration, which is a list of patterns (fnmatch) to exclude.

.. code-block:: python

from conan import ConanFile

class MyConsumer(ConanFile):

revision_mode = "scm"
# the .tmp files are excluded from revision and dirty check
revision_mode_excluded = ["*.tmp"]


upload_policy
Expand Down