2017-06-15 10 views
6

Ich möchte eine mehrzeilige XML-Dokumentation hinzufügen, die in der Intelli-Sense-Blase erscheint, wenn ich mit der Maus darüber schwebe. Siehe zum Beispiel:F # XML mehrzeilige Dokumentation, Visual Studio 2017

enter image description here

Wenn ich Visual Studio 2015 bin mit dem folgenden Code funktioniert (siehe Screenshots unten), aber jetzt, wenn ich Visual Studio 2017 verwenden, funktioniert es nicht mehr:

sehen Sie im folgenden Screenshot genommen in VS2015 und VS2017

VS2015:

enter image description here

VS2017:

enter image description here

Nach Stackoverflow und andere Website suchen, habe ich versucht, einige Codes, aber es funktioniert immer noch nicht.

// My failed guesses  

/// This also does not work 
/// & 
 This does not work 
let EXAMPLE3 = 2.0 


/// This also does not work 
/// \n This does not work 
let EXAMPLE4 = 2.0 

/// This also does not work 
/// <br> This does not work 
let EXAMPLE5 = 2.0 

/// <summary> 
/// This also does not work 
/// <para> &#13; This does not work </para> 
/// </summary> 
let EXAMPLE6 = 2.0 

How to add a line break in C# .NET documentation

Documenting F# Code

https://www.w3.org/MarkUp/html-spec/html-spec_13.html

Wie füge ich eine Dokumentation XML mehrzeiligen in VS2017, für F #? Vielen Dank für Ihre Hilfe.

+0

können Sie dies auf [Visual F # Issues] (https://github.com/Microsoft/visualfsharp/issues) setzen. Es wurde viel Arbeit am Intellisense-Dokument-Popup in den F # Tools geleistet, vielleicht kommt es von dort. – s952163

+1

@ s952163 Das Problem wurde nur Visual F # Issues hinzugefügt. Danke für den Vorschlag. –

Antwort

1

Interessanterweise scheint eine völlig leere Zeile verläßt in VS 2017 zu arbeiten, aber nicht in VS 2015:

/// First paragraph 
/// 
/// Second paragraph 
let example = 1 

Ich weiß nicht, ob dies eine absichtliche neue Ergänzung.

Das Ignorieren des Tags <para> sieht wie ein Fehler in VS2017 aus.