mesonbuild/meson

Document `ninja reconfigure` in the online documentation

Open

#2409 opened on Oct 1, 2017

View on GitHub
 (4 comments) (0 reactions) (0 assignees)Python (4,978 stars) (1,465 forks)batch import
documentationhelp wanted

Description

After the build dir is created, I can change meson files or options and running ninja will reconfigure if required then build. My project checks that various options are compatible and prints a summary of the build configuration. I would like to be able to perform a reconfigure with out building so I can see the configuration summary before I decide if I want to build the project.

Even better would be the way cmake does it. I can change run "cmake .. -Dopt=var" in my build dir and it prints out my build summary. It seems to figure out how to only reconfigure what has changed instead of reconfiguring everything then prints out the summary. I assume all messages not inside a if statement are getting printed.

Contributor guide

Tech stack
python
Domain
build systemcli
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Basic knowledge of Meson build system
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
75
Research direction
Locate the documentation directory (likely 'docs/' or 'docs/markdown/') and find where similar commands are documented. Add a new page or section for 'ninja reconfigure' explaining its usage, options, and when to use it. Check if there are any existing partial docs or related issues for guidance.