Re: Documentation of kernel messages (Summary)

I find "document messages" to be a horrible idea conceptually, because I think
the messages should _be_ documentation. If the message is unclear it should
be clarified. "There's too much garbage on the floor, we should laminate it
so we can't smell it anymore." Er, no...

"Document message" is for the cases where the message itself does not convey
enough info.
No need to add more text when the initial message is good enough.

Sam
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/

Relevant Pages

  • Re: Narrative Summary and Transitions
    ... >> documentation he could find: four large estage ledgers he had to lift ... That's internalization, ... >children playing in the distance, ... > not to slip in his haste on the freshly polished floor. ...
    (rec.arts.sf.composition)
  • Re: Universal method to start a script at boot
    ... gets this info from filenames. ... documentation, ... send the line "unsubscribe linux-kernel" in ... More majordomo info at http://vger.kernel.org/majordomo-info.html ...
    (Linux-Kernel)
  • Re: Help Needed: Tape Backup Save Set
    ... > couple of feet onto the floor! ... Warning, you may have leftover from a special VMS 5.0 install kit that ... case, documentation should be available on the net somwhere, look for ...
    (comp.os.vms)
  • Re: [patch 00/2] improve .text size on gcc 4.0 and newer compilers
    ... documentation. ... Think "go faster stripes" etc. ... Alan ... More majordomo info at http://vger.kernel.org/majordomo-info.html ...
    (Linux-Kernel)
  • Re: [RESEND][RFC PATCH v2] waitfd
    ... *please* don't submit a patch for a system call without also ... and some attempt at userspace documentation. ... More majordomo info at http://vger.kernel.org/majordomo-info.html ... Please read the FAQ at http://www.tux.org/lkml/ ...
    (Linux-Kernel)