Doxygen doco markup.

CVS patchset: 6760
CVS date: 2003/04/17 17:17:27

26 files changed, 175 insertions, 124 deletions

diff --git a/python/_rpmdb.c b/python/_rpmdb.c
index 3d93f6fc0..1bdcd111d 100644
--- a/python/_rpmdb.c
+++ b/python/_rpmdb.c
@@ -1,4 +1,4 @@
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/_rpmdb.c
  */
 
@@ -92,7 +92,7 @@
 
 #define PY_BSDDB_VERSION "3.4.2"
 
-static char *rcs_id = "$Id: _rpmdb.c,v 1.7 2002/11/08 22:23:37 jbj Exp $";
+static char *rcs_id = "$Id: _rpmdb.c,v 1.8 2003/04/17 17:17:27 jbj Exp $";
 
 
 #ifdef WITH_THREAD
diff --git a/python/header-py.c b/python/header-py.c
index 78bd0ea61..11fdbe256 100644
--- a/python/header-py.c
+++ b/python/header-py.c
@@ -1,4 +1,4 @@
-/** \ingroup python
+/** \ingroup py_c
  * \file python/header-py.c
  */
 
@@ -26,13 +26,64 @@
 #include "debug.h"
 
 /** \ingroup python
+ * \class Rpm
+ * \brief START HERE / RPM base module for the Python API
+ *
+ * The rpm base module provides the main starting point for
+ * accessing RPM from Python. For most usage, call
+ * the TransactionSet method to get a transaction set (rpmts).
+ *
+ * For example:
+ * \code
+ *	import rpm
+ *
+ *	ts = rpm.TransactionSet()
+ * \endcode
+ *
+ * The transaction set will open the RPM database as needed, so
+ * in most cases, you do not need to explicitly open the
+ * database. The transaction set is the workhorse of RPM.
+ *
+ * You can open another RPM database, such as one that holds
+ * all packages for a given Linux distribution, to provide
+ * packages used to solve dependencies. To do this, use
+ * the following code:
+ *
+ * \code
+ * rpm.addMacro('_dbpath', '/path/to/alternate/database')
+ * solvets = rpm.TransactionSet()
+ * solvets.openDB()
+ * rpm.delMacro('_dbpath')
+ *
+ * # Open default database
+ * ts = rpm.TransactionSet()
+ * \endcode
+ *
+ * This code gives you access to two RPM databases through
+ * two transaction sets (rpmts): ts is a transaction set
+ * associated with the default RPM database and solvets
+ * is a transaction set tied to an alternate database, which
+ * is very useful for resolving dependencies.
+ *
+ * The rpm methods used here are:
+ *
+ * - addMacro(macro, value)
+ * @param macro   Name of macro to add
+ * @param value   Value for the macro
+ *
+ * - delMacro(macro)
+ * @param macro   Name of macro to delete
+ *
+ */
+
+/** \ingroup python
  * \class Rpmhdr
  * \brief A python header object represents an RPM package header.
- * 
+ *
  * All RPM packages have headers that provide metadata for the package.
  * Header objects can be returned by database queries or loaded from a
  * binary package on disk.
- * 
+ *
  * The ts.hdrFromFdno() function returns the package header from a
  * package on disk, verifying package signatures and digests of the
  * package while reading.
@@ -53,7 +104,7 @@
  *	else:
  *	   print "header is from a binary package"
  * \endcode
- * 
+ *
  * The Python interface to the header data is quite elegant.  It
  * presents the data in a dictionary form.  We'll take the header we
  * just loaded and access the data within it:
@@ -88,7 +139,7 @@
  */
 /*@{*/
 
-/** \ingroup python
+/** \ingroup py_c
  */
 struct hdrObject_s {
     PyObject_HEAD
@@ -110,7 +161,7 @@ struct hdrObject_s {
     return 0;
 }
 
-/** \ingroup python
+/** \ingroup py_c
  */
 static PyObject * hdrKeyList(hdrObject * s, PyObject * args)
 	/*@*/
@@ -144,7 +195,7 @@ static PyObject * hdrKeyList(hdrObject * s, PyObject * args)
     return list;
 }
 
-/** \ingroup python
+/** \ingroup py_c
  */
 static PyObject * hdrUnload(hdrObject * s, PyObject * args, PyObject *keywords)
 	/*@*/
@@ -156,7 +207,7 @@ static PyObject * hdrUnload(hdrObject * s, PyObject * args, PyObject *keywords)
     static char *kwlist[] = { "legacyHeader", NULL};
 
     if (!PyArg_ParseTupleAndKeywords(args, keywords, "|i", kwlist, &legacy))
