fbpx
Welcome, Guest
Username: Password: Remember me
  • Page:
  • 1

TOPIC: Creating XML Documentation

Creating XML Documentation 14 May 2020 15:30 #14571

  • leon-ts's Avatar

  • leon-ts

  • Topic Author


  • Posts: 84
  • Hi devteam,

    When compiling a XSharp project, a documentation file (XML) is always created with the project name in the solution, instead of using the name of the file from the project properties (section <DocumentationFile> SomeFile.Xml </DocumentationFile>).

    For example,
    the project is called "001 - MyCompany.MyProject"
    output file name: MyCompany.MyProject.dll
    in the project properties, the documentation file is set as "MyCompany.MyProject.xml"

    after Build, the file "001 - MyCompany.MyProject.xml" is created on the disk instead of the file "MyCompany.MyProject.xml"

    Is it so intentional or is it a bug?

    Best regards,
    Leonid

    Please Log in or Create an account to join the conversation.

    Creating XML Documentation 14 May 2020 15:55 #14572

  • leon-ts's Avatar

  • leon-ts

  • Topic Author


  • Posts: 84
  • Addition:

    When displaying the description of functions from the documentation, only the first parameter is visible. If there is a second, third, etc., then they will not appear in the tooltip.
    <param name="param1">description1</param>
    Also, the documentation for the return value is not displayed.
    <returns>description</returns>

    The same problem when displaying documentation for XSharp functions (for example, from the XSharp.Core.xml file).
    See XSharp.CoreDb.Eval() for an example.

    Please Log in or Create an account to join the conversation.

    Creating XML Documentation 14 May 2020 17:10 #14573

  • robert's Avatar

  • robert


  • Posts: 1676
  • Leonid,
    The description for the second parameter appears when you press the comma.
    This works the same as the C# integration in VS.
    I don't see the the documentation for the return value in C# as well.
    Where/When should that be displayed ?

    Robert
    XSharp Development Team
    The Netherlands

    Please Log in or Create an account to join the conversation.

    Creating XML Documentation 14 May 2020 17:11 #14574

  • robert's Avatar

  • robert


  • Posts: 1676
  • Leonid,

    after Build, the file "001 - MyCompany.MyProject.xml" is created on the disk instead of the file "MyCompany.MyProject.xml"

    This looks like a bug in the VS integration.
    I'll look into this.

    Robert
    XSharp Development Team
    The Netherlands

    Please Log in or Create an account to join the conversation.

    Creating XML Documentation 14 May 2020 17:36 #14575

  • leon-ts's Avatar

  • leon-ts

  • Topic Author


  • Posts: 84
  • Robert,

    robert wrote: The description for the second parameter appears when you press the comma.
    This works the same as the C# integration in VS.

    Robert, thanks! I didn’t know that.

    Regarding the <returns> tag:
    docs.microsoft.com/en-us/dotnet/csharp/p...guide/xmldoc/returns

    The description of the returned value is displayed in the "Object Browser" window (menu "View -> Object Browser"). But it seems that XSharp does not show detailed information about objects in this window, as C# does.

    Best regards,
    Leonid

    Please Log in or Create an account to join the conversation.

    Creating XML Documentation 14 May 2020 17:52 #14576

  • robert's Avatar

  • robert


  • Posts: 1676
  • Leonid,
    The object browser can show information for code from external assemblies as well as for code that is defined in source code.
    For the code from external assemblies (such as a reference to XSharp.Core) you should see the same information as you can see in the helpfile. I can see the various parameters and return type for XSharp.CoreDb.Eval() for example.
    For types and methods defined in the source code, we are not showing the documentation comments there yet.
    This is on our todo list, but not very high I am afraid.

    Robert
    XSharp Development Team
    The Netherlands

    Please Log in or Create an account to join the conversation.

    Creating XML Documentation 14 May 2020 18:07 #14578

  • leon-ts's Avatar

  • leon-ts

  • Topic Author


  • Posts: 84
  • Robert,

    robert wrote: For the code from external assemblies (such as a reference to XSharp.Core) you should see the same information as you can see in the helpfile.

    It really works. Thanks!

    Best regards,
    Leonid

    Please Log in or Create an account to join the conversation.

    Creating XML Documentation 15 May 2020 09:59 #14590

  • leon-ts's Avatar

  • leon-ts

  • Topic Author


  • Posts: 84
  • Robert,

    Is it possible to implement the display of default values for parameters, as implemented in VO or C#?
    For example, there is a method:
    METHOD MyMethod(a AS INT, b := 5 AS INT, c := 10 AS INT) AS INT
    When working with this method in code, Intellisense displays as a hint only:

    EXPORT METHOD MyMethod(a AS INT, b AS INT, c AS INT) AS INT

    and hides the default values for b and c.

    It can be very difficult to write code without knowing the default values for the called method.

    Best regards,
    Leonid

    Please Log in or Create an account to join the conversation.

    Last edit: by leon-ts.

    Creating XML Documentation 15 May 2020 10:47 #14593

  • robert's Avatar

  • robert


  • Posts: 1676
  • Leonid,
    I will see what I can do.
    We'll be touching the project system and intellisense this month anyway, so we can include this.
    Can you create a Github issue, so we won't forget?

    Robert
    XSharp Development Team
    The Netherlands

    Please Log in or Create an account to join the conversation.

    Creating XML Documentation 15 May 2020 10:53 #14595

  • leon-ts's Avatar

  • leon-ts

  • Topic Author


  • Posts: 84
  • Please Log in or Create an account to join the conversation.

    Last edit: by leon-ts.
    • Page:
    • 1