Click here to Skip to main content
15,886,362 members
Articles / Database Development / SQL Server

Modifying GhostDoc XML Comment

Rate me:
Please Sign up or sign in to vote.
5.00/5 (3 votes)
15 Mar 2010CDDL 28.4K   4   4
A simple trick to add to custom node to the XML commenting.in GhostDoc
Today while browsing I came across Matthew M. Osborn's Blog and I found this fantastic line: “Documentation is the coders best and worst friend. It is a two sided sword, it makes your life easier but no one likes writing it. So coders do what we do best and find a way to make the computer do it for us.”

Today while browsing I came across Matthew M. Osborn’s Blog and I found this fantastic line

“Documentation is the coders best and worst friend. It is a two sided sword, it makes your life easier but no one likes writing it. So coders do what we do best and find a way to make the computer do it for us.”

Ideally I use GhostDoc to make comments for my codes and really it works fine for me. From the very first day since I have been using this, I always thought whether I can change the xml documentation as per my need or not.

Today I have found a simple trick to add to custom node to the xml commenting.

Here was my scenario,

All my method/class/event level comment must include author name along with the time when it was written.

For this I need to add the following lines in the Ghost Doc > Options > Custom Texts

XML
<author>$(Environment.UserName)</author>
<datetime>$(Environment.Date)-$(Environment.Time)</datetime>

Image 1

And the ghost doc generated comment contains author and datetime tag!!!

C#
///<summary>
/// Gets the user by ID.
///</summary>
///<param name="ID">The ID.</param>
///<returns></returns>
///<author>Mahmudul.Haque</author>
///<datetime>3/15/2010-11:23 AM</datetime>
private static User GetUserByID(long ID)
{
    User user = new User();
    return user;
}

License

This article, along with any associated source code and files, is licensed under The Common Development and Distribution License (CDDL)


Written By
Software Developer (Senior) Vizrt Bangladesh
Bangladesh Bangladesh
I am truly versatile and 360 degree Engineer having wide range of development experience in .NET and Java Platform. I am also proficient in system level programming in C++. To me technology is not at all a problem, it’s the client requirement that matters! That is I am ready and comfortable to use any technology to make the business of my client a success.

In my five years of experience I have the opportunities to work for fortune 500 companies of US and many renowned clients from Europe.

My Linkedin Profile: http://bd.linkedin.com/in/mahmudazad

Comments and Discussions

 
GeneralAtomineerUtils Pro Pin
Zot Williams1-Sep-10 19:23
Zot Williams1-Sep-10 19:23 
GeneralRe: AtomineerUtils Pro Pin
Mahmudul Haque Azad2-Sep-10 4:52
Mahmudul Haque Azad2-Sep-10 4:52 
GeneralNice article Pin
salmanzaman1-Apr-10 20:36
salmanzaman1-Apr-10 20:36 
GeneralRe: Nice article Pin
Mahmudul Haque Azad8-Apr-10 20:23
Mahmudul Haque Azad8-Apr-10 20:23 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.