ndoc-users — Discussions about using NDoc

Re: [Ndoc-users] WIKI

[Gregory W. <gre...@pu...>]

Try Google's cache:
=20
http://66.249.93.104/search?q=3Dcache:a8XHMT7a5A8J:ndoc.sourceforge.net/w=
i
ki+&hl=3Den&ct=3Dclnk&cd=3D1&client=3Dfirefox-a
=20
The dotNet 2.0 Support page from the wiki (which is a popular target):
=20
http://66.249.93.104/search?q=3Dcache:LmKSsFUd680J:ndoc.sourceforge.net/w=
i
ki/dotNet_2.0_Support+&hl=3Den&ct=3Dclnk&cd=3D1&client=3Dfirefox-a

________________________________

From: ndo...@li...
[mailto:ndo...@li...] On Behalf Of Wijnen,
Johan
Sent: 14 June 2006 13:47
To: ndo...@li...
Subject: [Ndoc-users] WIKI




Your WIKI is not available.=20

I get :=20

Could not get visitors lock: Check whether the web server can create the
directory /tmp/persistent/ndoc/wiki/temp and whether it can create files
in it.

Can you please have a look at it.=20

Thanks=20

[Ndoc-users] WIKI

[Wijnen, J. <Joh...@es...>]

Your WIKI is not available.

I get :

Could not get visitors lock: Check whether the web server can create the
directory /tmp/persistent/ndoc/wiki/temp and whether it can create files in
it.

Can you please have a look at it.

Thanks

Re: [Ndoc-users] error running ndocconsole

[<ms...@so...>]

Actually I do not think the space vs. equals sign makes a difference, at 
least not at the moment :-) I can no longer reproduce my original error. 
Now, with or without "=" I get this ThreadStateException. Any clues? 

NDocConsole -project CleanCode.ndoc -verbose 

NDoc 1.3.1 (Build 1.3.1851.0; release; 1/25/2005)
http://ndoc.sourceforge.net 

using project file CleanCode.ndoc
Error: System.Threading.ThreadStateException
ActiveX control '8856f961-340a-11d0-a96b-00c04fd705a2' cannot be 
instantiated because the current thread is not in a single-threaded 
apartment.
  at System.Windows.Forms.WebBrowserBase..ctor(String clsidString)
  at System.Windows.Forms.WebBrowser..ctor()
  at NDoc.Documenter.Msdn.MsdnUrlValidator.InitializeComponent()
  at NDoc.Documenter.Msdn.MsdnUrlValidator..ctor()
  at NDoc.Documenter.Msdn.MsdnDocumenter..ctor(MsdnDocumenterConfig config)
  at NDoc.Documenter.Msdn.MsdnDocumenterConfig.CreateDocumenter()
  at NDoc.ConsoleApplication.EntryPoint.Main(String[] args) 

Re: [Ndoc-users] Ndoc-users Digest, Vol 1, Issue 271

[Anna <an...@aw...>]

Sorry to miss your message.  I'm currently out of the office on vacation and will be back on Friday (June 16).  If this is an urgent matter, please contact Allan Wellenstein at al...@aw... or (212) 400-6222.

Thank you,
Anna San Luis

Re: [Ndoc-users] Commercial alternatives to the nonexistent NDoc 2.0?

[Simon D. <sim...@gm...>]

On 6/6/06, Eric Bowen (Gmail) <eri...@gm...> wrote:
>
> Reading through this mailing list it sounds like a release version of NDoc
> 2.0 somewhere in the distant future... (if not dead)
>

the development of  ndoc 2 is not dead (albeit somewhat more underground
currently), but based on the quality of the alphas I'd say it's coming along
pretty well. Kevin only knows when a release is planned.

/S

Re: [Ndoc-users] Commercial alternatives to the nonexistent NDoc 2.0?

[Owen B. <ow...@bl...>]

