Send patches - preferably formatted by git format-patch - to patches at archlinux32 dot org.
summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authormorganamilo <morganamilo@archlinux.org>2020-12-29 11:54:56 +1000
committerAllan McRae <allan@archlinux.org>2021-01-09 00:15:18 +1000
commit8fda300e069315ea8ddb8fbc822addf4431da436 (patch)
tree0862574ee5599f2de2c3c78bfad2b9b6c0b2ef71 /lib
parent45a648961b2d9d5ac4a217e783c446f14ba3a82b (diff)
doc: change group names to libalpm_*
Also change the group's title to point to the group's man page. This makes generated man pages be named libalpm_* which is more consistent with what library man pages are usually called. Signed-off-by: Allan McRae <allan@archlinux.org>
Diffstat (limited to 'lib')
-rw-r--r--lib/libalpm/alpm.h42
-rw-r--r--lib/libalpm/alpm_list.h17
2 files changed, 23 insertions, 36 deletions
diff --git a/lib/libalpm/alpm.h b/lib/libalpm/alpm.h
index dd0036f8..171cf740 100644
--- a/lib/libalpm/alpm.h
+++ b/lib/libalpm/alpm.h
@@ -21,11 +21,6 @@
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
-/**
- * @file alpm.h
- * @author Pacman Development Team
- * @brief Arch Linux Package Manager Library
- */
/** @mainpage alpm
*
@@ -49,10 +44,15 @@ extern "C" {
#include <alpm_list.h>
-/** @addtogroup alpm The libalpm Public API
+/** @addtogroup libalpm The libalpm Public API
+ *
+ *
+ *
+ * libalpm is a package management library, primaraly used by
+ * For ease of access, the libalpm manual has been split up into several sections.
*
* @section see_also See Also
- * \b alpm_list(3),
+ * \b libalpm_list(3),
* \b alpm-hooks(5),
* \b makepkg(8),
* \b pacman(8),
@@ -67,7 +67,7 @@ extern "C" {
/** The libalpm context handle.
*
* This struct represents an instance of libalpm.
- * @ingroup alpm_handle
+ * @ingroup libalpm_handle
*/
typedef struct __alpm_handle_t alpm_handle_t;
@@ -87,7 +87,7 @@ typedef struct __alpm_handle_t alpm_handle_t;
* the user. They will be freed when the database is unregistered.
*
* Databases are automatically unregistered when the \link alpm_handle_t \endlink is released.
- * @ingroup alpm_databases
+ * @ingroup libalpm_databases
*/
typedef struct __alpm_db_t alpm_db_t;
@@ -100,21 +100,21 @@ typedef struct __alpm_db_t alpm_db_t;
*
* Packages can then be queried for metadata or added to a \link alpm_trans_t transaction \endlink
* to be added or removed from the system.
- * @ingroup alpm_packages
+ * @ingroup libalpm_packages
*/
typedef struct __alpm_pkg_t alpm_pkg_t;
/** Transaction structure used internally by libalpm
- * @ingroup alpm_trans
+ * @ingroup libalpm_trans
* */
typedef struct __alpm_trans_t alpm_trans_t;
/** The time type used by libalpm. Represents a unix time stamp
- * @ingroup alpm_misc */
+ * @ingroup libalpm_misc */
typedef int64_t alpm_time_t;
-/** @addtogroup alpm_files Files
+/** @addtogroup libalpm_files Files
* @brief Functions for package files
* @{
*/
@@ -159,7 +159,7 @@ alpm_file_t *alpm_filelist_contains(alpm_filelist_t *filelist, const char *path)
/** @} */
-/** @addtogroup alpm_groups Groups
+/** @addtogroup libalpm_groups Groups
* @brief Functions for package groups
* @{
*/
@@ -185,7 +185,7 @@ alpm_list_t *alpm_find_group_pkgs(alpm_list_t *dbs, const char *name);
/** @} */
-/** @addtogroup alpm_errors Error Codes
+/** @addtogroup libalpm_errors Error Codes
* Error codes returned by libalpm.
* @{
*/
@@ -359,7 +359,7 @@ int alpm_release(alpm_handle_t *handle);
/** @} */
-/** @addtogroup alpm_sig Signature checking
+/** @addtogroup libalpm_sig Signature checking
* @brief Functions to check signatures
* @{
*/
@@ -525,7 +525,7 @@ int alpm_extract_keyid(alpm_handle_t *handle, const char *identifier,
/** @} */
-/** @addtogroup alpm_depends Dependency
+/** @addtogroup libalpm_depends Dependency
* @brief Functions dealing with libalpm's dependency and conflict
* information.
* @{
@@ -1208,7 +1208,7 @@ typedef int (*alpm_cb_fetch)(const char *url, const char *localpath,
/** @} */
-/** @addtogroup alpm_databases Database
+/** @addtogroup libalpm_databases Database
* @brief Functions to query and manipulate the database of libalpm.
* @{
*/
@@ -1468,7 +1468,7 @@ int alpm_logaction(alpm_handle_t *handle, const char *prefix,
/** @} */
-/** @addtogroup alpm_options Options
+/** @addtogroup libalpm_options Options
* Libalpm option getters and setters
* @{
*/
@@ -2184,7 +2184,7 @@ int alpm_option_set_parallel_downloads(alpm_handle_t *handle, unsigned int num_s
/** @} */
-/** @addtogroup alpm_packages Package Functions
+/** @addtogroup libalpm_packages Package Functions
* Functions to manipulate libalpm packages
* @{
*/
@@ -2619,7 +2619,7 @@ int alpm_pkg_mtree_close(const alpm_pkg_t *pkg, struct archive *archive);
/* End of alpm_packages */
/** @} */
-/** @addtogroup alpm_trans Transaction
+/** @addtogroup libalpm_trans Transaction
* @brief Functions to manipulate libalpm transactions
*
* Transactions are the way to add/remove packages to/from the system.
diff --git a/lib/libalpm/alpm_list.h b/lib/libalpm/alpm_list.h
index cbdc7206..5e75aa6e 100644
--- a/lib/libalpm/alpm_list.h
+++ b/lib/libalpm/alpm_list.h
@@ -19,20 +19,6 @@
*/
-/**
- * @file alpm_list.h
- * @author Pacman Development Team
- * @brief A doubly linked list for use with libalpm
- *
- * @section see_also See Also
- * \b alpm(3),
- * \b alpm-hooks(5),
- * \b makepkg(8),
- * \b pacman(8),
- * \b pacman.conf(5)
- * @{
- */
-
#ifndef ALPM_LIST_H
#define ALPM_LIST_H
@@ -47,7 +33,8 @@ extern "C" {
#endif
/**
- * @addtogroup alpm_list List Functions
+ * @ingroup libalpm
+ * @addtogroup libalpm-list libalpm-list(3)
* @brief Functions to manipulate alpm_list_t lists.
*
* These functions are designed to create, destroy, and modify lists of