>то второе — признак быдлокода.

от быдло-кодера слышу! Этож писец! Теперь что и в структурах не писать какие значения могут принимать члены? И граничные условия? И если реализация не полная, тоже ссылки не давать?
это чё, вот это head -50 /usr/src/linux-3.0-rc4/include/linux/superhyway.h
struct superhyway_vcr_info {
    u8    perr_flags;    /* P-port Error flags */
    u8    merr_flags;    /* Module Error flags */
    u16    mod_vers;    /* Module Version */
    u16    mod_id;        /* Module ID */
    u8    bot_mb;        /* Bottom Memory block */
    u8    top_mb;        /* Top Memory block */
};
уже быдло код? А по мне, так это пример хорошо документированного кода. Или этот
/usr/src/linux-3.0-rc4/drivers/parport/parport_serial.c
static int __devinit netmos_parallel_init(struct pci_dev *dev, struct parport_pc_pci *par, int autoirq, int autodma)
{
    /* the rule described below doesn't hold for this device */
    if (dev->device == PCI_DEVICE_ID_NETMOS_9835 &&
            dev->subsystem_vendor == PCI_VENDOR_ID_IBM &&
            dev->subsystem_device == 0x0299)
        return -ENODEV;
    /*
     * Netmos uses the subdevice ID to indicate the number of parallel
     * and serial ports.  The form is 0x00PS, where <P> is the number of
     * parallel ports and <S> is the number of serial ports.
     */
    par->numports = (dev->subsystem_device & 0xf0) >> 4;
и мне наплевать что об этом думают местные гении. Этот код отлично читается и без документации.