Skip to content

Document when and why Conan skips binaries - #4584

Merged
czoido merged 4 commits into
conan-io:develop2from
AbrilRBS:ar/skipped-binaries-docs
Nov 20, 2026
Merged

czoido merged 4 commits into
conan-io:develop2from
AbrilRBS:ar/skipped-binaries-docs

Conversation

@AbrilRBS

@AbrilRBS AbrilRBS commented Nov 19, 2026 •

Copy link
Copy Markdown
Member

Add a new "Skipped binaries" page to the binary model reference explaining how Conan decides which dependency binaries are necessary, how skipping interacts with build modes (missing skipped binaries are not errors, --build=missing does not build them, forced builds always build), and how to disable it (tools.graph:skip_binaries, no_skip, package_type_traits).

Link it from the embed/non-embed package_id docs, requirement traits, build modes, generate() dependencies, deployers, tutorials showing "Skip" output, and add a FAQ entry.

image

For conan-io/conan#20540

AbrilRBS and others added 2 commits November 19, 2026 15:24
Add a new "Skipped binaries" page to the binary model reference explaining
how Conan decides which dependency binaries are necessary, how skipping
interacts with build modes (missing skipped binaries are not errors,
--build=missing does not build them, forced builds always build), and how
to disable it (tools.graph:skip_binaries, no_skip, package_type_traits).

Link it from the embed/non-embed package_id docs, requirement traits,
build modes, generate() dependencies, deployers, tutorials showing "Skip"
output, and add a FAQ entry.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@AbrilRBS AbrilRBS added this to the 2.35 milestone Nov 19, 2026
@AbrilRBS
AbrilRBS requested a review from memsharded November 19, 2026 14:34
@AbrilRBS AbrilRBS assigned czoido and unassigned memsharded Nov 19, 2026

@memsharded memsharded left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great


consumer -> direct-dep -> transitive-dep

.. list-table::

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Isn't it enough to refer to the "embed" and "non-embed" use cases for the package types (besides the tools and test requires)?


.. code-block:: bash

$ conan install --requires=app/0.1 -c tools.graph:skip_binaries=False

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add a reminder somewhere that -c:a would be necessary if we want to not skip binaries for tools and things in the build context

Replace the package-type table with a short mapping to the embed and
non-embed cases from the dependencies page, and make it explicit that
-c only applies to the host context, so -c:a is needed to avoid skipping
build context binaries too.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Carlos Zoido <mrgalleta@gmail.com>
@czoido
czoido merged commit d511455 into conan-io:develop2 Nov 20, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants