microsoft / microsoft/vscode-cpptools

Doxygen comments to the right of members or fields do not parse if they span multiple lines

Offen
#5,811 3 Kommentare 1 Reaktion 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Feature Request Feature: Doc comments Language Service Visual Studio
Vorherrschende Sprache
TypeScript
Sterne
6.2k
Forks
1.7k
Ø Merge
14 Std. 46 Min.
Gemergte PRs (30 T.)
61

Beschreibung

Type: LanguageService

Describe the bug

  • VS Code Version: 1.47.2
  • C/C++ Extension Version: 0.29.0

For struct members or class fields, I will often write a comment next to it instead of above it in order to reduce clutter. Since I use rulers, these comments very often extend across more than one line, e.g. something like

            module owner;   /** The owner of this instance. This determines e.g. which message queue
                                to listen to. */

Hovering above owner I would expect the comment to be shown, but this is not the case. It appears that this only works if the comment spans a single line instead of more than one. Multiline comments only work when the comment is above the field, not to its right.

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Reproduziere das gemeldete Verhalten des C++-Language-Service mit dem im Issue gezeigten mehrzeiligen nachgestellten Doxygen-Kommentar und vergleiche es anschließend mit einem einzeiligen nachgestellten Kommentar und einem mehrzeiligen Kommentar oberhalb des Feldes. Im Issue werden weder Quelldatei noch Test genannt; abgeschlossen ist die Aufgabe, wenn beim Überfahren von owner der vollständige nachgestellte Kommentar über mehrere Zeilen hinweg angezeigt wird.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
cpp, vscode
Bereich
devtools
Issue-Typ
Bug
Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.