Default behaviour for yaml-cpp install targets missing in README

Open
#1,381 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

  • #1439 by @wyf027 — closed without merging

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
35/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Stale
Tech stack
cmake, cpp
Domain
documentation

Research direction

Read the README section “How to integrate it within your project using CMake” and compare its instructions with the install option changed in PR #1007. Add a note explaining when to set option(YAML_CPP_INSTALL ON); done means the README makes this requirement clear for projects that fetch yaml-cpp as a subproject.

Written by the indexing model from the issue text.

Description

documentation enhancement help wanted

I struggled a lot to find out why the targets for yaml-cpp did not get installed, when fetching them like described in the README in the CMakeLists.txt of my own project.

Now I found out, that in this PR (https://github.com/jbeder/yaml-cpp/pull/1007) it was changed to not be always ON by default to install the targets.

It would probably be really helpful to add a small comment to the README under the section 'How to integrate it within your project using CMake' that it could be necessary to add option(YAML_CPP_INSTALL ON) if yaml-cpp is not the top project, because it could save time for other developers as this feels like a pretty standard use case.

If you agree it would be nice to add this.

Dominant language
C++
Stars
6.1k
Forks
2.2k
Avg merge
22h 2m
Merged PRs (30d)
1

Getting set up

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 jbeder/yaml-cpp

All issues in jbeder/yaml-cpp

Similar issues

More C++ issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.