Generating Documentation Like MSDN But Manually?

Jun 7, 2010

there are tools (SandCastle?) that can generate an MSDN-like documentation (HTML files) from your source code by using the XML comments above members. I am looking to generate a similar documentation (bunch of HTML files that one can link through), except not from XML comments but completely manually.It is for a custom scripting language, I have to document the available functions, and it would be great if I could do that in this common documentation style. Since there are no XML comments to generate the documentation from (the documentation is for the scripting language itself, not for my source code of the scripting language?

What I'm looking for in detail is a way to generate these documentation files by simply supplying this information for each function:

- Namespace (just the name and maybe a description)
- Function name + description + return type
- List of arguments and their types

from this I would to generate a document where one can first view all the Namespaces, click one (they are supposed to be links) and view all the functions in that namespace. Then you can click on a function name and view its description and list of arguments for that function.In other words: just like these automatic tools do, except now I want to supply this information manually.

While writing this I thought of one way that I might be able to do it: just create namespaces and functions in actual VB code (corresponding to the scripting language functions) and generate the documentation from that, but

1) That seems a little contrived especially if a better tool is available,

2) I would be in trouble with the types of functions and arguments, since they would have to be .NET types and not the types that my scripting language supports.

View 1 Replies


ADVERTISEMENT

Use The MSDN Documentation?

Feb 28, 2010

The regularity and frequency of that extolling is an indication of how many people, for whatever reason, don't use the documentation. Some say that I've forgotten what it's like to be a beginner, but I remember using the MSDN documentation as a beginner. I remember that I couldn't always find what I needed and I also remember that I didn't always understand what I found. More importantly, I remember that that didn't stop me using it first every time I had an issue and I also remember getting better at using it over time. So, I'm genuinely interested to know, if you don't use the MSDN documentation?

View 39 Replies

Class Documentation In Msdn Library For AxShockwaveFlash?

Jan 26, 2012

I don't find the properties and events for this class, and i don't know where in msdn library, is possible to find the documentation.

View 2 Replies

Funny Declaration Structure In MSDN KB DataTypes Documentation?

Oct 5, 2010

I'm looking at the following in the Data Types docs for the Windows API:

#if defined(_WIN64)
typedef __int64 LONG_PTR;
#else

[code]....

View 1 Replies

Generating XML Documentation For Single VB Class In WebSite Project

Jan 26, 2011

I have Single VB Class inside website project and I need to generate XML Documentation for this class. is there any tool that can generate this documentation?

View 1 Replies

VS 2008 - Creating Comments Tags Without Generating XML Documentation File

Jul 6, 2009

