Total, embarassing noob here, so here goes nothing: if you wanted to create a karma-based reputation system that treated user comments pretty much the way Slashdot does, but slashcode had never been invented, how would you go about it? Is there an OpenSource CMS that comes close to doing this? ...
I'm trying to use jQuery to identify <td> elements which contain specific HTML comment text. The standard ":contains" selector doesn't seem to be looking into the comments. My context here is that I want to dynamically add some content to that same td element. Here's a sample of the target td: <TD valign="top" class="ms-formbody" wid...
I need a way to add text comments in "Word style" to a Latex document? I don't mean to comment the "source code" of the document. What I want is a way to add corrections, suggestions, etc. to the document, so that they don't interrupt the text flow, but still easy for everyone to know, which part of the sentence they are related to. They...
Hi, I need to embed a comment box on pages for this site i'm working on. Basically, a box where you can leave your comment, and that displays other's comments. Backend should include basic moderation options. We have little control over the code of the page, and therefore we're looking into 3rd party widget. Ideally, something that is s...
I never decided on what the best way is to comment IF-THEN-ELSE constructs, so I never standardized on a consistent way to comment them. I appreciate any insights. Some options: a) IF (blabla) { // this comment explains what happens in the IF case dothis(); } else { // this comment explains what happens in the ELSE case d...
I like to generate man pages using '--help' output via help2man and txt2man. Ruby's RDoc system is very convenient, but I can't seem to configure RDoc::usage in exactly the way that I want. Here's a sample script: #!/usr/bin/env ruby # # === Name # # foobar - Example command for StackOverflow question # # === Synopsis # # Usage: fo...
I have a need to include */ in my JavaDoc comment. The problem is that this is also the same sequence for closing a comment. What the proper way to quote/escape this? Example: /** * Returns true if the specified string contains "*/". */ public boolean containsSpecialSequence(String str) Follow up: It appears I can use / for the...
I have worked a few places which haven’t used source control. They seemed to get into the habit of putting comments around code they changed explaining the change so that things could be reverted. I have found that this makes the code very difficult to read, and have been fairly adamant that such comments are not needed after introduci...
Which is more practical to comment, the declaration (in the header file) or the definition (in the source file)? Maybe I should comment both, or comment neither and put it all in a separate file... ...
Since when did: //echo "[$sql][$result][$rows][$e]<BR>"; cause an error? The code following this comment gets spwewed out as source in the browser! Bear in mind I use php daily, I've never seen this before! I'm porting an ancient php app from an old Win2k box to a new Windoze 2003 server - apache 2.2, mysql 5.1.32, php 5.2.9, and the ...
Hi everyone, I've been banging my head against a wall trying make this work for a while now. I'm trying to shorten the comment body to one line for compact comment preview. I'm using jquery .each function to go through each .cbody (comment body) in my threaded comment system and place it in the cshort div inside chead. It should work but...
Hi, I have my web site with a blog (created in blogengine), but i need to integrate a comment system to the site away from the blog. for example i have different modules to manage news and events and i want visitors to leave their comments for the modules (for difreent news and events). Is there any system (.net 2.0) to do this or i ne...
What is the most prohibitive aspect of having a universal comment identifier for all .net languages? For example, in each language the symbol "??" would identify a comment. (I'm not saying that it should be "??"... just an example.) ...
Is there any site for technical books reviews and comments. So that it is very useful before reading the book. ...
In my page source I put: <!-- A comment --------> and ASP.Net converts it to: <!-- A comment --------> so by the time it gets to the browser, my comment is visible. It doesn't do it to all comments and if I add in another comment it sometimes makes the comment go away. Anyone seen this before? How can I fix it? ...
I'm not sure if this can be done at all, but it'd certainly make my life easier. I was wondering if maybe the MS spellchecker could be used as a plug-in for other applications... or something like that. Thanks. ...
I'm doing some home-brewed automated documentation, since I have a codebase which is not very standard in its layout, and I was wondering what the best way was to read a PHP file and grab the contents of a comment block. The only way I can think to do it is to open the file and read it line-by-line, but thought that maybe there was some ...
I have generated an Interface which is very well documented. Every method does have his own JavaDoc. The clases which implement this Interface can have little differents in their logic. How can i add JavaDoc to the existing JavaDoc from the super class. The key word /** * {@inheritDoc} */ only set the javaDoc of the super class to...
Many corporate coding standards require a large comment header and footer in each and every file. Something like: // MyFile.cpp // // Copyright (c) 200x Company ABC // // This file is a copyrighted... blah blah blah // <... some code ...> // Copyright (c) 200x Company ABC // // Change history: // 1.0 - Blah // 1.1 - B...
I have notice a trend for developers to comment their changes less with the justification that the purpose/date/reason is in the changelog. They have some very justifiable claims that duplication of effort is occuring if we require both. I am spending some serious amount of time tracking down changes. No specific direction has been giv...