From 89f35b12149a1f969f1a4134bdb6a06b341e7719 Mon Sep 17 00:00:00 2001 From: Victor Toso Date: Wed, 20 Apr 2022 21:07:53 +0200 Subject: [PATCH] docstring: variable: Move docstring from source to header file virConnectAuthPtrDefault is the only variable that we export and with the documentation being at the C file, it makes harder to find it. With this patch, the documentation of this variable can be found by those who look at the header file for guidance plus, it will also be included in the XML API, as the followup patch will fix apibuild.py to store what is documented in the header file for this variable. Note that the apibuild, does not do the same with .c files. It'd require adding it for (parsing) recursion, similar to what is done for functions. Considering the pros/cons, seems more reasonable to move the docstring to the header file instead. Signed-off-by: Victor Toso Reviewed-by: Peter Krempa --- include/libvirt/libvirt-host.h | 12 ++++++++++++ src/libvirt.c | 11 +---------- 2 files changed, 13 insertions(+), 10 deletions(-) diff --git a/include/libvirt/libvirt-host.h b/include/libvirt/libvirt-host.h index 1dc4b8a147..99b34475ea 100644 --- a/include/libvirt/libvirt-host.h +++ b/include/libvirt/libvirt-host.h @@ -562,6 +562,18 @@ struct _virConnectAuth { typedef struct _virConnectAuth virConnectAuth; typedef virConnectAuth *virConnectAuthPtr; +/* + * virConnectAuthPtrDefault: + * + * A default implementation of the authentication callbacks. This + * implementation is suitable for command line based tools. It will + * prompt for username, passwords, realm and one time keys as needed. + * It will print on STDOUT, and read from STDIN. If this is not + * suitable for the application's needs an alternative implementation + * should be provided. + * + * Since: v0.4.1 + */ VIR_EXPORT_VAR virConnectAuthPtr virConnectAuthPtrDefault; /** diff --git a/src/libvirt.c b/src/libvirt.c index 45315f484c..6cda75d1ca 100644 --- a/src/libvirt.c +++ b/src/libvirt.c @@ -197,16 +197,7 @@ static virConnectAuth virConnectAuthDefault = { NULL, }; -/* - * virConnectAuthPtrDefault - * - * A default implementation of the authentication callbacks. This - * implementation is suitable for command line based tools. It will - * prompt for username, passwords, realm and one time keys as needed. - * It will print on STDOUT, and read from STDIN. If this is not - * suitable for the application's needs an alternative implementation - * should be provided. - */ +/* Explanation in the header file */ virConnectAuthPtr virConnectAuthPtrDefault = &virConnectAuthDefault; static bool virGlobalError;