When in VS 2008 if a developer hits the ''' it generates the XML comment tags for you, but this only works when the project setting for "Generate XML documentation file" is checked. Is there a way to tell VS to generate the XML Comment tags, regardless of the project setting? I think it is possible that someone may want comments but not create a XML documentation file. In this case I am exceeding the current Team Settings, yet other developers don't want me to change this project setting. This forces me to flip this back before checking in the project. I have the same problem with other Project settings like "code Analysis". This is only a problem for VB.NET projects.

View 4 Replies

Error "The MSDN Collection Does Not Exist - Please Reinstall MSDN" When Try To Access Any Of The Feature Of Visual Basic 6.0

May 26, 2006

I get a message, "The MSDN collection does not exist. reinstall MSDN." When I try to access any of the HELP features of Visual Basic 6.0. I do not have an install disc for this. Is there a download or a place I can get this?

View 7 Replies

What Are Medals And MVP In MSDN

Apr 16, 2011

What are medals in msdn ? Who are MVPs ?farizrahman4u

View 1 Replies

MSDN LIBRARY Missing CD 2

Sep 24, 2010

I just recently installed VB 6.0, and I went to install MSDN Library (April 2000 Release of the MSDN Library)afterward. I was missing CD 2, but installed the other 2 CDs. It appears CD2 is the primary one for VB. Do you know how I can get this specific CD --OR-- can I just download a newer version (i have been looking for both on MSDN with no luck)?

View 2 Replies

MSDN Online Looks Completely Different?

Apr 20, 2010

MSDN online looks completely different. It used to be a set of collapsible controls. Does it still contain the same content? Is it under construction due to the release of 2010?

View 6 Replies

MSDN Website Is Screwing Up?

Jan 19, 2009

Can anyone confirm that the MSDN website is screwing up? It won't return any info that I search for...

View 11 Replies

Signature For Msdn Answers?

Dec 12, 2009

if you are a constant answerer here on msdn, and do not have a unique signature, or no signature at all, please take a little time to create one... eason ..when quoting a post of a member, if no signature available, then it would have to be followed w/ "quoted from so and so's post", this so so said this, etc.

View 16 Replies

VB MSDN Help Language Gives C# Results

Nov 6, 2009

I'm using VS2008 with all updates current. When programming with VB, I set the MSDN Help language to Visual Basic, but I very frequently get results for C#. Why does that happen and is there a reliable way to prevent it? I know C# and can adapt the results to suit my needs, but I thought using the filters was supposed to restrict results. Apparently, it doesn't. I'm just curious; why does that happen?

View 7 Replies

Documentation Or Training On How To Use WMI

May 16, 2011

where can i find some good documentation or training on how to use WMI?

View 3 Replies

IDE :: XML Documentation With ParamArray?

Mar 7, 2012

I am trying to use xml documentation tool in my application. one of my methods receives 'ParamArray' as an argument. i want to document this argument elements.

here is my code
Public Sub LoadSearch_ByEmployee(ByVal EmployeeID As Integer _
, ByVal FromDate As Date _

[code].....

View 4 Replies

Providing Help Documentation In .NET?

Apr 26, 2010

I have written up troubleshooting documents for my project and would like them included in my program. I remember in VB6 there was a very easy way to do this with a control, where it already has the help document tree set up on the left and you just set it to point to certain files.

Does something like this exist for .NET? I am aware of the HelpProvider control but as far as I know this just puts in tooltips and opens documents on a button press?

View 1 Replies

Begining Video From MSDN Web Sights

May 1, 2009

I don't understand why you guy have taken out the begining video from your MSDN web sights.

View 6 Replies

Cannot Find The Msdn Image Library

Jun 28, 2009

I have dowiloaded vb 2008 express and cannot find the msdn image library. I go to where the intellisense tells me to go and the image folder is empty. Is there a way to download the appropriate library.

View 1 Replies

Change My MSDN Account Password?

Mar 9, 2012

It looks like between yesterday or my most recent post and now that someone has been messing with my account.

One image that was in my signature was changed to ( although it looked stretched).>> [code]...

View 11 Replies

IndexOutOfRangeException Error When Running MSDN Example

Jan 23, 2011

This code, which I got from [url]).aspx has been kicking up an error message (and a warning) when I try to use it.

View 1 Replies

MSDN - Collection(Of T).RemoveAt Method

May 25, 2012

The MSDN page for this method says this: ArgumentOutOfRangeException. index is less than zero.-or-index is equal to or greater than Count. That doesn't make any sense, surely it should be "index is equal to or greater than (Count - 1)" Since index is zero based. I need to know since I'm Overriding the RemoveItem method for a Class that Inherits Collection(Of T).

View 6 Replies

MSDN Articles Should Include VB Code?

Apr 27, 2012

With all new technologies like Async/Await I spent hours rewriting sample code from the published C# MSDN Articles to VB.NET.Now that Roslyn is available, why do the authors not inlude the VB.NET code. After all, it can be converted automatically. Why does MSFT not make this a requirement fo all published MSDN articles.This would save us VB.NETs lots of precious time.

View 6 Replies

Offline MSDN Doesn't Work?

Apr 16, 2009

Recently I had to reinstall my system, but now I have a new problem. VS2005 installed ok, and the MSDN documentation appeared to as well (in fact, I have 1.65 Gb of help files in my c:Program FilesMSDN folder.But VS doesn't see the files. All I get is a minimal set of help files for explaining the Help system. Also, when I search for "Visual Studio 2005 Combined Help Collection Manager" , I only get a brief description of the Collection Manager and the message "Collections available for inclusion in VSCC:" at the bottom with no collections visible, and the "Update VSCC" button is grayed out. I have tried installing MSDN via the VS2005 install disk, and separately from the MSDN disk. The version of MSDN2005 is April 2005.

View 6 Replies

VS 2008 Is Msdn Where All Books Stored

Feb 21, 2011

im tring to switch to vb.net i guess thats the only way im going to learn how to make phone apps.when i bought vb6 i thought ms would send all the books involved , maybe in pdf formate.

View 2 Replies

WMI - MSDN Crashes Or Exits After 30 Cycles

Jun 11, 2012

For some reason, the next code found on MSDN crashes or exits after 30 cycles or, in other words, after processing 30th Property, exits without explanation. As I said, I found it in MSDN

[Code]...

View 9 Replies

.NET Project Coding Documentation?

May 25, 2010

I want to know the professional way to comments VB.net project coding. In future, it may help to other people, whom may update my project.

View 4 Replies

C# - Find Detailed Documentation For .Net?

Nov 20, 2009

Here's an example of a wasted day:

(1) I want to find out exactly what Binding.FormattingEnabled does.

(2) I type MSDN Binding.FormattingEnabled into google and go to the page.

(3) I read the 3, 'helpful', line description.

(4) I check out the bottom of the page for references.

(5) Never mind, non of those helped....

(6) I search google and find nobody seems to know what the property does in its entirety.

(7) I open up reflector and spend hours in a tangled web before being 70% sure I know what's going on.

(8) I carry on coding, but the 30% is niggling at me.

(9) Repeat 6 - 8 ad nauseum ...

There must be a better way!

I'm using VS.Net 2008 Express edition, btw.

ETA: The FormattingEnabled property was just an example, this is more of a general question. Using reflector, I'm about 94.314% sure of how it works..

View 6 Replies

C# - Force Documentation In VS(2010)

Mar 13, 2012

I am simply searching how to obtain errors/warning for each function/member that isnt documented. Im pretty sure I managed to do this on one of my projects, but cant find how to do it here on my workstation. I have looked into the project props, the solution props, but cant find it. I must have missed something, or maybe I could do this at home with an extension.

[Code]...

View 2 Replies

Create An Application Documentation?

Sep 29, 2011

I was wondering what options i have in order for me to create documentation for the applications i write? i.e. Some documentation for code written and some general comments on what the application is doing etc?

After a quick search i noticed a few options but most seem to be using VS 2003 (prefer something for 2010)

View 1 Replies

Documentation - XML Comments Not Showing On .Net?

Aug 25, 2009

I am using something similar to this and it will not display the Summary or Remarks when I am attempting to use the Intellisense for this function?

[Code]...

View 1 Replies







Copyrights 2005-15 www.BigResource.com, All rights reserved