Eric Bowen (Gmail) wrote (2006-06-06 T 12:51 -0500):
> 
> Reading through this mailing list it sounds like a release version of 
> NDoc 2.0 somewhere in the distant future... (if not dead)
>
> So does anybody have any insight on commercial alternatives? 
> DocumentX is the only one that I am personally aware, but it's out of 
> my price range for casual/personal use...

There are some versions of NDoc hacked for .Net 2 /  Visual Studio 2005, 
but I can't get any of them actually to work for me, possibly because 
the solution I'm working on uses generics quite a bit.

http://jonas.lagerblad.com/blog/?p=4 , 
http://sourceforge.net/projects/ndoc05/ and 
http://66.249.93.104/search?q=cache:http%3A%2F%2Fndoc.sourceforge.net%2Fwiki%2FdotNet_2.0_Support
(using Google's cache because the Wiki is down)

might all be of interest  :)


Owen
-- 
Owen Blacker, London GB
Say no to ID cards: www.no2id.net
--
Those who would give up essential liberty to purchase a little temporary
  safety, deserve neither liberty nor safety  -- Benjamin Franklin, 1759

[Ndoc-users] Commercial alternatives to the nonexistent NDoc 2.0?

[Eric B. (Gmail) <eri...@gm...>]

Reading through this mailing list it sounds like a release version of NDoc
2.0 somewhere in the distant future... (if not dead)

So does anybody have any insight on commercial alternatives?  DocumentX is
the only one that I am personally aware, but it's out of my price range for
casual/personal use...

Thanks-

-EAB

-- 
Eric Bowen | http://scrappydog.com/blog | eri...@gm...

[Ndoc-users] wiki is broken...

[Robert S. <ro...@ja...>]

I wasn't sure where to send this, so hopfully an admin is on this list.
 
 
Any attempt to go to any connent within the wiki generates the below error:
 
Attmpeted URLs:
http://ndoc.sf.net/wiki
http://ndoc.sourceforge.net/wiki/dotNet_2.0_Support
 
 
Error
========================

Could not get visitors lock: Check whether the web server can create the
directory /tmp/persistent/ndoc/wiki/temp and whether it can create files in
it.

 
 
Thanks,
Robert
 
 
 

Re: [Ndoc-users] error running ndocconsole

[Gregory W. <gre...@pu...>]

You might be interested to know that there is a slightly later version
(1.3.1-v16) of ndoc on the same blog:

http://jonas.lagerblad.com/blog/?p=3D5

However, I don't know whether this will solve the exception you
describe.

Gregory

-----Original Message-----
From: ndo...@li...
[mailto:ndo...@li...] On Behalf Of
ms...@so...
Sent: 6 June 2006 18:02
To: ndo...@li...
Subject: [Ndoc-users] error running ndocconsole

I am using the ndoc port for 2.0 (ndoc-bin-1.3.1-v15.zip) from
http://jonas.lagerblad.com/blog/?p=3D4.
The GUI application works fine. I am trying to use the same ndoc project
file via the command line version, as in:=20

NDocConsole -project CleanCode.ndoc -verbose=20

but it always fails with this error:
 -------------
NDoc 1.3.1 (Build 1.3.1851.0; release; 1/25/2005)
http://ndoc.sourceforge.net Initializing...
	Last step took 0.0 s
Merging XML documentation...
Error: NDoc.Core.DocumenterException
Could not load file or assembly 'CleanCode.ndoc' or one of its
dependencies.=20
The module was expected to contain an assembly manifest.
Error: System.BadImageFormatException
Could not load file or assembly 'CleanCode.ndoc' or one of its
dependencies.=20
The module was expected to contain an assembly manifest.
  at NDoc.Documenter.Msdn.MsdnDocumenter.Build(Project _project)
  at NDoc.ConsoleApplication.EntryPoint.Main(String[] args)
Error: NDoc.Core.DocumenterException
 -------------
