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>
This commit is contained in:
Erik Skultety 2017-10-17 09:34:55 +02:00
parent b08017ca54
commit 15a37cdf88
9 changed files with 0 additions and 88 deletions

View File

@ -3750,10 +3750,6 @@ remoteDispatchAuthPolkit(virNetServerPtr server,
} }
/***************************************************************
* NODE INFO APIS
**************************************************************/
static int static int
remoteDispatchNodeDeviceGetParent(virNetServerPtr server ATTRIBUTE_UNUSED, remoteDispatchNodeDeviceGetParent(virNetServerPtr server ATTRIBUTE_UNUSED,
virNetServerClientPtr client ATTRIBUTE_UNUSED, virNetServerClientPtr client ATTRIBUTE_UNUSED,
@ -3864,9 +3860,6 @@ remoteDispatchConnectUnregisterCloseCallback(virNetServerPtr server ATTRIBUTE_UN
return rv; return rv;
} }
/***************************
* Register / deregister events
***************************/
static int static int
remoteDispatchConnectDomainEventRegister(virNetServerPtr server ATTRIBUTE_UNUSED, remoteDispatchConnectDomainEventRegister(virNetServerPtr server ATTRIBUTE_UNUSED,
virNetServerClientPtr client, virNetServerClientPtr client,

View File

@ -4286,8 +4286,6 @@ networkRegister(void)
} }
/********************************************************/
/* A unified function to log network connections and disconnections */ /* A unified function to log network connections and disconnections */
static void static void

View File

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

View File

@ -27,11 +27,6 @@
extern virErrorFunc virErrorHandler; extern virErrorFunc virErrorHandler;
extern void *virUserData; extern void *virUserData;
/************************************************************************
* *
* API for error handling *
* *
************************************************************************/
int virErrorInitialize(void); int virErrorInitialize(void);
void virRaiseErrorFull(const char *filename, void virRaiseErrorFull(const char *filename,
const char *funcname, const char *funcname,

View File

@ -50,12 +50,6 @@ struct virParserData {
}; };
/************************************************************************
* *
* Wrappers around libxml2 XPath specific functions *
* *
************************************************************************/
/** /**
* virXPathString: * virXPathString:
* @xpath: the XPath string to evaluate * @xpath: the XPath string to evaluate

View File

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

View File

@ -1122,17 +1122,6 @@ sexpr_to_domain(virConnectPtr conn ATTRIBUTE_UNUSED, const struct sexpr *root)
} }
/*****************************************************************
******
******
******
******
Refactored
******
******
******
******
*****************************************************************/
/** /**
* xenDaemonOpen: * xenDaemonOpen:
* @conn: an existing virtual connection block * @conn: an existing virtual connection block

View File

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

View File

@ -70,11 +70,6 @@ int xenGetDomIdFromSxpr(const struct sexpr *root, int *id)
return 0; return 0;
} }
/*****************************************************************
******
****** Parsing of S-Expression into virDomainDef objects
******
*****************************************************************/
/** /**
* xenParseSxprOS: * xenParseSxprOS: