I recently had to find out how to feed parameters to modules during boot, and found that they go in /etc/modules.d/blah (alsa in this case). What I noticed was that there was no documentation for the format of this file, and except for a few small references here and there (alsa guide does in fact make a little mention of troubleshooting by looking in that file), there isn't any general documentation that tells users how to configure modules. What I propose is: 1) either write up a section in some administrative/post install doc on kernel modules and how they are handled 2) or at least add a README in /etc/modules.d/, or put some kind of helpful comments in the files in that directory Reproducible: Always
That's general Linux information, not Gentoo-specific. We do have a few kernel documents that you may want to read in http://www.gentoo.org/doc/en/list.xml, but we don't do things like READMEs; you'd need to bug Gentoo's ALSA maintainers on README files or messages printed out by ebuilds. Otherwise, upstream ALSA documentation at alsa-project.org is where you should look; it has suggested settings for just about every single driver available.
what's wrong with `man modprobe.d` ?