(I removed the path to my file for brevity above--but I have
triple-checked that it is the correct path.) Any ideas on what I am
doing wrong?=20


_______________________________________________
Ndoc-users mailing list
Ndo...@li...
https://lists.sourceforge.net/lists/listinfo/ndoc-users

[Ndoc-users] error running ndocconsole

[<ms...@so...>]

I am using the ndoc port for 2.0 (ndoc-bin-1.3.1-v15.zip) from 
http://jonas.lagerblad.com/blog/?p=4.
The GUI application works fine. I am trying to use the same ndoc project 
file via the command line version, as in: 

NDocConsole -project CleanCode.ndoc -verbose 

but it always fails with this error:
 -------------
NDoc 1.3.1 (Build 1.3.1851.0; release; 1/25/2005)
http://ndoc.sourceforge.net
Initializing...
	Last step took 0.0 s
Merging XML documentation...
Error: NDoc.Core.DocumenterException
Could not load file or assembly 'CleanCode.ndoc' or one of its dependencies. 
The module was expected to contain an assembly manifest.
Error: System.BadImageFormatException
Could not load file or assembly 'CleanCode.ndoc' or one of its dependencies. 
The module was expected to contain an assembly manifest.
  at NDoc.Documenter.Msdn.MsdnDocumenter.Build(Project _project)
  at NDoc.ConsoleApplication.EntryPoint.Main(String[] args)
Error: NDoc.Core.DocumenterException
 -------------
(I removed the path to my file for brevity above--but I have triple-checked 
that it is the correct path.)
Any ideas on what I am doing wrong? 

[Ndoc-users] [ANN] NDocSyntax - free syntax highlighting for NDoc

[Jaroslaw K. <ja...@jk...>]

Hi,

I'm a big fan of small utilities that can help me automate everyday 
programming tasks. Here is a tool I wrote some time ago, which may be useful 
to the users of NDoc. It's called NDocSyntax and it works by post-processing 
documentation files (*.xml) generated by C# compiler by adding coloring 
attributes to all <code> tags. Supports C#, Visual Basic, JScript and XML. 
The files can be then fed to NDoc 1.3.1 or 2.0 to produce nice looking 
documentation with syntax highlighting.

The utility is free, open-source, licensed under the terms of BSD license 
(very permissive). It's rather quick and dirty but does its job.

More information (screenshots included) can be found here:
http://blog.jkowalski.net/?p=48

Jarek

Re: [Ndoc-users] translate ndoc

[Bill S. <tec...@gm...>]

They're all over the place. Literally.

My team made some strides to internationalize Ndoc 1.3 and promote the
code back to SourceForge, but we haven't heard back regarding this.

On 5/20/06, Sebasti=E1n V=E1zquez <ch...@gm...> wrote:
> Hi all! I have just suscribed to this list.
>
> I'm wondering if it's possible to give hand in translation (i.e. 'see als=
o'
> -> 'vea tambi=E9n'). I mean, I think I could translate the static message=
s
> into spanish. I only need to know where are those messages and where shou=
ld
> I leave the new ones.
>
> Thank you very much.

--=20
Bill Swallow
HATT List Owner
WWP-Users List Owner
Senior Member STC, TechValley Chapter
http://techcommdood.blogspot.com

[Ndoc-users] translate ndoc

[<ch...@gm...>]

Hi all! I have just suscribed to this list.

I'm wondering if it's possible to give hand in translation (i.e. 'see also'
-> 'vea tambi=E9n'). I mean, I think I could translate the static messages
into spanish. I only need to know where are those messages and where should
I leave the new ones.

Thank you very much.

Re: [Ndoc-users] Problem Accessing Wiki

[Kevin B. <kev...@gm...>]

Thanks, that was actually quite helpful...  but not in the way I expected!
I had assumed that I was missing some critical piece of the puzzle and
that's why it wasn't working with the "nightly" build.  Wrong!

