From d3e538eabbb329dcff86ea740a056964b0e2800d Mon Sep 17 00:00:00 2001 From: Brad King Date: Tue, 21 Jun 2016 09:31:42 -0400 Subject: [PATCH] Help: Clarify VS_STARTUP_PROJECT documentation Explain in what directory the property should be set to affect the corresponding ``.sln`` file. Suggested-by: Stephen Kelly --- Help/prop_dir/VS_STARTUP_PROJECT.rst | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/Help/prop_dir/VS_STARTUP_PROJECT.rst b/Help/prop_dir/VS_STARTUP_PROJECT.rst index edd483243..04441b621 100644 --- a/Help/prop_dir/VS_STARTUP_PROJECT.rst +++ b/Help/prop_dir/VS_STARTUP_PROJECT.rst @@ -3,10 +3,16 @@ VS_STARTUP_PROJECT Specify the default startup project in a Visual Studio solution. +The :ref:`Visual Studio Generators` create a ``.sln`` file for each directory +whose ``CMakeLists.txt`` file calls the :command:`project` command. Set this +property in the same directory as a :command:`project` command call (e.g. in +the top-level ``CMakeLists.txt`` file) to specify the default startup project +for the correpsonding solution file. + The property must be set to the name of an existing target. This will cause that project to be listed first in the generated solution file causing Visual Studio to make it the startup project if the solution has never been opened before. -If this property is not specified, then the "ALL_BUILD" project +If this property is not specified, then the ``ALL_BUILD`` project will be the default.