Clarrify folder layout

Open Beginner friendly
#4,407 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
64/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Quiet
Tech stack
macos

Research direction

Open reference/tools/apple/xcodedeps.rst around lines 50-53 and read how the layout option affects XCodeDeps output. Clarify the relationship between generic_layout, the deps/tools setup, and the generated conandeps.xcconfig files for each build type and architecture. Done means the documentation explains why a multi-config or per-configuration layout is produced.

Written by the indexing model from the issue text.

Description

In configuring the MacOS XCode build, for some reason I had chosen to set/change the layout to a generic_layout.

I've only just come to understand that this was changing the management of XCodeDeps config forcing the xcconfig generation into different folders so that it was not preparing a multi config a described

https://github.com/conan-io/docs/blob/787931818bd07e98d765d5488dc5276488193c0d/reference/tools/apple/xcodedeps.rst?plain=1#L50-L53

Looking at the XCodeDeps doc, it was not clear at this point why the generate one single file (*conandeps.xcconfig*) aggregating all the files for the direct dependencies was not creating the single file instead creating 1 in each build_type and arch.

It may be helpful to others to understand this link between layout and the deps/tools setup

Dominant language
C++
Stars
125
Forks
382
Avg merge
22h 39m
Merged PRs (30d)
21

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from conan-io/docs

All issues in conan-io/docs

Similar issues

More C++ issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.