In the end it had nothing to do with what I did/didn't have installed.  The
project I was working on was not generating the necessary XML files because
the option wasn't specified.  After that I then discovered that ndoc had
cached the old settings (i.e. without a reference to the XML file path).  I
removed the assembly reference and added it again and... voila!
Documentation!

Thanks,
Kevin.

On 5/18/06, Gregory Williams <gre...@ge...> wrote:
>
>  It's been down for much longer than a week!
>
> You can access a copy of the page from Google's cache here:
>
>
> http://66.249.93.104/search?q=3Dcache:LmKSsFUd680J:ndoc.sourceforge.net/w=
iki/dotNet_2.0_Support+&hl=3Den&ct=3Dclnk&cd=3D1&client=3Dfirefox-a
>
> Gregory
>

RE: [Ndoc-users] Problem Accessing Wiki

[Gregory W. <gre...@ge...>]

It's been down for much longer than a week!
=20
You can access a copy of the page from Google's cache here:
=20
http://66.249.93.104/search?q=3Dcache:LmKSsFUd680J:ndoc.sourceforge.net/w=
i
ki/dotNet_2.0_Support+&hl=3Den&ct=3Dclnk&cd=3D1&client=3Dfirefox-a
=20
Gregory

________________________________

From: ndo...@li...
[mailto:ndo...@li...] On Behalf Of Kevin Berry
Sent: 18 May 2006 15:13
To: ndo...@li...
Subject: [Ndoc-users] Problem Accessing Wiki


http://ndoc.sourceforge.net/wiki/dotNet_2.0_Support

I get this error when I try to access it.  AFAIK, this has been the case
more more than a week now...=20

Could not get visitors lock: Check whether the web server can create the
directory /tmp/persistent/ndoc/wiki/temp and whether it can create files
in it.

Thanks,
Kevin.

Re: [Ndoc-users] Problem Accessing Wiki

[Kevin B. <kev...@gm...>]

Surely this is a matter of contacting someone at Sourceforge.  Or isn't it?
If it is Sourceforge, does anyone know who to contact?

On 5/18/06, Strickland,David <dst...@mn...> wrote:
>
>  Sorry Kevin But we aint seen an Admin in Months.
>
> -----Original Message-----
> **
> Who is responsible for administering this site?  Hopefully they're on thi=
s
> mailing list....  or is there another mailing list that is more appropria=
te
> to address this problem?
>
> Thanks,
> Kevin.
>
> On 5/18/06, Bill Swallow <tec...@gm...> wrote:
> >
> > Ditto.
>
>

Re: [Ndoc-users] Problem Accessing Wiki

[Kevin B. <kev...@gm...>]

Who is responsible for administering this site?  Hopefully they're on this
mailing list....  or is there another mailing list that is more appropriate
to address this problem?

Thanks,
Kevin.

On 5/18/06, Bill Swallow <tec...@gm...> wrote:
>
> Ditto.
>
> On 5/18/06, Kevin Berry <kev...@gm...> wrote:
> > http://ndoc.sourceforge.net/wiki/dotNet_2.0_Support
> >
> > I get this error when I try to access it.  AFAIK, this has been the cas=
e
> > more more than a week now...
> >
> > Could not get visitors lock: Check whether the web server can create th=
e
> > directory /tmp/persistent/ndoc/wiki/temp and whether it can create file=
s
> in
> > it.
> >
> > Thanks,
> > Kevin.
> >
>
>
> --
> Bill Swallow
> HATT List Owner
> WWP-Users List Owner
> Senior Member STC, TechValley Chapter
> http://techcommdood.blogspot.com
>

[Ndoc-users] Problem Accessing Wiki

[Kevin B. <kev...@gm...>]

http://ndoc.sourceforge.net/wiki/dotNet_2.0_Support

I get this error when I try to access it.  AFAIK, this has been the case
more more than a week now...

Could not get visitors lock: Check whether the web server can create the
directory /tmp/persistent/ndoc/wiki/temp and whether it can create files in
it.

