maint: Remove not-so-much informative block commentaries

There were a bunch of commentary blocks that were literally useless in
terms of describing what the code following them does, since most of
them were documenting "the obvious" or it just wouldn't help at all.

Signed-off-by: Erik Skultety <eskultet@redhat.com>

diff --git a/daemon/remote.c b/daemon/remote.c
index fd854212003c51a390bd88389faf7892ed96def4..3f7d2d344022d34e83a1a3fce78deb8fef3933f6 100644 (file)
--- a/daemon/remote.c
+++ b/daemon/remote.c
@@ -3750,10 +3750,6 @@ remoteDispatchAuthPolkit(virNetServerPtr server,
 }
 
 
-/***************************************************************
- *     NODE INFO APIS
- **************************************************************/
-
 static int
 remoteDispatchNodeDeviceGetParent(virNetServerPtr server ATTRIBUTE_UNUSED,
                                   virNetServerClientPtr client ATTRIBUTE_UNUSED,
@@ -3864,9 +3860,6 @@ remoteDispatchConnectUnregisterCloseCallback(virNetServerPtr server ATTRIBUTE_UN
     return rv;
 }
 
-/***************************
- * Register / deregister events
- ***************************/
 static int
 remoteDispatchConnectDomainEventRegister(virNetServerPtr server ATTRIBUTE_UNUSED,
                                          virNetServerClientPtr client,

diff --git a/src/network/bridge_driver.c b/src/network/bridge_driver.c
index 530d00ff3689ca255ae0419a8ef1e1c8f16ceeed..fcaa66df91c761713b6e764900eefeec0b6bdc5b 100644 (file)
--- a/src/network/bridge_driver.c
+++ b/src/network/bridge_driver.c
@@ -4286,8 +4286,6 @@ networkRegister(void)
 }
 
 
-/********************************************************/
-
 /* A unified function to log network connections and disconnections */
 
 static void

diff --git a/src/util/virconf.c b/src/util/virconf.c
index b5f6e5b8c7995e0964bf040d4766406e111cd07b..5822ee45eb7bf67acebe70479e93f0b3aa0ea920 100644 (file)
--- a/src/util/virconf.c
+++ b/src/util/virconf.c
@@ -44,12 +44,6 @@
 
 VIR_LOG_INIT("util.conf");
 
-/************************************************************************
- *                                                                     *
- *     Structures and macros used by the mini parser                   *
- *                                                                     *
- ************************************************************************/
-
 typedef struct _virConfParserCtxt virConfParserCtxt;
 typedef virConfParserCtxt *virConfParserCtxtPtr;
 
@@ -75,12 +69,6 @@ struct _virConfParserCtxt {
   do { while ((ctxt->cur < ctxt->end) && (c_isblank(CUR)))              \
           ctxt->cur++; } while (0)
 
-/************************************************************************
- *                                                                     *
- *             Structures used by configuration data                   *
- *                                                                     *
- ************************************************************************/
-
 VIR_ENUM_IMPL(virConf, VIR_CONF_LAST,
               "*unexpected*",
               "long",
@@ -133,12 +121,6 @@ virConfErrorHelper(const char *file, const char *func, size_t line,
 }
 
 
-/************************************************************************
- *                                                                     *
- *             Structures allocations and deallocations                *
- *                                                                     *
- ************************************************************************/
-
 /**
  * virConfFreeList:
  * @list: the list to free
@@ -260,11 +242,6 @@ virConfAddEntry(virConfPtr conf, char *name, virConfValuePtr value, char *comm)
     return ret;
 }
 
-/************************************************************************
- *                                                                     *
- *                     Serialization                                   *
- *                                                                     *
- ************************************************************************/
 
 /**
  * virConfSaveValue:
@@ -353,11 +330,6 @@ virConfSaveEntry(virBufferPtr buf, virConfEntryPtr cur)
     return 0;
 }
 
-/************************************************************************
- *                                                                     *
- *                     The parser core                                 *
- *                                                                     *
- ************************************************************************/
 
 /**
  * virConfParseLong:
@@ -754,11 +726,6 @@ virConfParse(const char *filename, const char *content, int len,
     return NULL;
 }
 
-/************************************************************************
- *                                                                     *
- *                     The module entry points                         *
- *                                                                     *
- ************************************************************************/
 
 /* 10 MB limit on config file size as a sanity check */
 #define MAX_CONFIG_FILE_SIZE (1024*1024*10)

diff --git a/src/util/virerror.h b/src/util/virerror.h
index 54530d081175eb25ba6628b8dfd55f1dc0a28aba..3201d5cec68cc8ee8b5d830e8a6ee2a900fde3ec 100644 (file)
--- a/src/util/virerror.h
+++ b/src/util/virerror.h
@@ -27,11 +27,6 @@
 extern virErrorFunc virErrorHandler;
 extern void *virUserData;
 
-/************************************************************************
- *                                                                     *
- *             API for error handling                                  *
- *                                                                     *
- ************************************************************************/
 int virErrorInitialize(void);
 void virRaiseErrorFull(const char *filename,
                        const char *funcname,

diff --git a/src/util/virxml.c b/src/util/virxml.c
index 5ce2b0b0dde06a71a84d4b2dc0e3680aacdfa2ec..1ff1e36536d09841bbdb7033664dea6cb131d9eb 100644 (file)
--- a/src/util/virxml.c
+++ b/src/util/virxml.c
@@ -50,12 +50,6 @@ struct virParserData {
 };
 
 
-/************************************************************************
- *                                                                     *
- * Wrappers around libxml2 XPath specific functions                    *
- *                                                                     *
- ************************************************************************/
-
 /**
  * virXPathString:
  * @xpath: the XPath string to evaluate

diff --git a/src/vbox/vbox_XPCOMCGlue.c b/src/vbox/vbox_XPCOMCGlue.c
index ff03279ed1ad357b8fecd361ffbeb2f2c4c89a56..cae6d0c626e846f84f644546d2469978002daaec 100644 (file)
--- a/src/vbox/vbox_XPCOMCGlue.c
+++ b/src/vbox/vbox_XPCOMCGlue.c
@@ -26,9 +26,6 @@
  * additional information or have any questions.
  */
 
-/*******************************************************************************
-*   Header Files                                                               *
-*******************************************************************************/
 
 #include <config.h>
 
@@ -48,9 +45,6 @@
 
 VIR_LOG_INIT("vbox.vbox_XPCOMCGlue");
 
-/*******************************************************************************
-*   Defined Constants And Macros                                               *
-*******************************************************************************/
 #if defined(__linux__) || defined(__linux_gnu__) || defined(__sun__) || \
     defined(__FreeBSD__) || defined(__OpenBSD__) || \
     defined(__FreeBSD_kernel__)
@@ -64,9 +58,6 @@ VIR_LOG_INIT("vbox.vbox_XPCOMCGlue");
 #endif
 
 
-/*******************************************************************************
-*   Global Variables                                                           *
-*******************************************************************************/
 /** The dlopen handle for VBoxXPCOMC. */
 static void *hVBoxXPCOMC;
 /** Pointer to the VBoxXPCOMC function table. */

diff --git a/src/xen/xend_internal.c b/src/xen/xend_internal.c
index ccb1478b397193233e749c42d8b1df62fce385b0..e4edfd6f8afd0c309ceebed56b388e7e8aeab9e5 100644 (file)
--- a/src/xen/xend_internal.c
+++ b/src/xen/xend_internal.c
@@ -1122,17 +1122,6 @@ sexpr_to_domain(virConnectPtr conn ATTRIBUTE_UNUSED, const struct sexpr *root)
 }
 
 
-/*****************************************************************
- ******
- ******
- ******
- ******
-             Refactored
- ******
- ******
- ******
- ******
- *****************************************************************/
 /**
  * xenDaemonOpen:
  * @conn: an existing virtual connection block

diff --git a/src/xen/xs_internal.c b/src/xen/xs_internal.c
index e448968f7578f171b0f5b3a54e7262a921511651..353169da05254a9921a8aa5a9b77e5d33c83b994 100644 (file)
--- a/src/xen/xs_internal.c
+++ b/src/xen/xs_internal.c
@@ -59,11 +59,6 @@ VIR_LOG_INIT("xen.xs_internal");
 static void xenStoreWatchEvent(int watch, int fd, int events, void *data);
 static void xenStoreWatchListFree(xenStoreWatchListPtr list);
 
-/************************************************************************
- *                                                                     *
- *             Helper internal APIs                                    *
- *                                                                     *
- ************************************************************************/
 
 /**
  * virDomainDoStoreQuery:
@@ -91,11 +86,6 @@ virDomainDoStoreQuery(virConnectPtr conn, int domid, const char *path)
     return xs_read(priv->xshandle, 0, &s[0], &len);
 }
 
-/************************************************************************
- *                                                                     *
- *             Canonical internal APIs                                 *
- *                                                                     *
- ************************************************************************/
 /**
  * xenStoreOpen:
  * @conn: pointer to the connection block

diff --git a/src/xenconfig/xen_sxpr.c b/src/xenconfig/xen_sxpr.c
index fefa61ac23c9a37d1b8157528d5266891acadd7d..358d0cbef9c98f012d1adf57d9f25d303169688c 100644 (file)
--- a/src/xenconfig/xen_sxpr.c
+++ b/src/xenconfig/xen_sxpr.c
@@ -70,11 +70,6 @@ int xenGetDomIdFromSxpr(const struct sexpr *root, int *id)
     return 0;
 }
 
-/*****************************************************************
- ******
- ****** Parsing of S-Expression into virDomainDef objects
- ******
- *****************************************************************/
 
 /**
  * xenParseSxprOS: