There are the man pages interfaces(5), vlan-interfaces(5), bridge-utils-interfaces(5) and maybe others (that's what I get fron a `ls /usr/share/man/man5/*interfaces*` on my system). But there's no ifenslave-interfaces(5) describing the bond-* options.
The only canonical documentation seem to be the ifupdown scripts and the examples and Google. This should be fixed :)
ProblemType: Bug
DistroRelease: Ubuntu 12.04
Package: ifenslave-2.6 1.1.0-19ubuntu5
ProcVersionSignature: Ubuntu 3.2.0-38.61-generic 3.2.37
Uname: Linux 3.2.0-38-generic x86_64
NonfreeKernelModules: fglrx
ApportVersion: 2.0.1-0ubuntu17.1
Architecture: amd64
Date: Thu Feb 21 12:43:48 2013
InstallationMedia: Kubuntu 11.10 "Oneiric Ocelot" - Release amd64 (20111011)
MarkForUpload: True
ProcEnviron:
LANGUAGE=en_US
TERM=xterm
PATH=(custom, no user)
LANG=en_US.UTF-8
SHELL=/bin/bash
SourcePackage: ifenslave-2.6
UpgradeStatus: Upgraded to precise on 2012-04-29 (297 days ago)
It's a little more than wishlist, I would argue - I can find *no* canonical, working documentation for the bonding options. bond-master versus bond-slave, allow-bond0, etc. - nothing quite seems to work as expected, because I'm guessing, because I'm googling and getting documentation over a span for many years and many releases. I could be hitting bugs that are causing my problems, but I don't know, because the documentation is *that* bad.