Thanks,
Kevin.

RE: [Ndoc-users] See tag to overload page

[Mark I. <mi...@so...>]

 Sorry, I didn't put the M: into the comments, I thought that was put
into the xml output.
Doing, <see cref=3D"M:Foo"/> works great.

 Thanks! :)



-----Original Message-----
From: ndo...@li...
[mailto:ndo...@li...] On Behalf Of Mark Ingram
Sent: 03 May 2006 13:49
To: NDoc users list
Subject: RE: [Ndoc-users] See tag to overload page

Hi, that's not helped unfortunately, here is what I have:

		/// <summary>
		/// <see cref=3D"Test"/>
		/// </summary>
		public void Testing()
		{
		}

		private void Test()
		{
		}

		private void Test(Int32 test)
		{
		}

		private void Test(String test)
		{
		}

And then the error:

Error	3	Warning as Error: Ambiguous reference in cref attribute:
'Test'. Assuming 'Debug.Test()', but could have also matched other
overloads including 'Debug.Test(string)'.

Any help appreciated, thanks!
Mark


-----Original Message-----
From: ndo...@li...
[mailto:ndo...@li...] On Behalf Of Owen
Blacker
Sent: 03 May 2006 13:33
To: NDoc users list
Subject: Re: [Ndoc-users] See tag to overload page

