Changeset 36203 in vbox

Timestamp:

Mar 8, 2011 1:02:03 PM (14 years ago)

Author:

vboxsync

Message:

don't use doxygen comments to document code sections, they'll end up in the function description.

File:

• trunk/src/VBox/Devices/Bus/DevPciIch9.cpp (modified) (12 diffs)

trunk/src/VBox/Devices/Bus/DevPciIch9.cpp

@@ -1 +1 @@
 /* $Id$ */
 /** @file
- * DevPCI - ICH9 southbridge PCI bus emulation Device.
+ * DevPCI - ICH9 southbridge PCI bus emulation device.
  */
 
 /*
- * Copyright (C) 2010 Oracle Corporation
+ * Copyright (C) 2010-2011 Oracle Corporation
  *
  * This file is part of VirtualBox Open Source Edition (OSE), as
@@ -17 +17 @@
 
 /*******************************************************************************
- *   Header Files                                                              *
- *******************************************************************************/
+*   Header Files                                                               *
+*******************************************************************************/
 #define LOG_GROUP LOG_GROUP_DEV_PCI
 /* Hack to get PCIDEVICEINT declare at the right point - include "PCIInternal.h". */
@@ -36 +36 @@
 #include "MsiCommon.h"
 
+
+/*******************************************************************************
+*   Structures and Typedefs                                                    *
+*******************************************************************************/
 /**
  * PCI Bus instance.
@@ -118 +122 @@
 
 
-typedef struct {
+typedef struct
+{
     uint8_t  iBus;
     uint8_t  iDeviceFunc;
@@ -124 +129 @@
 } PciAddress;
 
+
 /*******************************************************************************
- *   Defined Constants And Macros                                              *
- *******************************************************************************/
+*   Defined Constants And Macros                                               *
+*******************************************************************************/
 
 /** @def VBOX_ICH9PCI_SAVED_STATE_VERSION
@@ -141 +147 @@
 /** Converts a device instance pointer to a PCIBUS pointer. */
 #define DEVINS_2_PCIBUS(pDevIns)        ((PPCIBUS)(&PDMINS_2_DATA(pDevIns, PPCIGLOBALS)->aPciBus))
-/** Converts a pointer to a PCI root bus instance to a PCIGLOBALS pointer.
- */
+/** Converts a pointer to a PCI root bus instance to a PCIGLOBALS pointer. */
 #define PCIROOTBUS_2_PCIGLOBALS(pPciBus)    ( (PPCIGLOBALS)((uintptr_t)(pPciBus) - RT_OFFSETOF(PCIGLOBALS, aPciBus)) )
 
@@ -553 +558 @@
         if ((iLevel & PDM_IRQ_LEVEL_FLIP_FLOP) == PDM_IRQ_LEVEL_FLIP_FLOP)
         {
-            /**
+            /*
              *  we raised it few lines above, as PDM_IRQ_LEVEL_FLIP_FLOP has
              * PDM_IRQ_LEVEL_HIGH bit set
@@ -1850 +1855 @@
     pGlobals->uBus = 0;
 
-    /**
+    /*
      * Assign bridge topology, for further routing to work.
      */
@@ -1856 +1861 @@
     ich9pciInitBridgeTopology(pGlobals, pBus);
 
-    /**
+    /*
      * Init the devices.
      */
@@ -1941 +1946 @@
     PCIDevSetByte(aDev, uAddr, u8Val);
 }
+
 /**
  * See paragraph 7.5 of PCI Express specification (p. 349) for definition of
@@ -2278 +2284 @@
             printIndent(pHlp, iIndent);
 
-            /**
+            /*
              * For passthrough devices MSI/MSI-X mostly reflects the way interrupts delivered to the guest,
              * as host driver handles real devices interrupts.
@@ -2493 +2499 @@
      */
 
-    /**
+    /*
      * We emulate 82801IB ICH9 IO chip used in Q35,
      * see http://ark.intel.com/Product.aspx?id=31892