On Thu, Apr 06, 2006 at 09:57:06PM -0600, Eric Blake wrote: > According to Noah Misch on 4/5/2006 8:10 AM: > >> * lib/m4sugar/m4sh.m4 (AS_SHELL_SANITIZE, AS_MESSAGE, AS_WARN) > >> (AS_ERROR, AS_MKDIR_P, _AS_DIRNAME_PREPARE, _AS_MKDIR_P_PREPARE) > >> (_AS_TR_*PREPARE): Improve documentation. > > > > These changes don't clarify much. > > Is it worth resending that as a separate patch, so that all functions in > m4sh.m4 are consistently documented? For now, I am not resubmitting > without further consensus.
It's fine if some macros have no documentation comment beyond a prototype. We shouldn't add one for its own sake.