-	return NULL; 
+	return NULL;
 
     h = headerLink(s->h);
     /* XXX this legacy switch is a hack, needs to be removed. */
@@ -179,7 +230,7 @@ static PyObject * hdrUnload(hdrObject * s, PyObject * args, PyObject *keywords)
     return rc;
 }
 
-/** \ingroup python
+/** \ingroup py_c
  */
 static PyObject * hdrExpandFilelist(hdrObject * s, PyObject * args)
 	/*@*/
@@ -190,7 +241,7 @@ static PyObject * hdrExpandFilelist(hdrObject * s, PyObject * args)
     return Py_None;
 }
 
-/** \ingroup python
+/** \ingroup py_c
  */
 static PyObject * hdrCompressFilelist(hdrObject * s, PyObject * args)
 	/*@*/
@@ -202,7 +253,7 @@ static PyObject * hdrCompressFilelist(hdrObject * s, PyObject * args)
 }
 
 /* make a header with _all_ the tags we need */
-/** \ingroup python
+/** \ingroup py_c
  */
 static void mungeFilelist(Header h)
 	/*@*/
@@ -214,7 +265,7 @@ static void mungeFilelist(Header h)
 	|| !headerIsEntry (h, RPMTAG_DIRNAMES)
 	|| !headerIsEntry (h, RPMTAG_DIRINDEXES))
 	compressFilelist(h);
-    
+
     rpmfiBuildFNames(h, RPMTAG_BASENAMES, &fileNames, &count);
 
     if (fileNames == NULL || count <= 0)
@@ -227,7 +278,7 @@ static void mungeFilelist(Header h)
     fileNames = _free(fileNames);
 }
 
-/** 
+/**
  */
 static PyObject * rhnUnload(hdrObject * s, PyObject * args)
 	/*@*/
@@ -289,7 +340,7 @@ static PyObject * rhnUnload(hdrObject * s, PyObject * args)
     return rc;
 }
 
-/** \ingroup python
+/** \ingroup py_c
  */
 static PyObject * hdrFullFilelist(hdrObject * s, PyObject * args)
 	/*@*/
@@ -303,7 +354,7 @@ static PyObject * hdrFullFilelist(hdrObject * s, PyObject * args)
     return Py_None;
 }
 
-/** \ingroup python
+/** \ingroup py_c
  */
 static PyObject * hdrSprintf(hdrObject * s, PyObject * args)
 	/*@*/
@@ -341,7 +392,7 @@ static long hdr_hash(PyObject * h)
     return (long) h;
 }
 
-/** \ingroup python
+/** \ingroup py_c
  */
 /*@unchecked@*/ /*@observer@*/
 static struct PyMethodDef hdr_methods[] = {
@@ -370,7 +421,7 @@ static struct PyMethodDef hdr_methods[] = {
     {NULL,		NULL}		/* sentinel */
 };
 
-/** \ingroup python
+/** \ingroup py_c
  */
 static PyObject * hdr_getattr(hdrObject * s, char * name)
 	/*@*/
@@ -378,7 +429,7 @@ static PyObject * hdr_getattr(hdrObject * s, char * name)
     return Py_FindMethod(hdr_methods, (PyObject * ) s, name);
 }
 
-/** \ingroup python
+/** \ingroup py_c
  */
 static void hdr_dealloc(hdrObject * s)
 	/*@*/
@@ -390,7 +441,7 @@ static void hdr_dealloc(hdrObject * s)
     PyObject_Del(s);
 }
 
-/** \ingroup python
+/** \ingroup py_c
  */
 long tagNumFromPyObject (PyObject *item)
 {
@@ -408,7 +459,7 @@ long tagNumFromPyObject (PyObject *item)
     return -1;
 }
 
-/** \ingroup python
+/** \ingroup py_c
  */
 static PyObject * hdr_subscript(hdrObject * s, PyObject * item)
 	/*@*/
@@ -447,7 +498,7 @@ static PyObject * hdr_subscript(hdrObject * s, PyObject * item)
             PyErr_SetString(PyExc_KeyError, "unknown header tag");
             return NULL;
         }
-        
+
         if (!rpmHeaderGetEntry(s->h, tag, &type, &data, &count)) {
             Py_INCREF(Py_None);
             return Py_None;
@@ -567,7 +618,7 @@ static PyObject * hdr_subscript(hdrObject * s, PyObject * item)
     return o;
 }
 
