Page 1 of 1

Xml Documentation !

Posted: Sat Apr 15, 2006 10:48 pm
by TheEnd
Hi all,

I'm wondering why there is no XML documentations in the library?!

It's simple, just add this (for class, method, property) :

/// <summary>
/// Reads the current stream of bla bla!
/// </summary>
public int Read(Stream stream)
{
}

It's really helping the developer to fast understand the method or the class..!

Regards

RE: Xml Documentation !

Posted: Sun Apr 16, 2006 2:17 pm
by johan
There is "XML" docs.

If you download and install the SDK, you will find "XML" docs under Start -> Program -> Franson BlueTools SDK"

You can also find web based XML docs here:
http://franson.com/bluetools/reference_manual.asp?platform=net

Regards,
Johan

Franson Support

RE: Xml Documentation !

Posted: Sun Apr 16, 2006 4:05 pm
by TheEnd
Thanks, but i couldn't find it!
Start -> All Programs -> Franson BlueTools SDK v1.1 ->
Has just 4 folders: .NET 2 and 1, Copmact 2 and 1..
And three CHM help files.. not XML files
I coludn't find any xml files..!

Thanks again,
Regards

RE: Xml Documentation !

Posted: Sun Apr 16, 2006 4:09 pm
by TheEnd
My point is to help the developer while he/she is writing the code..
I know there is documenations.. but I ment the one inside the VS to help you coding better..!

Sorry if there is any misunderstandign..
Regards

RE: Xml Documentation !

Posted: Sun Apr 16, 2006 4:12 pm
by johan
I mean the CHM files as well. They are generated they way you suggest. The help files are not integrated into Visual Studio if that was what you were asking for. However they do have the look and feel of standard .NET documentation.

Regards,
Johan

Franson Support

RE: Xml Documentation !

Posted: Sun Apr 16, 2006 11:12 pm
by TheEnd
Thanks..
Why you didn't check the 'Xml Documentation' checkbox bedore building :) It was gonna be nice feature!

Regards,