fj64

Suppose a code like follows:

namespace a
{
/// <summary>
/// summary for b
/// </summary>

public class b
{
/// <summary>
/// summary for the subclass
/// </summary>
/// <remarks>
/// remarks for the subclass
/// </remarks>
public
class c
{
/// <summary>
/// summary for enum in subclass
/// </summary>
public enum d
{...}
/// <summary>
/// summary for the constructor of the subclass
/// </summary>
/// <param name="e">description for the param e</param>
/// <remarks>
public c(b.c.d e)
{...}
}
// the main class continued
}
}

The parameters description of the constructor of the subclass c will be reported in the help file (below VB, C# and C++ syntax) as:

Parameters

e
a.d
description for the param e

The correct way would be:
e
a.b.c.d
description for the param e

SHFB 1.4.0.0 with VS2005 presentation style was used for the builing of the help file.



Re: Developer Documentation and Help System Name of a nested type does not appear correctly.

Jens Fuessler

I have a similar problem:

Suppose the following scenario:

I have a namespace Controls. Inside this namespace i have a class Tree and List. Both have Subclasses called items:

namespace Controls

{

/// <summary>

/// A Tree

/// </summary>

public class Tree

{

/// <summary>

/// Tree Items

/// </summary>

public class Items

{}

}

/// <summary>

/// A List

/// </summary>

public class List

{

/// <summary>

/// List Items

/// </summary>

public class Items

{}

}

}

The Problem now is that in the documentation the two subclasses are listet without their parent classes under the Namespace Controls so you are not able to identify to which parent class the item classes belong to.

Even when using the Index Tab in Help Browser and typing Tree.Items, you will not receive the subclass as a result. But when using the Search Tab in HelpBrowser and typing Tree.Items into the search field, the corresponding subclass is found.

Any solutions for this

Thanks in advance,

Jens





Re: Developer Documentation and Help System Name of a nested type does not appear correctly.

Stephan Smetsers

hi,

I noticed that when I derive a class from a nested class the inheritance hierarchy is not displayed correctly:

Example:

1. inchl.Framework.Common namespace contains a class named Shadow.

This Shadow class contains a nested class named ObjectBase

2. inchl.Framework.Common namespace contains a class named ObjectBase this ObjectBase class is

derived from the Shadow.ObjectBase class (a nested type)

The inheritance hierarchy (for the (2) class) is being displayed as:

inchl.Framework.Common.ObjectBase

inchl.Framework.Common.ObjectBase

I would have expected:

inchl.Framework.Common.Shadow.ObjectBase

inchl.Framework.Common.ObjectBase

Please fix this problem. This problem also presents itself on the class definition, like:

public class ObjectBase : ObjectBase

I would have expected:

public class ObjectBase : Shadow.ObjectBase

for more information see: http://www.inchl.nl/help/3a8f003f-a79c-b4de-5b23-424d62776822.htm

Kind regards,

Stephan Smetsers

http://www.inchl.nl





Re: Developer Documentation and Help System Name of a nested type does not appear correctly.

Stephan Smetsers

jep,... sounds familiar,

see: http://forums.microsoft.com/MSDN/ShowPost.aspx PostID=1597481&SiteID=1

I hope they fix it real soon.

Stephan





Re: Developer Documentation and Help System Name of a nested type does not appear correctly.

Anand Raman - MSFT

I am checking on these. As per my team these issues have been fixed after we release March CTP.

I expect to release the next CTP this week or early next week.

Anand..