{"id":32338,"date":"2023-06-13T21:52:38","date_gmt":"2023-06-13T21:52:38","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/cppblog\/?p=32338"},"modified":"2023-06-14T17:45:57","modified_gmt":"2023-06-14T17:45:57","slug":"improved-doxygen-overload-resolution","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/cppblog\/improved-doxygen-overload-resolution\/","title":{"rendered":"Improved Doxygen Overload Resolution"},"content":{"rendered":"

We are excited to announce an enhanced Doxygen Comment Support for C++ in Visual Studio 17.7 Preview 2<\/a>. T<\/span>o start using this feature, ensure to update to the latest version of Visual Studio Preview.\u00a0<\/span>\u00a0<\/span><\/p>\n

Download Visual Studio 2022 Preview<\/a><\/div><\/p>\n

Improved <\/span>Doxygen<\/span> overload resolution<\/span><\/span>\u00a0<\/span><\/h3>\n

Doxygen<\/span> comment support has been enhanced to improve the visibility and consistency of shared <\/span>Doxygen<\/span> comments across all overloads of a function. Previously, these comments were only displayed in Quick Info for the first overload<\/span>,<\/span> as <\/span>shown <\/span>below<\/span>.<\/span><\/span>\u00a0<\/span><\/p>\n

\"Doxygen<\/a>W<\/span>ith th<\/span>is feature <\/span>improvement, the shared <\/span>Doxygen<\/span> comment will now appear in Quick Info of all other overloads as well.<\/span> This enhancement is <\/span>demonstrated<\/span> below.<\/span><\/span>\u00a0<\/span><\/p>\n

\"Doxygen<\/a>In cases where the <\/span>Doxygen<\/span> comment is not directly positioned above an overload but <\/span>is applicable<\/span> to that overload, the Quick Info explicitly <\/span>indicates<\/span> this by including the text “Documentation from another overload.” This ensures that you are aware that the information comes from a different overload <\/span>of <\/span>the function.<\/span><\/span>\u00a0<\/span><\/p>\n

Additionally, the <\/span>Doxygen<\/span> comment support now <\/span>provides<\/span> improved visibility for unused parameters. The Quick Info categorizes these unused parameters under the “Unused Parameters” section, allowing developers to easily <\/span>identify<\/span> which parameters are mentioned in the <\/span>Doxygen<\/span> comment but are not <\/span>utilized<\/span> in the associated overload.\u00a0<\/span><\/span>\u00a0<\/span><\/p>\n

Send us your feedback!<\/span><\/span>\u00a0<\/span><\/h3>\n

Try out <\/span>Improved <\/span>Doxygen<\/span> Overload Resolution by downloading the\u00a0latest version of Visual Studio Preview<\/a>. <\/span><\/span>We value your feedback, as it <\/span>greatly influences<\/span> our development. Please share your thoughts in the comments below, on\u00a0Developer Community<\/a><\/span><\/span>, or reach out to us on Twitter\u202f(<\/span><\/span>@VisualC<\/span><\/span><\/a>) or via email at <\/span><\/span>visualcpp@microsoft.com<\/span><\/span><\/a>. We highly appreciate your inputs!<\/span><\/span><\/p>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

We are excited to announce an enhanced Doxygen Comment Support for C++ in Visual Studio 17.7 Preview 2. To start using this feature, ensure to update to the latest version of Visual Studio Preview.\u00a0\u00a0 Improved Doxygen overload resolution\u00a0 Doxygen comment support has been enhanced to improve the visibility and consistency of shared Doxygen comments across […]<\/p>\n","protected":false},"author":96741,"featured_media":35994,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-32338","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-cplusplus"],"acf":[],"blog_post_summary":"

We are excited to announce an enhanced Doxygen Comment Support for C++ in Visual Studio 17.7 Preview 2. To start using this feature, ensure to update to the latest version of Visual Studio Preview.\u00a0\u00a0 Improved Doxygen overload resolution\u00a0 Doxygen comment support has been enhanced to improve the visibility and consistency of shared Doxygen comments across […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/32338","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/users\/96741"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/comments?post=32338"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/32338\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media\/35994"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media?parent=32338"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/categories?post=32338"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/tags?post=32338"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}