473,320 Members | 1,950 Online
Bytes | Software Development & Data Engineering Community
Post Job

Home Posts Topics Members FAQ

Join Bytes to post your question to a community of 473,320 software developers and data experts.

XML Document...<see> tag not working

The following construct generates a good XML file, but "Build Comment Web
Pages..." does not do anything sensible with the <see> tag. Is there a bug
in this tool?

Bob Rundle

using System;
using System.Diagnostics;
namespace DotnetBench
{

public class a1
{
/// <summary>
/// <see cref="Field"></see>
/// </summary>
int field;
/// <summary>
/// this is a property
/// </summary>
int Field
{
get { return field; }
set { field = value; }
}
}
}
Nov 16 '05 #1
1 1786
Richard,

Someone in an earlier post suggested ndoc.sf.net. I just downloaded it and
tried. It rocks! My <see> tag now works. But this tool represents a huge
improvement over the built in tool.

Regards,
Bob Rundle

"Richard" <Ri*****@discussions.microsoft.com> wrote in message
news:F0**********************************@microsof t.com...
I use the tool sometimes too. I have never seen HTML generated for <exception>, <see>, <seealso> and several other tags... If/When you find a
descent tool to convert XML documentation to worthwhile web pages I'd love
to know!!!
--Richard

"Bob Rundle" wrote:
The following construct generates a good XML file, but "Build Comment Web Pages..." does not do anything sensible with the <see> tag. Is there a bug in this tool?

Bob Rundle

using System;
using System.Diagnostics;
namespace DotnetBench
{

public class a1
{
/// <summary>
/// <see cref="Field"></see>
/// </summary>
int field;
/// <summary>
/// this is a property
/// </summary>
int Field
{
get { return field; }
set { field = value; }
}
}
}

Nov 16 '05 #2

This thread has been closed and replies have been disabled. Please start a new discussion.

Similar topics

11
by: Les Paul | last post by:
I'm trying to design an HTML page that can edit itself. In essence, it's just like a Wiki page, but my own very simple version. It's a page full of plain old HTML content, and then at the bottom,...
0
by: Kent Boogaart | last post by:
Hello, It appears that the <see> element has a breaking change in 2.0. In 1.1 it would automatically resolve overloads so you could just write <see cref="string.Format"/> and it would link to...
2
by: Alex VanderWoude | last post by:
I am using the XML documentation feature of VS.NET. Several of my classes have overloaded methods. I would like to create a <see> tag that refers to a specific overload (as opposed to the general...
3
by: Dario | last post by:
What I have to write in the <see> tag in order to access the constructor of a class? E.g.: to access the constructor of a class MyClass I try <see cref="MyClass.MyClass"/> but it does not work....
3
by: Gergely Varadi | last post by:
public class A : IComparable { int IComparable.CompareTo(object obj) { return 1; } } /// <summary> /// <see cref="A.System.IComparable.CompareTo"/>
2
by: Tom Vogel | last post by:
I'd like to use the XML Documentation Tags to comment my C# code. But many of the tags do not have any effect when I execute the "Build Comment Web Pages" menu. For example, the <list> tag gets...
1
by: Lasse Vågsæther Karlsen | last post by:
If I got the following three methods: /// <summary> /// Tests the string. /// </summary> /// <param name="s"> /// The string to test. /// </param> public void Test(String s) {
0
by: Clive Dixon | last post by:
Is there any way of resolving out of scope references in doc tags? I was hoping that the compiler might leave unresolved (but fully qualified by namespace) references intact so that NDoc could...
11
by: Michael Powe | last post by:
How can I make an XHTML-compliant form of an expression in this format: document.write("<scr"+"ipt type='text/javascript' src='path/to/file.js'>"+"</scr"+"ipt>"); this turns out to be a...
0
by: DolphinDB | last post by:
Tired of spending countless mintues downsampling your data? Look no further! In this article, you’ll learn how to efficiently downsample 6.48 billion high-frequency records to 61 million...
0
by: ryjfgjl | last post by:
ExcelToDatabase: batch import excel into database automatically...
0
isladogs
by: isladogs | last post by:
The next Access Europe meeting will be on Wednesday 6 Mar 2024 starting at 18:00 UK time (6PM UTC) and finishing at about 19:15 (7.15PM). In this month's session, we are pleased to welcome back...
1
isladogs
by: isladogs | last post by:
The next Access Europe meeting will be on Wednesday 6 Mar 2024 starting at 18:00 UK time (6PM UTC) and finishing at about 19:15 (7.15PM). In this month's session, we are pleased to welcome back...
0
by: jfyes | last post by:
As a hardware engineer, after seeing that CEIWEI recently released a new tool for Modbus RTU Over TCP/UDP filtering and monitoring, I actively went to its official website to take a look. It turned...
0
by: Defcon1945 | last post by:
I'm trying to learn Python using Pycharm but import shutil doesn't work
0
by: af34tf | last post by:
Hi Guys, I have a domain whose name is BytesLimited.com, and I want to sell it. Does anyone know about platforms that allow me to list my domain in auction for free. Thank you
0
by: Faith0G | last post by:
I am starting a new it consulting business and it's been a while since I setup a new website. Is wordpress still the best web based software for hosting a 5 page website? The webpages will be...
0
isladogs
by: isladogs | last post by:
The next Access Europe User Group meeting will be on Wednesday 3 Apr 2024 starting at 18:00 UK time (6PM UTC+1) and finishing by 19:30 (7.30PM). In this session, we are pleased to welcome former...

By using Bytes.com and it's services, you agree to our Privacy Policy and Terms of Use.

To disable or enable advertisements and analytics tracking please visit the manage ads & tracking page.