-/** \ingroup python
+/** \ingroup py_c
  */
 /*@unchecked@*/ /*@observer@*/
 static PyMappingMethods hdr_as_mapping = {
@@ -581,7 +632,7 @@ static PyMappingMethods hdr_as_mapping = {
 static char hdr_doc[] =
 "";
 
-/** \ingroup python
+/** \ingroup py_c
  */
 /*@unchecked@*/ /*@observer@*/
 PyTypeObject hdr_Type = {
@@ -656,7 +707,7 @@ PyObject * hdrLoad(PyObject * self, PyObject * args)
     int len;
 
     if (!PyArg_ParseTuple(args, "s#", &obj, &len)) return NULL;
-    
+
     /* malloc is needed to avoid surprises from data swab in headerLoad(). */
     copy = malloc(len);
     if (copy == NULL) {
@@ -689,7 +740,7 @@ PyObject * rhnLoad(PyObject * self, PyObject * args)
     int len;
 
     if (!PyArg_ParseTuple(args, "s#", &obj, &len)) return NULL;
-    
+
     /* malloc is needed to avoid surprises from data swab in headerLoad(). */
     copy = malloc(len);
     if (copy == NULL) {
diff --git a/python/header-py.h b/python/header-py.h
index 1bdaf9b83..046412196 100644
--- a/python/header-py.h
+++ b/python/header-py.h
@@ -1,18 +1,18 @@
 #ifndef RPMPYTHON_HEADER
 #define RPMPYTHON_HEADER
 
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/header-py.h
  */
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 typedef struct hdrObject_s hdrObject;
 
 /*@unchecked@*/
 extern PyTypeObject hdr_Type;
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 PyObject * pyrpmError;
 
diff --git a/python/rpmal-py.c b/python/rpmal-py.c
index 1a159dff2..99dd060a8 100644
--- a/python/rpmal-py.c
+++ b/python/rpmal-py.c
@@ -1,4 +1,4 @@
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmal-py.c
  */
 
diff --git a/python/rpmal-py.h b/python/rpmal-py.h
index 62d69a44d..24de1e3c4 100644
--- a/python/rpmal-py.h
+++ b/python/rpmal-py.h
@@ -3,7 +3,7 @@
 
 #include "rpmal.h"
 
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmal-py.h
  */
 
diff --git a/python/rpmbc-py.c b/python/rpmbc-py.c
index e1228848e..9354358a7 100644
--- a/python/rpmbc-py.c
+++ b/python/rpmbc-py.c
@@ -1,4 +1,4 @@
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmbc-py.c
  */
 
@@ -482,7 +482,7 @@ fprintf(stderr, "*** rpmbc_repr(%p): \"%s\"\n", a, PyString_AS_STRING(so));
     return so;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static int rpmbc_init(rpmbcObject * z, PyObject *args, PyObject *kwds)
 	/*@modifies z @*/
@@ -537,7 +537,7 @@ fprintf(stderr, "*** rpmbc_init(%p[%s],%p[%s],%p[%s]):\t", z, lbl(z), args, lbl(
     return 0;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static void rpmbc_free(/*@only@*/ rpmbcObject * s)
 	/*@modifies s @*/
@@ -548,7 +548,7 @@ fprintf(stderr, "*** rpmbc_free(%p[%s])\n", s, lbl(s));
     PyObject_Del(s);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject * rpmbc_alloc(PyTypeObject * subtype, int nitems)
 	/*@*/
@@ -607,7 +607,7 @@ rpmbc_i2bc(PyObject * o)
 
 /* ---------- */
 
-/** \ingroup python
+/** \ingroup py_c  
  */    
 static PyObject * 
 rpmbc_Debug(/*@unused@*/ rpmbcObject * s, PyObject * args)
@@ -623,7 +623,7 @@ fprintf(stderr, "*** rpmbc_Debug(%p)\n", s);
     return Py_None;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */    
 static PyObject * 
 rpmbc_Gcd(/*@unused@*/ rpmbcObject * s, PyObject * args)
@@ -656,7 +656,7 @@ fprintf(stderr, "*** rpmbc_Gcd(%p)\n", s);
     return (PyObject *)z;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */    
 static PyObject * 
 rpmbc_Sqrt(/*@unused@*/ rpmbcObject * s, PyObject * args)
diff --git a/python/rpmbc-py.h b/python/rpmbc-py.h
index 787509fd6..dbbe497f5 100644
--- a/python/rpmbc-py.h
+++ b/python/rpmbc-py.h
@@ -3,7 +3,7 @@
 
 #include "rpmio_internal.h"
 
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmbc-py.h
  */
 
diff --git a/python/rpmdb-py.c b/python/rpmdb-py.c
index 1ab1b7c87..85b3a59be 100644
--- a/python/rpmdb-py.c
+++ b/python/rpmdb-py.c
@@ -1,4 +1,4 @@
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmdb-py.c
  */
 
diff --git a/python/rpmdb-py.h b/python/rpmdb-py.h
index 377f59e3c..4fe934a01 100644
--- a/python/rpmdb-py.h
+++ b/python/rpmdb-py.h
@@ -3,15 +3,15 @@
 
 #include "rpmdb.h"
 
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmdb-py.h
  */
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 typedef struct rpmdbObject_s rpmdbObject;
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 struct rpmdbObject_s {
     PyObject_HEAD
diff --git a/python/rpmds-py.c b/python/rpmds-py.c
index 534fc43e6..3853e42e0 100644
--- a/python/rpmds-py.c
+++ b/python/rpmds-py.c
@@ -1,4 +1,4 @@
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmds-py.c
  */
 
diff --git a/python/rpmds-py.h b/python/rpmds-py.h
index 83c892814..5f45d217f 100644
--- a/python/rpmds-py.h
+++ b/python/rpmds-py.h
@@ -3,7 +3,7 @@
 
 #include "rpmds.h"
 
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmds-py.h
  */
 
diff --git a/python/rpmfd-py.c b/python/rpmfd-py.c
index 535d9bb95..d463474d2 100644
--- a/python/rpmfd-py.c
+++ b/python/rpmfd-py.c
@@ -1,4 +1,4 @@
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmfd-py.c
  */
 
@@ -148,7 +148,7 @@ rpmfd_Fopen(/*@unused@*/ PyObject * s, PyObject * args)
     return PyFile_FromFile (node->f, path, mode, closeCallback);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 /*@-fullinitblock@*/
 /*@unchecked@*/ /*@observer@*/
@@ -163,7 +163,7 @@ static struct PyMethodDef rpmfd_methods[] = {
 
 /* ---------- */
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static void
 rpmfd_dealloc(/*@only@*/ /*@null@*/ rpmfdObject * s)
@@ -176,7 +176,7 @@ rpmfd_dealloc(/*@only@*/ /*@null@*/ rpmfdObject * s)
     }
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject * rpmfd_getattr(rpmfdObject * o, char * name)
 	/*@*/
@@ -184,7 +184,7 @@ static PyObject * rpmfd_getattr(rpmfdObject * o, char * name)
     return Py_FindMethod(rpmfd_methods, (PyObject *) o, name);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static int rpmfd_init(rpmfdObject * s, PyObject *args, PyObject *kwds)
 	/*@modifies s @*/
@@ -216,7 +216,7 @@ fprintf(stderr, "*** rpmfd_init(%p,%p,%p)\n", s, args, kwds);
     return 0;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static void rpmfd_free(/*@only@*/ rpmfdObject * s)
 	/*@modifies s @*/
@@ -229,7 +229,7 @@ fprintf(stderr, "%p -- fd %p\n", s, s->fd);
     PyObject_Del((PyObject *)s);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject * rpmfd_alloc(PyTypeObject * subtype, int nitems)
 	/*@*/
@@ -241,7 +241,7 @@ fprintf(stderr, "*** rpmfd_alloc(%p,%d) ret %p\n", subtype, nitems, s);
     return s;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static rpmfdObject * rpmfd_new(PyTypeObject * subtype, PyObject *args, PyObject *kwds)
 	/*@*/
@@ -266,7 +266,7 @@ fprintf(stderr, "%p ++ fd %p\n", s, s->fd);
 static char rpmfd_doc[] =
 "";
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 /*@-fullinitblock@*/
 PyTypeObject rpmfd_Type = {
diff --git a/python/rpmfd-py.h b/python/rpmfd-py.h
index 142ff1bc9..23e230836 100644
--- a/python/rpmfd-py.h
+++ b/python/rpmfd-py.h
@@ -1,7 +1,7 @@
 #ifndef H_RPMFD_PY
 #define H_RPMFD_PY
 
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmfd-py.h
  */
 
diff --git a/python/rpmfi-py.c b/python/rpmfi-py.c
index 5da279885..b1beb6216 100644
--- a/python/rpmfi-py.c
+++ b/python/rpmfi-py.c
@@ -1,4 +1,4 @@
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmfi-py.c
  */
 
diff --git a/python/rpmfi-py.h b/python/rpmfi-py.h
index 386b308b8..84b95b9ca 100644
--- a/python/rpmfi-py.h
+++ b/python/rpmfi-py.h
@@ -3,7 +3,7 @@
 
 #include "rpmfi.h"
 
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmfi-py.h
  */
 
diff --git a/python/rpmfts-py.c b/python/rpmfts-py.c
index ae3739cfb..91066f5f8 100644
--- a/python/rpmfts-py.c
+++ b/python/rpmfts-py.c
@@ -1,4 +1,4 @@
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmfts-py.c
  */
 
@@ -267,7 +267,7 @@ rpmfts_debug(__FUNCTION__, s);
     return Py_BuildValue("i", rc);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 /*@-fullinitblock@*/
 /*@unchecked@*/ /*@observer@*/
@@ -505,7 +505,7 @@ static int rpmfts_print(rpmftsObject * s,  FILE * fp, /*@unused@*/ int flags)
 static char rpmfts_doc[] =
 "";
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 /*@-fullinitblock@*/
 PyTypeObject rpmfts_Type = {
diff --git a/python/rpmfts-py.h b/python/rpmfts-py.h
index 56ebfdf09..90aa2afc0 100644
--- a/python/rpmfts-py.h
+++ b/python/rpmfts-py.h
@@ -1,7 +1,7 @@
 #ifndef H_RPMFTS_PY
 #define H_RPMFTS_PY
 
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmfts-py.h
  */
 
diff --git a/python/rpmmi-py.c b/python/rpmmi-py.c
index 48d65185e..aa37b2b3f 100644
--- a/python/rpmmi-py.c
+++ b/python/rpmmi-py.c
@@ -1,4 +1,4 @@
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmmi-py.c
  */
 
@@ -180,7 +180,7 @@ rpmmi_Pattern(rpmmiObject * s, PyObject * args)
     
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 /*@-fullinitblock@*/
 /*@unchecked@*/ /*@observer@*/
@@ -199,7 +199,7 @@ static struct PyMethodDef rpmmi_methods[] = {
 };
 /*@=fullinitblock@*/
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static void rpmmi_dealloc(/*@only@*/ /*@null@*/ rpmmiObject * s)
 	/*@globals rpmGlobalMacroContext @*/
@@ -211,7 +211,7 @@ static void rpmmi_dealloc(/*@only@*/ /*@null@*/ rpmmiObject * s)
     }
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject * rpmmi_getattr (rpmmiObject *s, char *name)
 	/*@*/
@@ -225,7 +225,7 @@ static PyObject * rpmmi_getattr (rpmmiObject *s, char *name)
 static char rpmmi_doc[] =
 "";
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 /*@-fullinitblock@*/
 PyTypeObject rpmmi_Type = {
diff --git a/python/rpmmi-py.h b/python/rpmmi-py.h
index 9d6772106..712b12f83 100644
--- a/python/rpmmi-py.h
+++ b/python/rpmmi-py.h
@@ -1,15 +1,15 @@
 #ifndef H_RPMMI_PY
 #define H_RPMMI_PY
 
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmmi-py.h
  */
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 typedef struct rpmmiObject_s rpmmiObject;
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 struct rpmmiObject_s {
     PyObject_HEAD
diff --git a/python/rpmmodule.c b/python/rpmmodule.c
index 9a742ce55..9897868b8 100644
--- a/python/rpmmodule.c
+++ b/python/rpmmodule.c
@@ -1,4 +1,4 @@
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmmodule.c
  */
 
diff --git a/python/rpmrc-py.c b/python/rpmrc-py.c
index a2aa860bb..a896ca38d 100644
--- a/python/rpmrc-py.c
+++ b/python/rpmrc-py.c
@@ -1,4 +1,4 @@
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmrc-py.c
  */
 
@@ -249,7 +249,7 @@ fprintf(stderr, "*** rpmrc_next(%p[%s],%p)\n", s, lbl(s), args);
     return NULL;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static int rpmrc_init(PyObject * s, PyObject *args, PyObject *kwds)
 	/*@*/
@@ -261,7 +261,7 @@ fprintf(stderr, "*** rpmrc_init(%p[%s],%p,%p)\n", s, lbl(s), args, kwds);
     return 0;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static void rpmrc_free(PyObject * s)
 	/*@*/
@@ -271,7 +271,7 @@ fprintf(stderr, "*** rpmrc_free(%p[%s])\n", s, lbl(s));
    _PyObject_GC_Del(s);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject * rpmrc_alloc(PyTypeObject * subtype, int nitems)
 	/*@*/
@@ -283,7 +283,7 @@ fprintf(stderr, "*** rpmrc_alloc(%p[%s},%d) ret %p[%s]\n", subtype, lbl(subtype)
     return (PyObject *) ns;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject * rpmrc_new(PyTypeObject * subtype, PyObject *args, PyObject *kwds)
 	/*@*/
@@ -322,7 +322,7 @@ static struct PyMethodDef rpmrc_methods[] = {
 };
 /*@=fullinitblock@*/
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 /*@-fullinitblock@*/
 #if Py_TPFLAGS_HAVE_ITER
diff --git a/python/rpmrc-py.h b/python/rpmrc-py.h
index 4786993ce..788ba3b1b 100644
--- a/python/rpmrc-py.h
+++ b/python/rpmrc-py.h
@@ -1,15 +1,15 @@
 #ifndef H_RPMRC_PY
 #define H_RPMRC_PY
 
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmrc-py.h
  */
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 typedef struct rpmrcObject_s rpmrcObject;
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 struct rpmrcObject_s {
 #if Py_TPFLAGS_HAVE_ITER	/* XXX backport to python-1.5.2 */
diff --git a/python/rpmte-py.c b/python/rpmte-py.c
index 31556ddbe..cdf6bded7 100644
--- a/python/rpmte-py.c
+++ b/python/rpmte-py.c
@@ -1,4 +1,4 @@
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmte-py.c
  */
 
@@ -289,7 +289,7 @@ rpmte_FI(rpmteObject * s, PyObject * args)
     return (PyObject *) rpmfi_Wrap(rpmfiLink(fi, "rpmte_FI"));
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 /*@-fullinitblock@*/
 /*@unchecked@*/ /*@observer@*/
@@ -372,7 +372,7 @@ rpmte_print(rpmteObject * s, FILE * fp, /*@unused@*/ int flags)
     return 0;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject * rpmte_getattr(rpmteObject * o, char * name)
 	/*@*/
@@ -386,7 +386,7 @@ static PyObject * rpmte_getattr(rpmteObject * o, char * name)
 static char rpmte_doc[] =
 "";
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 /*@-fullinitblock@*/
 PyTypeObject rpmte_Type = {
diff --git a/python/rpmte-py.h b/python/rpmte-py.h
index 3bce93523..54aa7c5c4 100644
--- a/python/rpmte-py.h
+++ b/python/rpmte-py.h
@@ -3,7 +3,7 @@
 
 #include "rpmte.h"
 
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmte-py.h
  */
 
diff --git a/python/rpmts-py.c b/python/rpmts-py.c
index bc3aecfb9..9ac54c33b 100644
--- a/python/rpmts-py.c
+++ b/python/rpmts-py.c
@@ -1,4 +1,4 @@
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmts-py.c
  */
 
@@ -157,7 +157,7 @@ static int _rpmts_debug = 0;
  *	the ts.run() method.
  */
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 struct rpmtsCallbackType_s {
     PyObject * cb;
@@ -167,7 +167,7 @@ struct rpmtsCallbackType_s {
     PyThreadState *_save;
 };
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_Debug(/*@unused@*/ rpmtsObject * s, PyObject * args)
@@ -183,7 +183,7 @@ fprintf(stderr, "*** rpmts_Debug(%p) ts %p\n", s, s->ts);
     return Py_None;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  * Add package to universe of possible packages to install in transaction set.
  * @param ts		transaction set
  * @param h		header
@@ -208,7 +208,7 @@ fprintf(stderr, "\tAddAvailable(%p) list %p\n", ts, ts->availablePackages);
 
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_AddInstall(rpmtsObject * s, PyObject * args)
@@ -252,7 +252,7 @@ fprintf(stderr, "*** rpmts_AddInstall(%p,%p,%p,%s) ts %p\n", s, h, key, how, s->
     return Py_None;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  * @todo Permit finer control (i.e. not just --allmatches) of deleted elments.
  */
 static PyObject *
@@ -313,7 +313,7 @@ fprintf(stderr, "*** rpmts_AddErase(%p) ts %p\n", s, s->ts);
     return Py_None;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static int
 rpmts_SolveCallback(rpmts ts, rpmds ds, const void * data)
@@ -350,7 +350,7 @@ fprintf(stderr, "*** rpmts_SolveCallback(%p,%p,%p) \"%s\"\n", ts, ds, data, rpmd
     return res;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_Check(rpmtsObject * s, PyObject * args)
@@ -463,7 +463,7 @@ fprintf(stderr, "*** rpmts_Check(%p) ts %p cb %p\n", s, s->ts, cbInfo.cb);
     return Py_None;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_Order(rpmtsObject * s, PyObject * args)
@@ -483,7 +483,7 @@ fprintf(stderr, "*** rpmts_Order(%p) ts %p\n", s, s->ts);
     return Py_BuildValue("i", rc);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_Clean(rpmtsObject * s, PyObject * args)
@@ -501,7 +501,7 @@ fprintf(stderr, "*** rpmts_Clean(%p) ts %p\n", s, s->ts);
     return Py_None;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_IDTXload(rpmtsObject * s, PyObject * args)
@@ -542,7 +542,7 @@ fprintf(stderr, "*** rpmts_IDTXload(%p) ts %p\n", s, s->ts);
     return result;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_IDTXglob(rpmtsObject * s, PyObject * args)
@@ -586,7 +586,7 @@ fprintf(stderr, "*** rpmts_IDTXglob(%p) ts %p\n", s, s->ts);
     return result;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_Rollback(rpmtsObject * s, PyObject * args)
@@ -622,7 +622,7 @@ fprintf(stderr, "*** rpmts_Rollback(%p) ts %p\n", s, s->ts);
     return Py_BuildValue("i", rc);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_OpenDB(rpmtsObject * s, PyObject * args)
@@ -641,7 +641,7 @@ fprintf(stderr, "*** rpmts_OpenDB(%p) ts %p\n", s, s->ts);
     return Py_BuildValue("i", rpmtsOpenDB(s->ts, s->ts->dbmode));
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_CloseDB(rpmtsObject * s, PyObject * args)
@@ -660,7 +660,7 @@ fprintf(stderr, "*** rpmts_CloseDB(%p) ts %p\n", s, s->ts);
     return Py_BuildValue("i", rc);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_InitDB(rpmtsObject * s, PyObject * args)
@@ -681,7 +681,7 @@ fprintf(stderr, "*** rpmts_InitDB(%p) ts %p\n", s, s->ts);
     return Py_BuildValue("i", rc);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_RebuildDB(rpmtsObject * s, PyObject * args)
@@ -702,7 +702,7 @@ fprintf(stderr, "*** rpmts_RebuildDB(%p) ts %p\n", s, s->ts);
     return Py_BuildValue("i", rc);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_VerifyDB(rpmtsObject * s, PyObject * args)
@@ -723,7 +723,7 @@ fprintf(stderr, "*** rpmts_VerifyDB(%p) ts %p\n", s, s->ts);
     return Py_BuildValue("i", rc);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_HdrFromFdno(rpmtsObject * s, PyObject * args)
@@ -770,7 +770,7 @@ fprintf(stderr, "*** rpmts_HdrFromFdno(%p) ts %p rc %d\n", s, s->ts, rpmrc);
     return result;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_HdrCheck(rpmtsObject * s, PyObject * args)
@@ -825,7 +825,7 @@ fprintf(stderr, "*** rpmts_HdrCheck(%p) ts %p\n", s, s->ts);
     return result;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_SetVSFlags(rpmtsObject * s, PyObject * args)
@@ -843,7 +843,7 @@ fprintf(stderr, "*** rpmts_SetVSFlags(%p) ts %p\n", s, s->ts);
     return Py_BuildValue("i", rpmtsSetVSFlags(s->ts, vsflags));
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_SetColor(rpmtsObject * s, PyObject * args)
@@ -861,7 +861,7 @@ fprintf(stderr, "*** rpmts_SetColor(%p) ts %p\n", s, s->ts);
     return Py_BuildValue("i", rpmtsSetColor(s->ts, tscolor));
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_PgpPrtPkts(rpmtsObject * s, PyObject * args)
@@ -893,7 +893,7 @@ fprintf(stderr, "*** rpmts_PgpPrtPkts(%p) ts %p\n", s, s->ts);
     return Py_BuildValue("i", rc);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_PgpImportPubkey(rpmtsObject * s, PyObject * args)
@@ -925,7 +925,7 @@ fprintf(stderr, "*** rpmts_PgpImportPubkey(%p) ts %p\n", s, s->ts);
     return Py_BuildValue("i", rc);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject *
 rpmts_GetKeys(rpmtsObject * s, PyObject * args)
@@ -962,7 +962,7 @@ fprintf(stderr, "*** rpmts_GetKeys(%p) ts %p\n", s, s->ts);
     return tuple;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static void *
 rpmtsCallback(/*@unused@*/ const void * hd, const rpmCallbackType what,
@@ -1040,7 +1040,7 @@ fprintf(stderr, "\t%ld:%ld key %p\n", amount, total, pkgKey);
     return NULL;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject * rpmts_SetFlags(rpmtsObject * s, PyObject * args)
 	/*@modifies s @*/
@@ -1056,7 +1056,7 @@ fprintf(stderr, "*** rpmts_SetFlags(%p) ts %p transFlags %x\n", s, s->ts, transF
     return Py_BuildValue("i", rpmtsSetFlags(s->ts, transFlags));
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject * rpmts_SetProbFilter(rpmtsObject * s, PyObject * args)
 	/*@modifies s @*/
@@ -1076,7 +1076,7 @@ fprintf(stderr, "*** rpmts_SetProbFilter(%p) ts %p ignoreSet %x\n", s, s->ts, ig
     return Py_BuildValue("i", oignoreSet);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject * rpmts_Run(rpmtsObject * s, PyObject * args)
 	/*@globals rpmGlobalMacroContext, _Py_NoneStruct @*/
@@ -1246,7 +1246,7 @@ fprintf(stderr, "*** rpmts_Match(%p) ts %p\n", s, s->ts);
     return rpmmi_Wrap( rpmtsInitIterator(s->ts, tag, key, len) );
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 /*@-fullinitblock@*/
 /*@unchecked@*/ /*@observer@*/
@@ -1337,7 +1337,7 @@ static struct PyMethodDef rpmts_methods[] = {
 };
 /*@=fullinitblock@*/
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static void rpmts_dealloc(/*@only@*/ rpmtsObject * s)
 	/*@modifies *s @*/
@@ -1354,7 +1354,7 @@ fprintf(stderr, "%p -- ts %p db %p\n", s, s->ts, s->ts->rdb);
     PyObject_Del((PyObject *)s);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject * rpmts_getattr(rpmtsObject * o, char * name)
 	/*@*/
@@ -1362,7 +1362,7 @@ static PyObject * rpmts_getattr(rpmtsObject * o, char * name)
     return Py_FindMethod(rpmts_methods, (PyObject *) o, name);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static int rpmts_setattr(rpmtsObject * o, char * name, PyObject * val)
 	/*@modifies o @*/
@@ -1386,7 +1386,7 @@ static int rpmts_setattr(rpmtsObject * o, char * name, PyObject * val)
     return 0;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static int rpmts_init(rpmtsObject * s, PyObject *args, PyObject *kwds)
 	/*@globals rpmGlobalMacroContext @*/
@@ -1412,7 +1412,7 @@ fprintf(stderr, "*** rpmts_init(%p,%p,%p)\n", s, args, kwds);
     return 0;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static void rpmts_free(/*@only@*/ rpmtsObject * s)
 	/*@modifies s @*/
@@ -1431,7 +1431,7 @@ fprintf(stderr, "%p -- ts %p db %p\n", s, s->ts, s->ts->rdb);
    PyObject_Del((PyObject *)s);
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject * rpmts_alloc(PyTypeObject * subtype, int nitems)
 	/*@*/
@@ -1443,7 +1443,7 @@ fprintf(stderr, "*** rpmts_alloc(%p,%d) ret %p\n", subtype, nitems, s);
     return s;
 }
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 static PyObject * rpmts_new(PyTypeObject * subtype, PyObject *args, PyObject *kwds)
 	/*@globals rpmGlobalMacroContext @*/
@@ -1469,7 +1469,7 @@ fprintf(stderr, "%p ++ ts %p db %p\n", s, s->ts, s->ts->rdb);
 static char rpmts_doc[] =
 "";
 
-/** \ingroup python
+/** \ingroup py_c  
  */
 /*@-fullinitblock@*/
 PyTypeObject rpmts_Type = {
diff --git a/python/rpmts-py.h b/python/rpmts-py.h
index 9ca496d02..a84e03775 100644
--- a/python/rpmts-py.h
+++ b/python/rpmts-py.h
@@ -3,7 +3,7 @@
 
 #include "rpmts.h"
 
-/** \ingroup python
+/** \ingroup py_c  
  * \file python/rpmts-py.h
  */