Update documentation about use of NATVIS

The docs were still talking about Visual Studio 2013, which we've not
supported in a while.

I made the documentation a bit more vague because NATVIS is sometimes
automatically picked up when building and sometimes requires manually
installing the files. (For me, LLVM NATVIS is automatically picked up
while Clang NATVIS needs manual installation; this happens because the
way the monorepo is organized causes confusion when used with Visual
Studio's built-in CMake functionality. Building from a .sln file
generated by CMake may have better behavior in this case.)
This commit is contained in:
Aaron Ballman 2023-07-31 12:24:00 -04:00
parent 17ecb55da5
commit 691b855b0e

View File

@ -3,7 +3,7 @@
<!-- Material used from: HTML 4.01 specs: http://www.w3.org/TR/html401/ -->
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Hacking on clang</title>
<link type="text/css" rel="stylesheet" href="menu.css">
<link type="text/css" rel="stylesheet" href="content.css">
@ -104,11 +104,12 @@
<a href="https://github.com/llvm/llvm-project/blob/main/clang/utils/ClangVisualizers/clang.natvis">
<tt>clang/utils/ClangVisualizers/clang.natvis</tt></a> provide debugger visualizers
that make debugging of more complex data types much easier.</p>
<p>For Visual Studio 2013 only, put the files into
<tt>%USERPROFILE%\Documents\Visual Studio 2013\Visualizers</tt> or
create a symbolic link so they update automatically.</p>
<p>For later versions of Visual Studio, no installation is required.
Note also that later versions of Visual Studio also display better visualizations.</p>
<p>Depending on how you configure the project, Visual Studio may automatically
use these visualizers when debugging or you may be required to put the files
into <tt>%USERPROFILE%\Documents\Visual Studio &lt;version&gt;\Visualizers</tt>
or create a symbolic link so they update automatically. See
<a href="https://learn.microsoft.com/en-us/visualstudio/debugger/create-custom-views-of-native-objects">
Microsoft's documentation</a> for more details on use of NATVIS.</p>
<!--=====================================================================-->
<h2 id="testing">Testing</h2>