update comment according to the new DOM

git-svn-id: svn://svn.coreboot.org/coreboot/trunk@1799 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1

src/include/device/device.h

@@ -57,7 +57,8 @@ struct bus {
  */
 
 struct device {
-	struct bus *	bus;		/* bus this device is on */
+	struct bus *	bus;		/* bus this device is on, for bridge
+					 * devices, it is the up stream bus */
 	device_t	sibling;	/* next device on this bus */
 	device_t	next;		/* chain of all devices */
 
@@ -79,7 +80,10 @@ struct device {
 	struct resource resource[MAX_RESOURCES];
 	unsigned int resources;
 
+	/* link are (down sream) buses attached to the device, usually a leaf
+	 * device with no child have 0 bus attached and a bridge has 1 bus */
 	struct bus link[MAX_LINKS];
+	/* number of buses attached to the device */
 	unsigned int links;
 
 	unsigned long rom_address;

src/include/device/pci.h

@@ -23,6 +23,7 @@
 
 /* Common pci operations without a standard interface */
 struct pci_operations {
+	/* set the Subsystem IDs for the PCI device */
 	void (*set_subsystem)(device_t dev, unsigned vendor, unsigned device);
 };