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
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,

View File

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

View File

@ -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)

View File

@ -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,

View File

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

View File

@ -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. */

View File

@ -1122,17 +1122,6 @@ sexpr_to_domain(virConnectPtr conn ATTRIBUTE_UNUSED, const struct sexpr *root)
}
/*****************************************************************
******
******
******
******
Refactored
******
******
******
******
*****************************************************************/
/**
* xenDaemonOpen:
* @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 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

View File

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