1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005 <2006> 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018 2019 2020 2021 2022 2023 2024 | Index | 1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005 <2006> 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018 2019 2020 2021 2022 2023 2024 |
<== Date ==> | <== Thread ==> |
---|
Subject: | Re: EPICS source Documentation |
From: | Andrew Johnson <[email protected]> |
To: | David Dudley <[email protected]> |
Cc: | [email protected] |
Date: | Fri, 08 Sep 2006 15:32:27 -0500 |
I will agree, "... Code always tells the truth. Comments sometimes do not...". However, a little comment block here and there, saying something along the line of "... in this block, the code is intended to do <such - and -such...>, that sort of points you in the direction of where you want to go, even if the comment is not 100% direct, would be useful most of the time.
/* * this global variable exists in the nivxi library */
- Andrew -- There is considerable overlap between the intelligence of the smartest bears and the dumbest tourists -- Yosemite National Park Ranger