Support for include tag and navigation in XML documentation

SyntaxEditor .NET Languages Add-on for WPF Forum

Posted 1 year ago by Tobias Lingemann - Software Devolpment Engineer, Vector Informatik GmbH

Hi there,

a customer from us would like to see support for the include tag in XML comments.

Additionaly he likes the navigation feature, where you can jump to a referenced "cref" element.
But this would be a bit more complicated, since we would require a callback, where you just provide the location and when open and navigate to the files.

Is there any chance you could add this feature in the foreseeable future?

Best regards, Tobias Lingemann.

Comments (1)

Posted 1 year ago by Actipro Software Support - Cleveland, OH, USA

Hi Tobias,

The include tag would be fairly difficult to support since it would like require on-the-fly file loading when detected and then using XPath to locate a match.  All of that can impact performance since it deals with files at a time you're trying to quickly show a popup.  Any time you access a file, you never know if it will load quickly or not.

The navigation feature is complex too.  Right now, mouse-initiated quick info hides as the mouse moves over it.  Quick info would first need to be refactored to support mouse movement over the popup in that scenario.  

The second piece for the navigation request would be to build some link format for identifiers.  We have support for links in IntelliPrompt content already.  It would have to inject a link for definitions it has resolved instead of just a name identifier.  Then you'd have to handle the link click event.

We added suggestions on the TODO list for those items.

Actipro Software Support

The latest build of this product (v24.1.2) was released 2 months ago, which was after the last post in this thread.

Add Comment

Please log in to a validated account to post comments.