From mboxrd@z Thu Jan 1 00:00:00 1970 From: Marek Vasut Date: Mon, 1 Oct 2012 11:07:44 +0200 Subject: [U-Boot] KernelDoc In-Reply-To: <20121001085458.850A3202C80@gemini.denx.de> References: <201209252246.10322.marex@denx.de> <201209270138.12860.marex@denx.de> <20121001085458.850A3202C80@gemini.denx.de> Message-ID: <201210011107.45164.marex@denx.de> List-Id: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit To: u-boot@lists.denx.de Dear Wolfgang Denk, > Dear Marek Vasut, > > In message <201209270138.12860.marex@denx.de> you wrote: > > > I think is kind of unfair to expect such efforts for some basicly > > > unrelated changes. If I were in such a situation, I'd feel tempted to > > > throw the towel. > > > > Why would you do so ... you change interface, you document it. > > Having to document not only my change, but all the rest of the source > file as well may mean I spend way more work on this doc task than on > the actual fix. > > And while I may well understand the area I meddled with, I may not > easily understand the rest of the code, so this is twice hard and time > consuming. Agreed, not the whole file. But, can you check the rules I tried to outline? > Best regards, > > Wolfgang Denk Best regards, Marek Vasut