Try a member type identifier (see
http://msdn2.microsoft.com/en-US/library/fsbx0t7x.aspx for
documentation; it's .Net 2 documentation, cos that's what I have
bookmarked, but I believe it's unchanged since .Net 1.x)

So, in this case, I think you want <see cref=3D"M:Foo"/>, rather than =
<see
cref=3D"Foo()"/>, <see cref=3D"Foo(String)"/> or <see =
cref=3D"Foo(Int32)"/>

Hth,


Owen

Mark Ingram wrote (2006-05-03 T 13:05 +0100):
>=20
> Hi, if I have a function called Foo(), which is defined as:
>
> Foo();
> Foo(String test);
> Foo(Int32 test);
>
> How do I make a link in the documentation to the actual overload page=20
> for Foo, not a specific version of the function?
>
> i.e.
>
> <see cref=3D"Foo"/> won't compile because of ambiguous symbol. =
However,=20
> specifying <see cref=3D"Foo()"/> causes it to link to the first =
instance

> of the function.
>
> Thanks,
>
>
> Mark Ingram
> Software Engineer
>

--
Owen Blacker, London GB
Say no to ID cards: www.no2id.net
--
They that can give up essential liberty to obtain a little temporary
  safety deserve neither liberty nor safety --Benjamin Franklin, 1759


-------------------------------------------------------
Using Tomcat but need to do more? Need to support web services,
security?
Get stuff done quickly with pre-integrated technology to make your job
easier Download IBM WebSphere Application Server v.1.0.1 based on Apache
Geronimo
http://sel.as-us.falkag.net/sel?cmd=3Dlnk&kid=3D120709&bid=3D263057&dat=3D=
121642
_______________________________________________
Ndoc-users mailing list
Ndo...@li...
https://lists.sourceforge.net/lists/listinfo/ndoc-users


-------------------------------------------------------
Using Tomcat but need to do more? Need to support web services,
security?
Get stuff done quickly with pre-integrated technology to make your job
easier Download IBM WebSphere Application Server v.1.0.1 based on Apache
Geronimo
http://sel.as-us.falkag.net/sel?cmd=3Dk&kid=120709&bid&3057&dat=121642
_______________________________________________
Ndoc-users mailing list
Ndo...@li...
https://lists.sourceforge.net/lists/listinfo/ndoc-users

RE: [Ndoc-users] See tag to overload page

[Mark I. <mi...@so...>]

Hi, that's not helped unfortunately, here is what I have:

		/// <summary>
		/// <see cref=3D"Test"/>
		/// </summary>
		public void Testing()
		{
		}

		private void Test()
		{
		}

		private void Test(Int32 test)
		{
		}

		private void Test(String test)
		{
		}

And then the error:

Error	3	Warning as Error: Ambiguous reference in cref attribute:
'Test'. Assuming 'Debug.Test()', but could have also matched other
overloads including 'Debug.Test(string)'.

Any help appreciated, thanks!
Mark


-----Original Message-----
From: ndo...@li...
[mailto:ndo...@li...] On Behalf Of Owen
Blacker
Sent: 03 May 2006 13:33
To: NDoc users list
Subject: Re: [Ndoc-users] See tag to overload page

Try a member type identifier (see
http://msdn2.microsoft.com/en-US/library/fsbx0t7x.aspx for
documentation; it's .Net 2 documentation, cos that's what I have
bookmarked, but I believe it's unchanged since .Net 1.x)

So, in this case, I think you want <see cref=3D"M:Foo"/>, rather than =
<see
cref=3D"Foo()"/>, <see cref=3D"Foo(String)"/> or <see =
cref=3D"Foo(Int32)"/>

Hth,


Owen

Mark Ingram wrote (2006-05-03 T 13:05 +0100):
>=20
> Hi, if I have a function called Foo(), which is defined as:
>
> Foo();
> Foo(String test);
> Foo(Int32 test);
>
> How do I make a link in the documentation to the actual overload page=20
> for Foo, not a specific version of the function?
>
> i.e.
>
> <see cref=3D"Foo"/> won't compile because of ambiguous symbol. =
However,=20
> specifying <see cref=3D"Foo()"/> causes it to link to the first =
instance

> of the function.
>
> Thanks,
>
>
> Mark Ingram
> Software Engineer
>

--
Owen Blacker, London GB
Say no to ID cards: www.no2id.net
--
They that can give up essential liberty to obtain a little temporary
  safety deserve neither liberty nor safety --Benjamin Franklin, 1759


-------------------------------------------------------
Using Tomcat but need to do more? Need to support web services,
security?
Get stuff done quickly with pre-integrated technology to make your job
easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache
Geronimo
http://sel.as-us.falkag.net/sel?cmd=3Dlnk&kid=3D120709&bid=3D263057&dat=3D=
121642
_______________________________________________
Ndoc-users mailing list
Ndo...@li...
https://lists.sourceforge.net/lists/listinfo/ndoc-users

Re: [Ndoc-users] See tag to overload page

[Owen B. <ow...@bl...>]

Try a member type identifier (see 
http://msdn2.microsoft.com/en-US/library/fsbx0t7x.aspx for 
documentation; it's .Net 2 documentation, cos that's what I have 
bookmarked, but I believe it's unchanged since .Net 1.x)

So, in this case, I think you want <see cref="M:Foo"/>, rather than <see 
cref="Foo()"/>, <see cref="Foo(String)"/> or <see cref="Foo(Int32)"/>

Hth,


Owen

Mark Ingram wrote (2006-05-03 T 13:05 +0100):
> 
> Hi, if I have a function called Foo(), which is defined as:
>
> Foo();
> Foo(String test);
> Foo(Int32 test);
>
> How do I make a link in the documentation to the actual overload page
> for Foo, not a specific version of the function?
>
> i.e.
>
> <see cref="Foo"/> won't compile because of ambiguous symbol. However,
> specifying <see cref="Foo()"/> causes it to link to the first instance
> of the function.
>
> Thanks,
>
>
> Mark Ingram
> Software Engineer
>

-- 
Owen Blacker, London GB
Say no to ID cards: www.no2id.net
--
They that can give up essential liberty to obtain a little temporary
  safety deserve neither liberty nor safety --Benjamin Franklin, 1759

[Ndoc-users] See tag to overload page

[Mark I. <mi...@so...>]

Hi, if I have a function called Foo(), which is defined as:
=20
Foo();
Foo(String test);
Foo(Int32 test);
=20
How do I make a link in the documentation to the actual overload page
for Foo, not a specific version of the function?
=20
i.e.
=20
<see cref=3D"Foo"/> won't compile because of ambiguous symbol. However,
specifying <see cref=3D"Foo()"/> causes it to link to the first instance
of the function.
=20
Thanks,
=20

Mark Ingram
Software Engineer

RE: [Ndoc-users] .Net 2.0 generics in XML doc comments

[Owen B. <ow...@bl...>]

Mark,

Thank you very much; that seems to be exactly what I needed.

If you're in London sometime, do feel free to insist that I buy you a 
drink  :o)


Owen

Mark Ingram wrote (2006-04-28 T 13:43 +0100):

> From: Mark Ingram <mi...@so...>
> Return-Path: <ndo...@li...>
> To: NDoc users list <ndo...@li...>
> Envelope-To: ow...@pl...
> Message-ID: <936...@cr...>
> X-Spam-Status: No, score=-2.6 required=10.0 tests=BAYES_00,MIME_QP_LONG_LINE,
>     SPF_HELO_PASS autolearn=ham version=3.0.4
> Date: Fri, 28 Apr 2006 13:43:48 +0100
> Delivery-date: Fri, 28 Apr 2006 13:45:41 +0100
> Subject: RE: [Ndoc-users] .Net 2.0 generics in XML doc comments
> 
> Try:
>
> List{T}
>
> Kevin Downs had to supply me with that answer a few months back...
>
>
> -----Original Message-----
> From: ndo...@li...
> [mailto:ndo...@li...] On Behalf Of Owen
> Blacker
> Sent: 28 April 2006 13:40
> To: NDoc users list
> Cc: Owen Blacker; Julian Birch
> Subject: [Ndoc-users] .Net 2.0 generics in XML doc comments
>
> I'm having some trouble with the various versions of NDoc I have
> installed to try to generate comments for the .Net 2.0 project I'm
> working on at the moment.
>
> Both "NDoc 1.3.1 v15" and "NDoc 2005" seem to throw
> NDoc.Core.DocumenterException exceptions when I try to generate the
> comments (see http://plum.flirble.org/~owen/NDoc_1.3.1_v15.txt and
> http://plum.flirble.org/~owen/NDoc_2005.txt for stack traces)
>
> This isn't really the reason I'm mailing however (though if someone
> wants to fix those or tell me what I'm doing wrong then please be my
> guest ;o)
>
> What I really want to know is a problem caused by the apparent inability
> of Microsoft developers to write useful sample code.
>
> I have a property of my class that returns a List<string>.  So far so
> good, but I have absolutely no idea how to write a <see cref=""/> tag
> for that type.  If I write <see
> cref="System.Collections.Generic.List<string>"/>
> then I am completely unsurprised that Visual Studio tells me there's a
> problem, as the angle-brackets are obviously going to cause problems.
>
> But what should I be writing?  :o)
>
>
> Owen
> --
> Owen Blacker, London GB
> Say no to ID cards: www.no2id.net
> --
> They that can give up essential liberty to obtain a little temporary
>  safety deserve neither liberty nor safety --Benjamin Franklin, 1759
>
>
> -------------------------------------------------------
> Using Tomcat but need to do more? Need to support web services,
> security?
> Get stuff done quickly with pre-integrated technology to make your job
> easier
> Download IBM WebSphere Application Server v.1.0.1 based on Apache
> Geronimo
> http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
> _______________________________________________
> Ndoc-users mailing list
> Ndo...@li...
> https://lists.sourceforge.net/lists/listinfo/ndoc-users
>
>
> -------------------------------------------------------
> Using Tomcat but need to do more? Need to support web services, security?
> Get stuff done quickly with pre-integrated technology to make your job easier
> Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
> http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
> _______________________________________________
> Ndoc-users mailing list
> Ndo...@li...
> https://lists.sourceforge.net/lists/listinfo/ndoc-users
>

-- 
Owen Blacker, London GB
Say no to ID cards: www.no2id.net
--
They that can give up essential liberty to obtain a little temporary
  safety deserve neither liberty nor safety --Benjamin Franklin, 1759

RE: [Ndoc-users] .Net 2.0 generics in XML doc comments

[Mark I. <mi...@so...>]

 Try:

List{T}

Kevin Downs had to supply me with that answer a few months back...


-----Original Message-----
From: ndo...@li...
[mailto:ndo...@li...] On Behalf Of Owen
Blacker
Sent: 28 April 2006 13:40
To: NDoc users list
Cc: Owen Blacker; Julian Birch
Subject: [Ndoc-users] .Net 2.0 generics in XML doc comments

I'm having some trouble with the various versions of NDoc I have
installed to try to generate comments for the .Net 2.0 project I'm
working on at the moment.

Both "NDoc 1.3.1 v15" and "NDoc 2005" seem to throw
NDoc.Core.DocumenterException exceptions when I try to generate the
comments (see http://plum.flirble.org/~owen/NDoc_1.3.1_v15.txt and
http://plum.flirble.org/~owen/NDoc_2005.txt for stack traces)

This isn't really the reason I'm mailing however (though if someone
wants to fix those or tell me what I'm doing wrong then please be my
guest ;o)

What I really want to know is a problem caused by the apparent inability
of Microsoft developers to write useful sample code.

I have a property of my class that returns a List<string>.  So far so
good, but I have absolutely no idea how to write a <see cref=3D""/> tag
for that type.  If I write <see
cref=3D"System.Collections.Generic.List<string>"/>
then I am completely unsurprised that Visual Studio tells me there's a
problem, as the angle-brackets are obviously going to cause problems.

But what should I be writing?  :o)


Owen
--
Owen Blacker, London GB
Say no to ID cards: www.no2id.net
--
They that can give up essential liberty to obtain a little temporary
  safety deserve neither liberty nor safety --Benjamin Franklin, 1759


-------------------------------------------------------
Using Tomcat but need to do more? Need to support web services,
security?
Get stuff done quickly with pre-integrated technology to make your job
easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache
Geronimo
http://sel.as-us.falkag.net/sel?cmd=3Dlnk&kid=3D120709&bid=3D263057&dat=3D=
121642
_______________________________________________
Ndoc-users mailing list
Ndo...@li...
https://lists.sourceforge.net/lists/listinfo/ndoc-users

[Ndoc-users] .Net 2.0 generics in XML doc comments

[Owen B. <ow...@bl...>]

I'm having some trouble with the various versions of NDoc I have 
installed to try to generate comments for the .Net 2.0 project I'm 
working on at the moment.

Both "NDoc 1.3.1 v15" and "NDoc 2005" seem to throw 
NDoc.Core.DocumenterException exceptions when I try to generate the 
comments (see http://plum.flirble.org/~owen/NDoc_1.3.1_v15.txt and 
http://plum.flirble.org/~owen/NDoc_2005.txt for stack traces)

This isn't really the reason I'm mailing however (though if someone 
wants to fix those or tell me what I'm doing wrong then please be my 
guest ;o)

What I really want to know is a problem caused by the apparent inability 
of Microsoft developers to write useful sample code.

I have a property of my class that returns a List<string>.  So far so 
good, but I have absolutely no idea how to write a <see cref=""/> tag 
for that type.  If I write <see cref="System.Collections.Generic.List<string>"/>
then I am completely unsurprised that Visual Studio tells me there's a 
problem, as the angle-brackets are obviously going to cause problems.

But what should I be writing?  :o)


Owen
-- 
Owen Blacker, London GB
Say no to ID cards: www.no2id.net
--
They that can give up essential liberty to obtain a little temporary
  safety deserve neither liberty nor safety --Benjamin Franklin, 1759