Patchwork [8/8] pci_bus: update comment

login
register
mail settings
Submitter Michael S. Tsirkin
Date Dec. 12, 2012, 1:14 p.m.
Message ID <11139c91ed928db43f1083831a57878faa58ac14.1355318011.git.mst@redhat.com>
Download mbox | patch
Permalink /patch/205528/
State New
Headers show

Comments

Michael S. Tsirkin - Dec. 12, 2012, 1:14 p.m.
Don't ask everyone to desist from including this header,
simply recommend using accessors.

Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
---
 hw/pci/pci_bus.h | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

Patch

diff --git a/hw/pci/pci_bus.h b/hw/pci/pci_bus.h
index 21d0ce6..8217f61 100644
--- a/hw/pci/pci_bus.h
+++ b/hw/pci/pci_bus.h
@@ -2,14 +2,10 @@ 
 #define QEMU_PCI_INTERNALS_H
 
 /*
- * This header files is private to pci.c and pci_bridge.c
- * So following structures are opaque to others and shouldn't be
- * accessed.
+ * PCI Bus and Bridge datastructures.
  *
- * For pci-to-pci bridge needs to include this header file to embed
- * PCIBridge in its structure or to get sizeof(PCIBridge),
- * However, they shouldn't access those following members directly.
- * Use accessor function in pci.h, pci_bridge.h
+ * Do not access the following members directly;
+ * use accessor functions in pci.h, pci_bridge.h
  */
 
 #define TYPE_PCI_BUS "PCI"