You sometimes see comments for this, e.g. int foo(int aX, /* out */ char* aS);
If we recommended/required this, it might make the interregnum period problem smaller? Nick On Fri, Dec 5, 2014 at 1:31 PM, Robert O'Callahan <rob...@ocallahan.org> wrote: > On Fri, Dec 5, 2014 at 12:08 PM, Seth Fowler <s...@mozilla.com> wrote: > >> Well, converting all existing code to use this convention overnight >> definitely wouldn’t be worth it. And just adding this to the style guide >> will give us very little benefit *right now*. But I think if we add this to >> the coding style guide and convert things gradually in a pragmatic fashion >> - when we write new code, when we touch old code that doesn’t use the >> convention, and perhaps when we encounter an unclear method definition in >> the course of our work - a year or two down the road it may be common >> enough that we get significant benefits from the change. >> > > The interregnum period creates confusion in the minds of developers, who > for example may not know whether to use "o" per the style guide or "a" to > be consistent with surrounding code. This is a cost. I think in the past > we've underestimated the costs of incomplete transitions in coding style. > > Rob > -- > oIo otoeololo oyooouo otohoaoto oaonoyooonoeo owohooo oioso oaonogoroyo > owoiotoho oao oboroootohoeoro oooro osoiosotoeoro owoiololo oboeo > osouobojoeocoto otooo ojouodogomoeonoto.o oAogoaoiono,o oaonoyooonoeo > owohooo > osoaoyoso otooo oao oboroootohoeoro oooro osoiosotoeoro,o o‘oRoaocoao,o’o > oioso > oaonosowoeoroaoboloeo otooo otohoeo ocooouoroto.o oAonodo oaonoyooonoeo > owohooo > osoaoyoso,o o‘oYooouo ofooooolo!o’o owoiololo oboeo oiono odoaonogoeoro > ooofo > otohoeo ofoioroeo ooofo ohoeololo. > _______________________________________________ > dev-platform mailing list > dev-platform@lists.mozilla.org > https://lists.mozilla.org/listinfo/dev-platform _______________________________________________ dev-platform mailing list dev-platform@lists.mozilla.org https://lists.mozilla.org/listinfo/dev-platform
