Difference between revisions of "Comment Conventions"
Jump to navigation
Jump to search
Line 13: | Line 13: | ||
* abr - Adam Roach <adam@nostrum.com> | * abr - Adam Roach <adam@nostrum.com> | ||
* ah - Alan Hawrylyshen <alan@jasomi.com> | * ah - Alan Hawrylyshen <alan@jasomi.com> | ||
− | |||
* cj - Cullen Jennings <fluffy@cisco.com> | * cj - Cullen Jennings <fluffy@cisco.com> | ||
* dcm - Derek McDonald <derek@xten.com> | * dcm - Derek McDonald <derek@xten.com> |
Revision as of 12:06, 16 June 2005
Inside the resip, dum, and repro code, you'll often come across comments that look something like this:
// !abc! This needs to be updated to handle timeouts
The tag that precedes the comment (!abc! in this example) represents which developer inserted the comment, and the nature of the comment. These come in three flavors:
- // !abc! - This comment calls out something that needs to be fixed
- // ?abc? - This comment asks a question; feel free to contact the comment author if you know the answer to the question.
- // .abc. - This is simply an attributed comment
The initials that you'll find in the code currently include:
* abr - Adam Roach <adam@nostrum.com> * ah - Alan Hawrylyshen <alan@jasomi.com> * cj - Cullen Jennings <fluffy@cisco.com> * dcm - Derek McDonald <derek@xten.com> * dlb - David Butcher <david@pss.com> * jf - Jason Fischl <jason@iii.ca> * kh - Ken Ho <kenho@teltel.com> * kk - Ken Kittlitz * RjS - Robert Sparks <rjs@nostrum.com> * rk - Ryan Kereliuk <ryker@ryker.org> * rm - Rohan Mahy <rohan@ekabal.com> * rwm - Rohan Mahy <rohan@ekabal.com> * slg - Scott Godin <slgodin@icescape.com>