[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] r36809 - in gnunet: doc src/include
|
From: |
gnunet |
|
Subject: |
[GNUnet-SVN] r36809 - in gnunet: doc src/include |
|
Date: |
Tue, 12 Jan 2016 13:43:10 +0100 |
Author: tg
Date: 2016-01-12 13:43:09 +0100 (Tue, 12 Jan 2016)
New Revision: 36809
Modified:
gnunet/doc/doc.h
gnunet/src/include/block_dns.h
gnunet/src/include/block_fs.h
gnunet/src/include/gnunet_applications.h
gnunet/src/include/gnunet_arm_service.h
gnunet/src/include/gnunet_ats_plugin.h
gnunet/src/include/gnunet_ats_service.h
gnunet/src/include/gnunet_bandwidth_lib.h
gnunet/src/include/gnunet_bio_lib.h
gnunet/src/include/gnunet_block_lib.h
gnunet/src/include/gnunet_block_plugin.h
gnunet/src/include/gnunet_cadet_service.h
gnunet/src/include/gnunet_client_lib.h
gnunet/src/include/gnunet_client_manager_lib.h
gnunet/src/include/gnunet_common.h
gnunet/src/include/gnunet_configuration_lib.h
gnunet/src/include/gnunet_connection_lib.h
gnunet/src/include/gnunet_consensus_service.h
gnunet/src/include/gnunet_constants.h
gnunet/src/include/gnunet_conversation_service.h
gnunet/src/include/gnunet_core_service.h
gnunet/src/include/gnunet_datacache_lib.h
gnunet/src/include/gnunet_datacache_plugin.h
gnunet/src/include/gnunet_datastore_plugin.h
gnunet/src/include/gnunet_datastore_service.h
gnunet/src/include/gnunet_dht_service.h
gnunet/src/include/gnunet_disk_lib.h
gnunet/src/include/gnunet_dns_service.h
gnunet/src/include/gnunet_dnsparser_lib.h
gnunet/src/include/gnunet_dnsstub_lib.h
gnunet/src/include/gnunet_dv_service.h
gnunet/src/include/gnunet_env_lib.h
gnunet/src/include/gnunet_fragmentation_lib.h
gnunet/src/include/gnunet_friends_lib.h
gnunet/src/include/gnunet_fs_service.h
gnunet/src/include/gnunet_getopt_lib.h
gnunet/src/include/gnunet_gns_service.h
gnunet/src/include/gnunet_gnsrecord_lib.h
gnunet/src/include/gnunet_hello_lib.h
gnunet/src/include/gnunet_helper_lib.h
gnunet/src/include/gnunet_identity_provider_service.h
gnunet/src/include/gnunet_identity_service.h
gnunet/src/include/gnunet_load_lib.h
gnunet/src/include/gnunet_microphone_lib.h
gnunet/src/include/gnunet_mq_lib.h
gnunet/src/include/gnunet_multicast_service.h
gnunet/src/include/gnunet_mysql_lib.h
gnunet/src/include/gnunet_namecache_plugin.h
gnunet/src/include/gnunet_namecache_service.h
gnunet/src/include/gnunet_namestore_plugin.h
gnunet/src/include/gnunet_namestore_service.h
gnunet/src/include/gnunet_nat_lib.h
gnunet/src/include/gnunet_network_lib.h
gnunet/src/include/gnunet_nse_service.h
gnunet/src/include/gnunet_os_lib.h
gnunet/src/include/gnunet_peer_lib.h
gnunet/src/include/gnunet_peerinfo_service.h
gnunet/src/include/gnunet_peerstore_plugin.h
gnunet/src/include/gnunet_peerstore_service.h
gnunet/src/include/gnunet_plugin_lib.h
gnunet/src/include/gnunet_postgres_lib.h
gnunet/src/include/gnunet_program_lib.h
gnunet/src/include/gnunet_protocols.h
gnunet/src/include/gnunet_psyc_service.h
gnunet/src/include/gnunet_psyc_util_lib.h
gnunet/src/include/gnunet_psycstore_plugin.h
gnunet/src/include/gnunet_psycstore_service.h
gnunet/src/include/gnunet_regex_service.h
gnunet/src/include/gnunet_resolver_service.h
gnunet/src/include/gnunet_rest_lib.h
gnunet/src/include/gnunet_rest_plugin.h
gnunet/src/include/gnunet_revocation_service.h
gnunet/src/include/gnunet_rps_service.h
gnunet/src/include/gnunet_scalarproduct_service.h
gnunet/src/include/gnunet_scheduler_lib.h
gnunet/src/include/gnunet_secretsharing_service.h
gnunet/src/include/gnunet_sensor_service.h
gnunet/src/include/gnunet_sensor_util_lib.h
gnunet/src/include/gnunet_sensordashboard_service.h
gnunet/src/include/gnunet_server_lib.h
gnunet/src/include/gnunet_service_lib.h
gnunet/src/include/gnunet_set_service.h
gnunet/src/include/gnunet_signal_lib.h
gnunet/src/include/gnunet_signatures.h
gnunet/src/include/gnunet_social_service.h
gnunet/src/include/gnunet_socks.h
gnunet/src/include/gnunet_speaker_lib.h
gnunet/src/include/gnunet_statistics_service.h
gnunet/src/include/gnunet_strings_lib.h
gnunet/src/include/gnunet_testbed_logger_service.h
gnunet/src/include/gnunet_testbed_service.h
gnunet/src/include/gnunet_testing_lib.h
gnunet/src/include/gnunet_time_lib.h
gnunet/src/include/gnunet_transport_plugin.h
gnunet/src/include/gnunet_transport_service.h
gnunet/src/include/gnunet_tun_lib.h
gnunet/src/include/gnunet_util_lib.h
gnunet/src/include/gnunet_util_taler_wallet_lib.h
gnunet/src/include/gnunet_vpn_service.h
gnunet/src/include/platform.h
gnunet/src/include/plibc.h
gnunet/src/include/tap-windows.h
gnunet/src/include/winproc.h
Log:
doxygen: group/module definitions (part 2)
Modified: gnunet/doc/doc.h
===================================================================
--- gnunet/doc/doc.h 2016-01-11 21:23:17 UTC (rev 36808)
+++ gnunet/doc/doc.h 2016-01-12 12:43:09 UTC (rev 36809)
@@ -7,5 +7,5 @@
*
* Some additional documentation can be found under [Files](files.html), in
the src/include/ directory.
*
- * See also the [handbooks](https://gnunet.org/handbooks) for installation,
users, and developers.
+ * See also the [handbooks](https://gnunet.org/handbooks) on installation, and
for user and developer documentation.
*/
Modified: gnunet/src/include/block_dns.h
===================================================================
--- gnunet/src/include/block_dns.h 2016-01-11 21:23:17 UTC (rev 36808)
+++ gnunet/src/include/block_dns.h 2016-01-12 12:43:09 UTC (rev 36809)
@@ -19,10 +19,13 @@
*/
/**
+ * @author Christian Grothoff
+ *
* @file
* DNS network structs
*
- * @author Christian Grothoff
+ * @defgroup block-dns DNS Service network protocol definitions
+ * @{
*/
#ifndef BLOCK_DNS_H
#define BLOCK_DNS_H
@@ -61,3 +64,5 @@
GNUNET_NETWORK_STRUCT_END
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/block_fs.h
===================================================================
--- gnunet/src/include/block_fs.h 2016-01-11 21:23:17 UTC (rev 36808)
+++ gnunet/src/include/block_fs.h 2016-01-12 12:43:09 UTC (rev 36809)
@@ -19,10 +19,14 @@
*/
/**
+ * @author Christian Grothoff
+ *
* @file
* FS block formats (shared between FS and Block)
*
- * @author Christian Grothoff
+ * @defgroup block-fs FS block formats
+ * Shared between the [FS service](@ref fs) and the [Block library](@ref
block).
+ * @{
*/
#ifndef BLOCK_FS_H
#define BLOCK_FS_H
@@ -96,3 +100,5 @@
GNUNET_NETWORK_STRUCT_END
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_applications.h
===================================================================
--- gnunet/src/include/gnunet_applications.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_applications.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,10 +19,14 @@
*/
/**
+ * @author Christian Grothoff
+ *
* @file
* Constants for network applications operating on top of the CADET service
*
- * @author Christian Grothoff
+ * @defgroup applications CADET application definitions
+ * Constants for network applications operating on top of the CADET service.
+ * @{
*/
#ifndef GNUNET_APPLICATIONS_H
@@ -131,4 +135,7 @@
/* ifndef GNUNET_APPLICATIONS_H */
#endif
+
+/** @} */ /* end of group */
+
/* end of gnunet_applications.h */
Modified: gnunet/src/include/gnunet_arm_service.h
===================================================================
--- gnunet/src/include/gnunet_arm_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_arm_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -347,8 +347,6 @@
void
GNUNET_ARM_monitor_disconnect_and_free (struct GNUNET_ARM_MonitorHandle *h);
-/** @} */ /* end of group */
-
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
@@ -357,3 +355,5 @@
#endif
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_ats_plugin.h
===================================================================
--- gnunet/src/include/gnunet_ats_plugin.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_ats_plugin.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -478,6 +478,6 @@
unsigned long long in_quota[GNUNET_ATS_NetworkTypeCount];
};
+#endif
+
/** @} */ /* end of group */
-
-#endif
Modified: gnunet/src/include/gnunet_ats_service.h
===================================================================
--- gnunet/src/include/gnunet_ats_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_ats_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -25,7 +25,7 @@
* @author Matthias Wachs
*
* @defgroup ats ATS service
- * Automatic transport selection and outbound bandwidth determination
+ * Automatic Transport Selection and outbound bandwidth determination
* @{
*/
#ifndef GNUNET_ATS_SERVICE_H
@@ -700,7 +700,8 @@
const struct GNUNET_TIME_Relative scope,
...);
+#endif
+
/** @} */ /* end of group */
-#endif
/* end of file gnunet-service-transport_ats.h */
Modified: gnunet/src/include/gnunet_bandwidth_lib.h
===================================================================
--- gnunet/src/include/gnunet_bandwidth_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_bandwidth_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -332,8 +332,9 @@
}
#endif
+/* ifndef GNUNET_BANDWIDTH_LIB_H */
+#endif
+
/** @} */ /* end of group */
-/* ifndef GNUNET_BANDWIDTH_LIB_H */
-#endif
/* end of gnunet_bandwidth_lib.h */
Modified: gnunet/src/include/gnunet_bio_lib.h
===================================================================
--- gnunet/src/include/gnunet_bio_lib.h 2016-01-11 21:23:17 UTC (rev 36808)
+++ gnunet/src/include/gnunet_bio_lib.h 2016-01-12 12:43:09 UTC (rev 36809)
@@ -43,7 +43,6 @@
#endif
/**
- * @ingroup bio
* Handle for buffered reading.
*/
struct GNUNET_BIO_ReadHandle;
@@ -314,8 +313,9 @@
}
#endif
-/** @} */ /* end of group bio */
-
/* ifndef GNUNET_BIO_LIB_H */
#endif
+
+/** @} */ /* end of group bio */
+
/* end of gnunet_bio_lib.h */
Modified: gnunet/src/include/gnunet_block_lib.h
===================================================================
--- gnunet/src/include/gnunet_block_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_block_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -306,9 +306,9 @@
}
#endif
+/* ifndef GNUNET_BLOCK_LIB_H */
+#endif
+
/** @} */ /* end of group */
-
-/* ifndef GNUNET_BLOCK_LIB_H */
-#endif
/* end of gnunet_block_lib.h */
Modified: gnunet/src/include/gnunet_block_plugin.h
===================================================================
--- gnunet/src/include/gnunet_block_plugin.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_block_plugin.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -22,7 +22,7 @@
* @author Christian Grothoff
*
* @file
- * API for block plugins. Each block plugin must conform to the API specified
by this header.
+ * API for block plugins.
*
* @defgroup block-plugin Block plugin API
* To be implemented by applications storing data in the DHT.
@@ -123,6 +123,6 @@
};
-/** @} */ /* end of group block */
+#endif
-#endif
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_cadet_service.h
===================================================================
--- gnunet/src/include/gnunet_cadet_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_cadet_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -642,8 +642,9 @@
}
#endif
+/* ifndef GNUNET_CADET_SERVICE_H */
+#endif
+
/** @} */ /* end of group */
-/* ifndef GNUNET_CADET_SERVICE_H */
-#endif
/* end of gnunet_cadet_service.h */
Modified: gnunet/src/include/gnunet_client_lib.h
===================================================================
--- gnunet/src/include/gnunet_client_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_client_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -228,8 +228,9 @@
}
#endif
+/* ifndef GNUNET_CLIENT_LIB_H */
+#endif
+
/** @} */ /* end of group client */
-/* ifndef GNUNET_CLIENT_LIB_H */
-#endif
/* end of gnunet_client_lib.h */
Modified: gnunet/src/include/gnunet_client_manager_lib.h
===================================================================
--- gnunet/src/include/gnunet_client_manager_lib.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_client_manager_lib.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -353,8 +353,7 @@
}
#endif
-/** @} */ /* end of group */
-
/* ifndef GNUNET_CLIENT_MANAGER_LIB_H */
#endif
-/* end of gnunet_client_manager_lib.h */
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_common.h
===================================================================
--- gnunet/src/include/gnunet_common.h 2016-01-11 21:23:17 UTC (rev 36808)
+++ gnunet/src/include/gnunet_common.h 2016-01-12 12:43:09 UTC (rev 36809)
@@ -1142,7 +1142,4 @@
}
#endif
-
-
-
-#endif /*GNUNET_COMMON_H_ */
+#endif /* GNUNET_COMMON_H */
Modified: gnunet/src/include/gnunet_configuration_lib.h
===================================================================
--- gnunet/src/include/gnunet_configuration_lib.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_configuration_lib.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -543,8 +543,6 @@
const char *option,
const char *value);
-/** @} */ /* end of group configuration */
-
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
@@ -553,3 +551,5 @@
#endif
#endif
+
+/** @} */ /* end of group configuration */
Modified: gnunet/src/include/gnunet_connection_lib.h
===================================================================
--- gnunet/src/include/gnunet_connection_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_connection_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -392,8 +392,9 @@
}
#endif
+/* ifndef GNUNET_CONNECTION_LIB_H */
+#endif
+
/** @} */ /* end of group */
-/* ifndef GNUNET_CONNECTION_LIB_H */
-#endif
/* end of gnunet_connection_lib.h */
Modified: gnunet/src/include/gnunet_consensus_service.h
===================================================================
--- gnunet/src/include/gnunet_consensus_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_consensus_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -171,7 +171,6 @@
void
GNUNET_CONSENSUS_destroy (struct GNUNET_CONSENSUS_Handle *consensus);
-/** @} */ /* end of group */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -181,3 +180,5 @@
#endif
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_constants.h
===================================================================
--- gnunet/src/include/gnunet_constants.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_constants.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -22,7 +22,11 @@
* @author Christian Grothoff
*
* @file
- * "Global" constants for performance tuning
+ * Global constants for performance tuning
+ *
+ * @defgroup constants Constant definitions
+ * Global constants for performance tuning
+ * @{
*/
#ifndef GNUNET_CONSTANTS_H
@@ -165,3 +169,5 @@
#endif
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_conversation_service.h
===================================================================
--- gnunet/src/include/gnunet_conversation_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_conversation_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -422,7 +422,6 @@
void
GNUNET_CONVERSATION_call_stop (struct GNUNET_CONVERSATION_Call *call);
-/** @} */ /* end of group */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -432,3 +431,5 @@
#endif
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_core_service.h
===================================================================
--- gnunet/src/include/gnunet_core_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_core_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -450,8 +450,9 @@
}
#endif
-/** @} */ /* end of group core */
-
/* ifndef GNUNET_CORE_SERVICE_H */
#endif
+
+/** @} */ /* end of group core */
+
/* end of gnunet_core_service.h */
Modified: gnunet/src/include/gnunet_datacache_lib.h
===================================================================
--- gnunet/src/include/gnunet_datacache_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_datacache_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -24,7 +24,7 @@
* @file
* datacache API
*
- * @defgroup datacache Datacache library
+ * @defgroup datacache Data Cache library
* Simple, transient hash table of bounded size with content expiration.
*
* In contrast to the sqstore there is
@@ -177,7 +177,6 @@
GNUNET_DATACACHE_Iterator iter,
void *iter_cls);
-/** @} */ /* end of group */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -186,5 +185,6 @@
}
#endif
-/* end of gnunet_datacache_lib.h */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_datacache_plugin.h
===================================================================
--- gnunet/src/include/gnunet_datacache_plugin.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_datacache_plugin.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -24,7 +24,7 @@
* @file
* API for database backends for the datacache
*
- * @defgroup datacache-plugin Datacache plugin API
+ * @defgroup datacache-plugin Data Cache plugin API
* API for database backends for the datacache
* @{
*/
@@ -186,7 +186,6 @@
};
-/** @} */ /* end of group */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -195,5 +194,6 @@
}
#endif
-/* end of gnunet_datacache_plugin.h */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_datastore_plugin.h
===================================================================
--- gnunet/src/include/gnunet_datastore_plugin.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_datastore_plugin.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -24,7 +24,7 @@
* @file
* API for the database backend plugins.
*
- * @defgroup datastore-plugin Datastore service plugin API
+ * @defgroup datastore-plugin Data Store service plugin API
* API for the database backend plugins.
* @{
*/
@@ -389,6 +389,6 @@
};
+#endif
+
/** @} */ /* end of group */
-
-#endif
Modified: gnunet/src/include/gnunet_datastore_service.h
===================================================================
--- gnunet/src/include/gnunet_datastore_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_datastore_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -24,7 +24,7 @@
* @file
* datastore service
*
- * @defgroup datastore Datastore service
+ * @defgroup datastore Data Store service
* Data store for files stored on a GNUnet node.
*
* Provides an API that can be used manage the
@@ -397,7 +397,6 @@
void
GNUNET_DATASTORE_cancel (struct GNUNET_DATASTORE_QueueEntry *qe);
-/** @} */ /* end of group */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -406,5 +405,6 @@
}
#endif
-/* end of gnunet_datastore_service.h */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_dht_service.h
===================================================================
--- gnunet/src/include/gnunet_dht_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_dht_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -431,8 +431,6 @@
}
#endif
-/** @} */ /* end of group dht */
+#endif
-
-#endif
-/* gnunet_dht_service.h */
+/** @} */ /* end of group dht */
Modified: gnunet/src/include/gnunet_disk_lib.h
===================================================================
--- gnunet/src/include/gnunet_disk_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_disk_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -866,8 +866,9 @@
}
#endif
+/* ifndef GNUNET_DISK_LIB_H */
+#endif
+
/** @} */ /* end of group */
-/* ifndef GNUNET_DISK_LIB_H */
-#endif
/* end of gnunet_disk_lib.h */
Modified: gnunet/src/include/gnunet_dns_service.h
===================================================================
--- gnunet/src/include/gnunet_dns_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_dns_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -186,6 +186,7 @@
void
GNUNET_DNS_disconnect (struct GNUNET_DNS_Handle *dh);
-/** @} */ /* end of group */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_dnsparser_lib.h
===================================================================
--- gnunet/src/include/gnunet_dnsparser_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_dnsparser_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -888,6 +888,7 @@
GNUNET_DNSPARSER_hex_to_bin (const char *hex,
void *data);
-/** @} */ /* end of group */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_dnsstub_lib.h
===================================================================
--- gnunet/src/include/gnunet_dnsstub_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_dnsstub_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -24,7 +24,7 @@
* @file
* API for helper library to send DNS requests to DNS resolver
*
- * @defgroup dns-stub DNS stub library
+ * @defgroup dns-stub DNS Stub library
* Helper library to send DNS requests to DNS resolver
* @{
*/
@@ -127,6 +127,7 @@
void
GNUNET_DNSSTUB_resolve_cancel (struct GNUNET_DNSSTUB_RequestSocket *rs);
-/** @} */ /* end of group */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_dv_service.h
===================================================================
--- gnunet/src/include/gnunet_dv_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_dv_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -25,7 +25,7 @@
* DV service API (should only be used by the DV plugin)
*
* @defgroup dv DV service
- * Distance vector routing
+ * Distance Vector routing
*
* The DV service API should only be used by the DV plugin.
* @{
@@ -172,6 +172,7 @@
void
GNUNET_DV_send_cancel (struct GNUNET_DV_TransmitHandle *th);
-/** @} */ /* end of group */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_env_lib.h
===================================================================
--- gnunet/src/include/gnunet_env_lib.h 2016-01-11 21:23:17 UTC (rev 36808)
+++ gnunet/src/include/gnunet_env_lib.h 2016-01-12 12:43:09 UTC (rev 36809)
@@ -334,8 +334,7 @@
}
#endif
-/** @} */ /* end of group */
-
/* ifndef GNUNET_ENV_LIB_H */
#endif
-/* end of gnunet_env_lib.h */
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_fragmentation_lib.h
===================================================================
--- gnunet/src/include/gnunet_fragmentation_lib.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_fragmentation_lib.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -218,7 +218,6 @@
const struct GNUNET_MessageHeader *msg);
-/** @} */ /* end of group */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -227,5 +226,6 @@
}
#endif
-/* end of gnunet_fragmentation_lib.h */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_friends_lib.h
===================================================================
--- gnunet/src/include/gnunet_friends_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_friends_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -104,7 +104,6 @@
GNUNET_FRIENDS_write (struct GNUNET_FRIENDS_Writer *w,
const struct GNUNET_PeerIdentity *friend_id);
-/** @} */ /* end of group */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -114,3 +113,5 @@
#endif
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_fs_service.h
===================================================================
--- gnunet/src/include/gnunet_fs_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_fs_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -2814,7 +2814,6 @@
void
GNUNET_FS_share_tree_free (struct GNUNET_FS_ShareTreeItem *toplevel);
-/** @} */ /* end of group */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -2823,5 +2822,6 @@
}
#endif
+#endif
-#endif
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_getopt_lib.h
===================================================================
--- gnunet/src/include/gnunet_getopt_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_getopt_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -384,8 +384,9 @@
}
#endif
+/* ifndef GNUNET_GETOPT_LIB_H */
+#endif
+
/** @} */ /* end of group getopt */
-/* ifndef GNUNET_GETOPT_LIB_H */
-#endif
/* end of gnunet_getopt_lib.h */
Modified: gnunet/src/include/gnunet_gns_service.h
===================================================================
--- gnunet/src/include/gnunet_gns_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_gns_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -152,7 +152,6 @@
void
GNUNET_GNS_lookup_cancel (struct GNUNET_GNS_LookupRequest *lr);
-/** @} */ /* end of group */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -161,6 +160,6 @@
}
#endif
+#endif
-#endif
-/* gnunet_gns_service.h */
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_gnsrecord_lib.h
===================================================================
--- gnunet/src/include/gnunet_gnsrecord_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_gnsrecord_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -24,7 +24,7 @@
* @file
* API that can be used to manipulate GNS record data
*
- * @defgroup gns-record GNS record library
+ * @defgroup gns-record GNS Record library
* Manipulate GNS record data
* @{
*/
@@ -563,7 +563,6 @@
GNUNET_GNSRECORD_record_get_expiration_time (unsigned int rd_count,
const struct GNUNET_GNSRECORD_Data
*rd);
-/** @} */ /* end of group */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -573,3 +572,5 @@
#endif
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_hello_lib.h
===================================================================
--- gnunet/src/include/gnunet_hello_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_hello_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -443,7 +443,6 @@
struct GNUNET_HELLO_Message **hello,
GNUNET_HELLO_TransportPluginsFind plugins_find);
-/** @} */ /* end of group */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -452,7 +451,9 @@
}
#endif
-
/* ifndef GNUNET_HELLO_LIB_H */
#endif
+
+/** @} */ /* end of group */
+
/* end of gnunet_hello_lib.h */
Modified: gnunet/src/include/gnunet_helper_lib.h
===================================================================
--- gnunet/src/include/gnunet_helper_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_helper_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -174,7 +174,8 @@
void
GNUNET_HELPER_send_cancel (struct GNUNET_HELPER_SendHandle *sh);
-/** @} */ /* end of group */
#endif
/* end of include guard: GNUNET_HELPER_LIB_H */
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_identity_provider_service.h
===================================================================
--- gnunet/src/include/gnunet_identity_provider_service.h 2016-01-11
21:23:17 UTC (rev 36808)
+++ gnunet/src/include/gnunet_identity_provider_service.h 2016-01-12
12:43:09 UTC (rev 36809)
@@ -24,7 +24,7 @@
* @file
* Identity provider service; implements identity provider for GNUnet
*
- * @defgroup identity-provider Identity provider service
+ * @defgroup identity-provider Identity Provider service
* @{
*/
#ifndef GNUNET_IDENTITY_PROVIDER_SERVICE_H
@@ -227,8 +227,10 @@
}
#endif
-/** @} */ /* end of group identity */
/* ifndef GNUNET_IDENTITY_PROVIDER_SERVICE_H */
#endif
+
+/** @} */ /* end of group identity */
+
/* end of gnunet_identity_provider_service.h */
Modified: gnunet/src/include/gnunet_identity_service.h
===================================================================
--- gnunet/src/include/gnunet_identity_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_identity_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -326,8 +326,9 @@
}
#endif
+/* ifndef GNUNET_IDENTITY_SERVICE_H */
+#endif
+
/** @} */ /* end of group identity */
-/* ifndef GNUNET_IDENTITY_SERVICE_H */
-#endif
/* end of gnunet_identity_service.h */
Modified: gnunet/src/include/gnunet_load_lib.h
===================================================================
--- gnunet/src/include/gnunet_load_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_load_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -111,7 +111,6 @@
void
GNUNET_LOAD_update (struct GNUNET_LOAD_Value *load, uint64_t data);
-/** @} */ /* end of group */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -122,4 +121,7 @@
/* ifndef GNUNET_LOAD_LIB_H */
#endif
+
+/** @} */ /* end of group */
+
/* end of gnunet_load_lib.h */
Modified: gnunet/src/include/gnunet_microphone_lib.h
===================================================================
--- gnunet/src/include/gnunet_microphone_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_microphone_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -129,7 +129,6 @@
void
GNUNET_MICROPHONE_destroy (struct GNUNET_MICROPHONE_Handle *microphone);
-/** @} */ /* end of group */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -139,4 +138,7 @@
#endif
#endif
+
+/** @} */ /* end of group */
+
/* end of gnunet_microphone_lib.h */
Modified: gnunet/src/include/gnunet_mq_lib.h
===================================================================
--- gnunet/src/include/gnunet_mq_lib.h 2016-01-11 21:23:17 UTC (rev 36808)
+++ gnunet/src/include/gnunet_mq_lib.h 2016-01-12 12:43:09 UTC (rev 36809)
@@ -518,6 +518,6 @@
GNUNET_MQ_impl_state (struct GNUNET_MQ_Handle *mq);
+#endif
+
/** @} */ /* end of group mq */
-
-#endif
Modified: gnunet/src/include/gnunet_multicast_service.h
===================================================================
--- gnunet/src/include/gnunet_multicast_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_multicast_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -902,7 +902,6 @@
void
GNUNET_MULTICAST_member_to_origin_cancel (struct
GNUNET_MULTICAST_MemberTransmitHandle *th);
-/** @} */ /* end of group */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -913,4 +912,5 @@
/* ifndef GNUNET_MULTICAST_SERVICE_H */
#endif
-/* end of gnunet_multicast_service.h */
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_mysql_lib.h
===================================================================
--- gnunet/src/include/gnunet_mysql_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_mysql_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -207,7 +207,6 @@
struct GNUNET_MYSQL_StatementHandle *sh,
unsigned long long *insert_id, ...);
-/** @} */ /* end of group */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -216,5 +215,6 @@
}
#endif
-/* end of gnunet_mysql_lib.h */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_namecache_plugin.h
===================================================================
--- gnunet/src/include/gnunet_namecache_plugin.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_namecache_plugin.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_namecache_plugin.h
- * @brief plugin API for the namecache database backend
* @author Christian Grothoff
+ *
+ * @file
+ * Plugin API for the namecache database backend
+ *
+ * @defgroup namecache-plugin Name Cache service plugin API
+ * Plugin API for the namecache database backend.
+ * @{
*/
#ifndef GNUNET_NAMECACHE_PLUGIN_H
#define GNUNET_NAMECACHE_PLUGIN_H
@@ -97,5 +102,6 @@
}
#endif
-/* end of gnunet_namecache_plugin.h */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_namecache_service.h
===================================================================
--- gnunet/src/include/gnunet_namecache_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_namecache_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -19,12 +19,19 @@
*/
/**
- * @file include/gnunet_namecache_service.h
- * @brief API that can be used to store naming information on a GNUnet node;
- * Naming information can either be records for which this peer/user
- * is authoritative, or blocks which are cached, encrypted naming
- * data from other peers.
* @author Christian Grothoff
+ *
+ * @file
+ * API that can be used to store naming information on a GNUnet node.
+ *
+ * @defgroup namecache Name Cache service
+ * Store naming information on a GNUnet node.
+ *
+ * Naming information can either be records for which this peer/user is
+ * authoritative, or blocks which are cached, encrypted naming data from other
+ * peers.
+ *
+ * @{
*/
#ifndef GNUNET_NAMECACHE_SERVICE_H
#define GNUNET_NAMECACHE_SERVICE_H
@@ -159,5 +166,6 @@
}
#endif
-/* end of gnunet_namecache_service.h */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_namestore_plugin.h
===================================================================
--- gnunet/src/include/gnunet_namestore_plugin.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_namestore_plugin.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_namestore_plugin.h
- * @brief plugin API for the namestore database backend
* @author Christian Grothoff
+ *
+ * @file
+ * Plugin API for the namestore database backend
+ *
+ * @defgroup namestore-plugin Name Store service plugin API
+ * Plugin API for the namestore database backend
+ * @{
*/
#ifndef GNUNET_NAMESTORE_PLUGIN_H
#define GNUNET_NAMESTORE_PLUGIN_H
@@ -143,5 +148,6 @@
}
#endif
-/* end of gnunet_namestore_plugin.h */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_namestore_service.h
===================================================================
--- gnunet/src/include/gnunet_namestore_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_namestore_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -19,12 +19,19 @@
*/
/**
- * @file include/gnunet_namestore_service.h
- * @brief API that can be used to store naming information on a GNUnet node;
- * Naming information can either be records for which this peer/user
- * is authoritative, or blocks which are cached, encrypted naming
- * data from other peers.
* @author Christian Grothoff
+ *
+ * @file
+ * API that can be used to store naming information on a GNUnet node;
+ *
+ * @defgroup namestore Name Store service
+ * Store naming information on a GNUnet node.
+ *
+ * Naming information can either be records for which this peer/user is
+ * authoritative, or blocks which are cached, encrypted naming data from other
+ * peers.
+ *
+ * @{
*/
#ifndef GNUNET_NAMESTORE_SERVICE_H
#define GNUNET_NAMESTORE_SERVICE_H
@@ -305,7 +312,6 @@
GNUNET_NAMESTORE_zone_monitor_stop (struct GNUNET_NAMESTORE_ZoneMonitor *zm);
-
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
@@ -313,5 +319,6 @@
}
#endif
-/* end of gnunet_namestore_service.h */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_nat_lib.h
===================================================================
--- gnunet/src/include/gnunet_nat_lib.h 2016-01-11 21:23:17 UTC (rev 36808)
+++ gnunet/src/include/gnunet_nat_lib.h 2016-01-12 12:43:09 UTC (rev 36809)
@@ -19,11 +19,18 @@
*/
/**
- * @file include/gnunet_nat_lib.h
- * @brief Library handling UPnP and NAT-PMP port forwarding and
- * external IP address retrieval
* @author Christian Grothoff
* @author Milan Bouchet-Valat
+ *
+ * @file
+ * Library handling UPnP and NAT-PMP port forwarding
+ * and external IP address retrieval
+ *
+ * @defgroup nat NAT library
+ * Library handling UPnP and NAT-PMP port forwarding
+ * and external IP address retrieval
+ *
+ * @{
*/
#ifndef GNUNET_NAT_LIB_H
@@ -578,7 +585,8 @@
size_t len);
-
#endif
+/** @} */ /* end of group */
+
/* end of gnunet_nat_lib.h */
Modified: gnunet/src/include/gnunet_network_lib.h
===================================================================
--- gnunet/src/include/gnunet_network_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_network_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_network_lib.h
- * @brief basic low-level networking interface
* @author Nils Durner
+ *
+ * @file
+ * Basic low-level networking interface
+ *
+ * @defgroup network Network library
+ * Basic low-level networking interface
+ * @{
*/
#ifndef GNUNET_NETWORK_LIB_H
#define GNUNET_NETWORK_LIB_H
@@ -591,3 +596,5 @@
#endif
#endif /* GNUNET_NETWORK_LIB_H */
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_nse_service.h
===================================================================
--- gnunet/src/include/gnunet_nse_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_nse_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -22,13 +22,18 @@
#define GNUNET_NSE_SERVICE_H_
/**
+ * @author Nathan Evans
+ *
* @file
- * API to retrieve the current network size estimate,
+ * API to retrieve the current network size estimate
+ *
+ * @defgroup nse NSE service
+ * Network Size Estimation
+ *
+ * Provides an API to retrieve the current network size estimate,
* also to register for notifications whenever a new
* network size estimate is calculated.
*
- * @author Nathan Evans
- * @defgroup nse Network size estimation service
* @{
*/
Modified: gnunet/src/include/gnunet_os_lib.h
===================================================================
--- gnunet/src/include/gnunet_os_lib.h 2016-01-11 21:23:17 UTC (rev 36808)
+++ gnunet/src/include/gnunet_os_lib.h 2016-01-12 12:43:09 UTC (rev 36809)
@@ -19,9 +19,6 @@
*/
/**
- * @file
- * Low level process routines
- *
* @author Christian Grothoff
* @author Krista Bennett
* @author Gerd Knorr <address@hidden>
@@ -29,6 +26,12 @@
* @author Tzvetan Horozov
* @author Milan
*
+ * @file
+ * Low level process routines
+ *
+ * @defgroup os OS library
+ * Low level process routines.
+ *
* This code manages child processes. We can communicate with child
* processes using signals. Because signals are not supported on W32
* and Java (at least not nicely), we can alternatively use a pipe
@@ -38,6 +41,8 @@
* termination via signals, and not as a replacement for SIGKILL.
* Thus using pipes to communicate signals should only be enabled if
* the child is a Java process OR if we are on Windoze.
+ *
+ * @{
*/
#ifndef GNUNET_OS_LIB_H
@@ -528,7 +533,9 @@
}
#endif
-
/* ifndef GNUNET_OS_LIB_H */
#endif
+
+/** @} */ /* end of group */
+
/* end of gnunet_os_lib.h */
Modified: gnunet/src/include/gnunet_peer_lib.h
===================================================================
--- gnunet/src/include/gnunet_peer_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_peer_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_peer_lib.h
- * @brief helper library for interning of peer identifiers
* @author Christian Grothoff
+ *
+ * @file
+ * Helper library for interning of peer identifiers
+ *
+ * @defgroup peer Peer library
+ * Helper library for interning of peer identifiers
+ * @{
*/
#ifndef GNUNET_PEER_LIB_H
@@ -116,7 +121,9 @@
}
#endif
-
/* ifndef GNUNET_PEER_LIB_H */
#endif
+
+/** @} */ /* end of group */
+
/* end of gnunet_peer_lib.h */
Modified: gnunet/src/include/gnunet_peerinfo_service.h
===================================================================
--- gnunet/src/include/gnunet_peerinfo_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_peerinfo_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -18,10 +18,17 @@
Boston, MA 02110-1301, USA.
*/
/**
- * @file include/gnunet_peerinfo_service.h
- * @brief Code to maintain the list of currently known hosts
- * (in memory structure of data/hosts).
* @author Christian Grothoff
+ *
+ * @file
+ * Maintain the list of currently known hosts
+ *
+ * @defgroup peerinfo Peer Info service
+ * Maintain the list of currently known hosts.
+ *
+ * Holds an in-memory structure of data/hosts.
+ *
+ * @{
*/
#ifndef GNUNET_PEERINFO_SERVICE_H
@@ -223,6 +230,6 @@
}
#endif
+#endif
-/* end of gnunet_peerinfo_service.h */
-#endif
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_peerstore_plugin.h
===================================================================
--- gnunet/src/include/gnunet_peerstore_plugin.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_peerstore_plugin.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_peerstore_plugin.h
- * @brief plugin API for the peerstore database backend
* @author Omar Tarabai
+ *
+ * @file
+ * Plugin API for the peerstore database backend
+ *
+ * @defgroup peerstore-plugin Peer Store service plugin API
+ * Plugin API for the peerstore database backend
+ * @{
*/
#ifndef GNUNET_PEERSTORE_PLUGIN_H
#define GNUNET_PEERSTORE_PLUGIN_H
@@ -124,5 +129,6 @@
}
#endif
-/* end of gnunet_peerstore_plugin.h */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_peerstore_service.h
===================================================================
--- gnunet/src/include/gnunet_peerstore_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_peerstore_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_peerstore_service.h
- * @brief API to the peerstore service
* @author Omar Tarabai
+ *
+ * @file
+ * API to the peerstore service
+ *
+ * @defgroup peerstore Peer Store service
+ *
+ * @{
*/
#ifndef GNUNET_PEERSTORE_SERVICE_H
#define GNUNET_PEERSTORE_SERVICE_H
@@ -253,6 +258,7 @@
void
GNUNET_PEERSTORE_watch_cancel (struct GNUNET_PEERSTORE_WatchContext *wc);
+
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
@@ -261,3 +267,5 @@
#endif
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_plugin_lib.h
===================================================================
--- gnunet/src/include/gnunet_plugin_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_plugin_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_plugin_lib.h
- * @brief plugin loading and unloading
* @author Christian Grothoff
+ *
+ * @file
+ * Plugin loading and unloading
+ *
+ * @defgroup plugin Plugin library
+ * Plugin loading and unloading
+ * @{
*/
#ifndef GNUNET_PLUGIN_LIB_H
@@ -131,7 +136,9 @@
}
#endif
-
/* ifndef GNUNET_PLUGIN_LIB_H */
#endif
+
+/** @} */ /* end of group */
+
/* end of gnunet_plugin_lib.h */
Modified: gnunet/src/include/gnunet_postgres_lib.h
===================================================================
--- gnunet/src/include/gnunet_postgres_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_postgres_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -18,9 +18,14 @@
Boston, MA 02110-1301, USA.
*/
/**
- * @file include/gnunet_postgres_lib.h
- * @brief library to help with access to a Postgres database
* @author Christian Grothoff
+ *
+ * @file
+ * Helper library to access a PostgreSQL database
+ *
+ * @defgroup postgres PostgreSQL library
+ * Helper library to access a PostgreSQL database.
+ * @{
*/
#ifndef GNUNET_POSTGRES_LIB_H
#define GNUNET_POSTGRES_LIB_H
@@ -151,7 +156,6 @@
uint32_t rowid);
-
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
@@ -159,5 +163,6 @@
}
#endif
-/* end of gnunet_postgres_lib.h */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_program_lib.h
===================================================================
--- gnunet/src/include/gnunet_program_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_program_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,11 +19,13 @@
*/
/**
+ * @author Christian Grothoff
+ *
* @file
* Functions related to starting programs
*
- * @author Christian Grothoff
- * @defgroup program Functions for writing command-line programs
+ * @defgroup program Program library
+ * Start command-line programs.
* @{
*/
@@ -104,7 +106,6 @@
GNUNET_PROGRAM_Main task, void *task_cls);
-
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
@@ -112,8 +113,9 @@
}
#endif
-/** @} */ /* end of group program */
-
/* ifndef GNUNET_PROGRAM_LIB_H */
#endif
+
+/** @} */ /* end of group program */
+
/* end of gnunet_program_lib.h */
Modified: gnunet/src/include/gnunet_protocols.h
===================================================================
--- gnunet/src/include/gnunet_protocols.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_protocols.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,10 +19,13 @@
*/
/**
- * @file include/gnunet_protocols.h
- * @brief constants for network protocols
* @author Christian Grothoff
- * @defgroup protocols Types of messages used in GNUnet
+ *
+ * @file
+ * Constants for network protocols
+ *
+ * @defgroup protocols Network protocol definitions
+ * Types of messages used in GNUnet.
* @{
*/
@@ -2857,8 +2860,9 @@
}
#endif
+/* ifndef GNUNET_PROTOCOLS_H */
+#endif
+
/** @} */ /* end of group protocols */
-/* ifndef GNUNET_PROTOCOLS_H */
-#endif
/* end of gnunet_protocols.h */
Modified: gnunet/src/include/gnunet_psyc_service.h
===================================================================
--- gnunet/src/include/gnunet_psyc_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_psyc_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,20 +19,24 @@
*/
/**
- * @file include/gnunet_psyc_service.h
- * @brief PSYC service; high-level access to the PSYC protocol
- * note that clients of this API are NOT expected to
- * understand the PSYC message format, only the semantics!
- * Parsing (and serializing) the PSYC stream format is done
- * within the implementation of the libgnunetpsyc library,
- * and this API deliberately exposes as little as possible
- * of the actual data stream format to the application!
+ * @author Gabor X Toth
* @author Christian Grothoff
- * @author Gabor X Toth
*
+ * @file
+ * PSYC service
+ *
+ * @defgroup psyc PSYC service
+ * Send/receive messages in PSYC channels and access the PSYC Store.
+ *
+ * Note that clients of this API are NOT expected to understand the PSYC
message
+ * format, only the semantics! Parsing (and serializing) the PSYC stream
format
+ * is done within the implementation of the libgnunetpsyc library, and this API
+ * deliberately exposes as little as possible of the actual data stream format
+ * to the application!
+ *
* NOTE:
- * - this API does not know about psyc's "root" and "places";
- * there is no 'root' in GNUnet-Psyc as we're decentralized;
+ * - this API does not know about PSYC's "root" and "places";
+ * there is no 'root' in GNUnet-PSYC as we're decentralized;
* 'places' and 'persons' are combined within the same
* abstraction, that of a "channel". Channels are identified
* and accessed in this API using a public/private key.
@@ -72,6 +76,8 @@
* be called 'PSYC-low', whereas a higher-level API
* implementing defaults for standard methods and
* variables might be called 'PSYC-std' or 'PSYC-high'.
+ *
+ * @{
*/
#ifndef GNUNET_PSYC_SERVICE_H
@@ -1331,4 +1337,5 @@
/* ifndef GNUNET_PSYC_SERVICE_H */
#endif
-/* end of gnunet_psyc_service.h */
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_psyc_util_lib.h
===================================================================
--- gnunet/src/include/gnunet_psyc_util_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_psyc_util_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_psyc_service.h
- * @brief PSYC utilities; receiving/transmitting/logging PSYC messages.
* @author Gabor X Toth
+ *
+ * @file
+ * PSYC utilities; receiving/transmitting/logging PSYC messages
+ *
+ * @defgroup psyc-util PSYC Utilities library
+ * Receiving, transmitting, logging PSYC messages.
+ * @{
*/
#ifndef GNUNET_PSYC_UTIL_LIB_H
@@ -263,4 +268,5 @@
/* ifndef GNUNET_PSYC_UTIL_LIB_H */
#endif
-/* end of gnunet_psyc_util_lib.h */
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_psycstore_plugin.h
===================================================================
--- gnunet/src/include/gnunet_psycstore_plugin.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_psycstore_plugin.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_psycstore_plugin.h
- * @brief plugin API for the PSYCstore database backend
* @author Gabor X Toth
+ *
+ * @file
+ * Plugin API for the PSYCstore database backend
+ *
+ * @defgroup psycstore-plugin PSYC Store plugin API
+ * Plugin API for the PSYC Store database backend
+ * @{
*/
#ifndef GNUNET_PSYCSTORE_PLUGIN_H
#define GNUNET_PSYCSTORE_PLUGIN_H
@@ -373,5 +378,6 @@
}
#endif
-/* end of gnunet_psycstore_plugin.h */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_psycstore_service.h
===================================================================
--- gnunet/src/include/gnunet_psycstore_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_psycstore_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -19,10 +19,15 @@
*/
/**
- * @file include/gnunet_psycstore_service.h
- * @brief PSYCstore service; implements persistent storage for the PSYC service
* @author Gabor X Toth
* @author Christian Grothoff
+ *
+ * @file
+ * PSYCstore service; implements persistent storage for the PSYC service
+ *
+ * @defgroup psycstore PSYC Store service
+ * Persistent storage for the PSYC service.
+ * @{
*/
#ifndef GNUNET_PSYCSTORE_SERVICE_H
#define GNUNET_PSYCSTORE_SERVICE_H
@@ -692,4 +697,5 @@
/* ifndef GNUNET_PSYCSTORE_SERVICE_H */
#endif
-/* end of gnunet_psycstore_service.h */
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_regex_service.h
===================================================================
--- gnunet/src/include/gnunet_regex_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_regex_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -18,11 +18,18 @@
Boston, MA 02110-1301, USA.
*/
/**
- * @file include/gnunet_regex_service.h
- * @brief access regex service to advertise capabilities via regex and discover
- * respective peers using matching strings
* @author Maximilian Szengel
* @author Christian Grothoff
+ *
+ * @file
+ * API to access regex service to advertise capabilities via regex and discover
+ * respective peers using matching strings
+ *
+ * @defgroup regex RegEx service
+ * Advertise capabilities via RegEx and discover
+ * respective peers using matching strings.
+ *
+ * @{
*/
#ifndef GNUNET_REGEX_SERVICE_H
#define GNUNET_REGEX_SERVICE_H
@@ -136,5 +143,6 @@
}
#endif
-/* end of gnunet_regex_service.h */
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_resolver_service.h
===================================================================
--- gnunet/src/include/gnunet_resolver_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_resolver_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -173,8 +173,9 @@
}
#endif
-/** @} */ /* end of group resolver */
-
/* ifndef GNUNET_RESOLVER_SERVICE_H */
#endif
+
+/** @} */ /* end of group resolver */
+
/* end of gnunet_resolver_service.h */
Modified: gnunet/src/include/gnunet_rest_lib.h
===================================================================
--- gnunet/src/include/gnunet_rest_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_rest_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_rest_lib.h
- * @brief API for helper library to parse/create REST
* @author Martin Schanzenbach
+ *
+ * @file
+ * API for helper library to parse/create REST
+ *
+ * @defgroup rest REST library
+ * Helper library to parse/create REST
+ * @{
*/
#ifndef GNUNET_REST_LIB_H
#define GNUNET_REST_LIB_H
@@ -159,7 +164,7 @@
GNUNET_REST_jsonapi_resource_check_type (const struct JsonApiResource
*resource,
const char* type);
-
+
/**
* Create a JSON API primary data
*
@@ -180,7 +185,7 @@
struct JsonApiObject*
GNUNET_REST_jsonapi_object_parse (const char* data);
-
+
/**
* Delete a JSON API primary data
*
@@ -268,4 +273,7 @@
const struct GNUNET_REST_RestConnectionHandler
*handlers,
void *cls);
+
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_rest_plugin.h
===================================================================
--- gnunet/src/include/gnunet_rest_plugin.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_rest_plugin.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,9 +19,12 @@
*/
/**
* @author Martin Schanzenbach
- * @file include/gnunet_rest_plugin.h
- * @brief GNUnet service REST plugin header
*
+ * @file
+ * GNUnet service REST plugin header
+ *
+ * @defgroup rest-plugin REST plugin for GNUnet services
+ * @{
*/
#ifndef GNUNET_REST_PLUGIN_H
#define GNUNET_REST_PLUGIN_H
@@ -60,7 +63,7 @@
/**
* Function to process a REST call
- *
+ *
* @param method the HTTP method called
* @param url the relative url accessed
* @param data the REST data (can be NULL)
@@ -82,6 +85,6 @@
}
#endif
-/* end of gnunet_rest_plugin.h */
#endif
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_revocation_service.h
===================================================================
--- gnunet/src/include/gnunet_revocation_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_revocation_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -22,10 +22,13 @@
#define GNUNET_REVOCATION_SERVICE_H_
/**
- * @file include/gnunet_revocation_service.h
- * @brief API to perform and access key revocations
* @author Christian Grothoff
- * @defgroup revocation Key revocation service
+ *
+ * @file
+ * API to perform and access key revocations
+ *
+ * @defgroup revocation Revocation service
+ * Perform and access key revocations.
* @{
*/
@@ -157,6 +160,6 @@
}
#endif
+#endif /* GNUNET_REVOCATION_SERVICE_H_ */
+
/** @} */ /* end of group revocation */
-
-#endif /* GNUNET_REVOCATION_SERVICE_H_ */
Modified: gnunet/src/include/gnunet_rps_service.h
===================================================================
--- gnunet/src/include/gnunet_rps_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_rps_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -1,6 +1,6 @@
/*
This file is part of GNUnet
- Copyright (C)
+ Copyright (C)
GNUnet is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_rps_service.h
- * @brief API to the rps service
* @author Julius Bünger
+ *
+ * @file
+ * API to the rps service
+ *
+ * @defgroup rps RPS service
+ * Random Peer Sampling
+ * @{
*/
#ifndef GNUNET_RPS_SERVICE_H
#define GNUNET_RPS_SERVICE_H
@@ -140,6 +145,7 @@
void
GNUNET_RPS_disconnect (struct GNUNET_RPS_Handle *h);
+
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
@@ -148,3 +154,5 @@
#endif
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_scalarproduct_service.h
===================================================================
--- gnunet/src/include/gnunet_scalarproduct_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_scalarproduct_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -19,10 +19,15 @@
*/
/**
- * @file include/gnunet_scalarproduct_service.h
- * @brief API to the scalarproduct service
* @author Christian M. Fuchs
* @author Gaurav Kukreja
+ *
+ * @file
+ * API to the scalarproduct service
+ *
+ * @defgroup scalarproduct Scalar Product service
+ *
+ * @{
*/
#ifndef GNUNET_SCALARPRODUCT_SERVICE_H
#define GNUNET_SCALARPRODUCT_SERVICE_H
@@ -183,6 +188,7 @@
void
GNUNET_SCALARPRODUCT_cancel (struct GNUNET_SCALARPRODUCT_ComputationHandle *h);
+
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
@@ -191,3 +197,5 @@
#endif
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_scheduler_lib.h
===================================================================
--- gnunet/src/include/gnunet_scheduler_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_scheduler_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,10 +19,16 @@
*/
/**
- * @file include/gnunet_scheduler_lib.h
- * @brief API to schedule computations using continuation passing style
* @author Christian Grothoff
- * @defgroup scheduler Event loop (scheduler)
+ *
+ * @file
+ * API to schedule computations using continuation passing style
+ *
+ * @defgroup scheduler Scheduler library
+ * Event loop (scheduler)
+ *
+ * Schedule computations using continuation passing style.
+ *
* @{
*/
@@ -537,8 +543,6 @@
void *new_select_cls);
-/** @} */ /* end of group scheduler */
-
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
@@ -547,3 +551,5 @@
#endif
#endif
+
+/** @} */ /* end of group scheduler */
Modified: gnunet/src/include/gnunet_secretsharing_service.h
===================================================================
--- gnunet/src/include/gnunet_secretsharing_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_secretsharing_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_secretsharing_service.h
- * @brief verifiable additive secret sharing and cooperative decryption
* @author Florian Dold
+ *
+ * @file
+ * Verifiable additive secret sharing and cooperative decryption
+ *
+ * @defgroup secretsharing Secret Sharing service
+ * Verifiable additive secret sharing and cooperative decryption.
+ * @{
*/
#ifndef GNUNET_SECRETSHARING_SERVICE_H
@@ -319,8 +324,6 @@
int64_t exponent);
-
-
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
@@ -329,3 +332,5 @@
#endif
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_sensor_service.h
===================================================================
--- gnunet/src/include/gnunet_sensor_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_sensor_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -1,6 +1,6 @@
/*
This file is part of GNUnet
- Copyright (C)
+ Copyright (C)
GNUnet is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published
@@ -19,10 +19,16 @@
*/
/**
- * @file include/gnunet_sensor_service.h
- * @brief API to the sensor service
* @author Omar Tarabai
+ *
+ * @file
+ * API to the sensor service
+ *
+ * @defgroup sensor Sensor service
+ *
+ * @{
*/
+
#ifndef GNUNET_SENSOR_SERVICE_H
#define GNUNET_SENSOR_SERVICE_H
@@ -180,6 +186,7 @@
int anomalous, GNUNET_SENSOR_Continuation cont,
void *cont_cls);
+
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
@@ -188,3 +195,5 @@
#endif
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_sensor_util_lib.h
===================================================================
--- gnunet/src/include/gnunet_sensor_util_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_sensor_util_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file sensor/sensor_util_lib.c
- * @brief sensor utilities
* @author Omar Tarabai
+ *
+ * @file
+ * Sensor utilities
+ *
+ * @defgroup sensor Sensor Utilities library
+ *
+ * @{
*/
#ifndef GNUNET_SENSOR_UTIL_LIB_H
@@ -509,4 +514,7 @@
/* ifndef GNUNET_SENSOR_UTIL_LIB_H */
#endif
+
+/** @} */ /* end of group */
+
/* end of gnunet_sensor_util_lib.h */
Modified: gnunet/src/include/gnunet_sensordashboard_service.h
===================================================================
--- gnunet/src/include/gnunet_sensordashboard_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_sensordashboard_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -1,6 +1,6 @@
/*
This file is part of GNUnet
- Copyright (C)
+ Copyright (C)
GNUnet is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_sensordashboard_service.h
- * @brief API to the sensordashboard service
* @author Omar Tarabai
+ *
+ * @file
+ * API to the sensordashboard service
+ *
+ * @defgroup sensordashboard Sensor Dashboard service
+ *
+ * @{
*/
#ifndef GNUNET_SENSORDASHBOARD_SERVICE_H
#define GNUNET_SENSORDASHBOARD_SERVICE_H
@@ -46,3 +51,5 @@
#endif
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_server_lib.h
===================================================================
--- gnunet/src/include/gnunet_server_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_server_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,10 +19,16 @@
*/
/**
- * @file include/gnunet_server_lib.h
- * @brief library for building GNUnet network servers
* @author Christian Grothoff
- * @defgroup server Functions for a server that communicates with clients
+ *
+ * @file
+ * Library for building GNUnet network servers
+
+ * @defgroup server Server library
+ * Library for building GNUnet network servers
+ *
+ * Provides functions for a server that communicates with clients.
+ *
* @{
*/
@@ -851,8 +857,9 @@
}
#endif
-/** @} */ /* end of group server */
-
/* ifndef GNUNET_SERVER_LIB_H */
#endif
+
+/** @} */ /* end of group server */
+
/* end of gnunet_server_lib.h */
Modified: gnunet/src/include/gnunet_service_lib.h
===================================================================
--- gnunet/src/include/gnunet_service_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_service_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,10 +19,13 @@
*/
/**
- * @file include/gnunet_service_lib.h
- * @brief functions related to starting services
* @author Christian Grothoff
- * @defgroup service Generic functions for implementing service processes
+ *
+ * @file
+ * Functions related to starting services
+ *
+ * @defgroup service Service library
+ * Start service processes.
* @{
*/
@@ -186,10 +189,9 @@
}
#endif
+/* ifndef GNUNET_SERVICE_LIB_H */
+#endif
-/** @} */ /* end of group service */
+/** @} */ /* end of group service */
-
-/* ifndef GNUNET_SERVICE_LIB_H */
-#endif
/* end of gnunet_service_lib.h */
Modified: gnunet/src/include/gnunet_set_service.h
===================================================================
--- gnunet/src/include/gnunet_set_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_set_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,10 +19,15 @@
*/
/**
- * @file include/gnunet_set_service.h
- * @brief two-peer set operations
* @author Florian Dold
* @author Christian Grothoff
+ *
+ * @file
+ * Two-peer set operations
+ *
+ * @defgroup set Set service
+ * Two-peer set operations
+ * @{
*/
#ifndef GNUNET_SET_SERVICE_H
@@ -161,7 +166,7 @@
* Client gets notified of the required changes
* for both the local and the remote set.
*
- * Only supported for set
+ * Only supported for set
*/
GNUNET_SET_RESULT_SYMMETRIC,
@@ -499,3 +504,5 @@
#endif
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_signal_lib.h
===================================================================
--- gnunet/src/include/gnunet_signal_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_signal_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_signal_lib.h
- * @brief functions related to signals
* @author Christian Grothoff
+ *
+ * @file
+ * Functions related to signals
+ *
+ * @defgroup signal Signal library
+ * Manage signal handlers.
+ * @{
*/
#ifndef GNUNET_SIGNAL_LIB_H
@@ -97,4 +102,7 @@
/* ifndef GNUNET_SIGNAL_LIB_H */
#endif
+
+/** @} */ /* end of group */
+
/* end of gnunet_signal_lib.h */
Modified: gnunet/src/include/gnunet_signatures.h
===================================================================
--- gnunet/src/include/gnunet_signatures.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_signatures.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,9 +19,13 @@
*/
/**
- * @file include/gnunet_signatures.h
- * @brief constants for network signatures
* @author Christian Grothoff
+ *
+ * @file
+ * Constants for network signatures
+ *
+ * @defgroup signatures Network signature definitions
+ * @{
*/
#ifndef GNUNET_SIGNATURES_H
@@ -195,4 +199,7 @@
/* ifndef GNUNET_SIGNATURES_H */
#endif
+
+/** @} */ /* end of group */
+
/* end of gnunet_signatures.h */
Modified: gnunet/src/include/gnunet_social_service.h
===================================================================
--- gnunet/src/include/gnunet_social_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_social_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -1514,7 +1514,6 @@
GNUNET_ResultCallback result_cb,
void *result_cls);
-/** @} */ /* end of group social */
#if 0 /* keep Emacsens' auto-indent happy */
{
@@ -1525,4 +1524,5 @@
/* ifndef GNUNET_SOCIAL_SERVICE_H */
#endif
-/* end of gnunet_social_service.h */
+
+/** @} */ /* end of group social */
Modified: gnunet/src/include/gnunet_socks.h
===================================================================
--- gnunet/src/include/gnunet_socks.h 2016-01-11 21:23:17 UTC (rev 36808)
+++ gnunet/src/include/gnunet_socks.h 2016-01-12 12:43:09 UTC (rev 36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_socks.h
- * @brief SOCKS proxy for connections
* @author Jeffrey Burdges
+ *
+ * @file
+ * SOCKS proxy for connections
+ *
+ * @defgroup socks SOCKS proxy
+ * SOCKS proxy for connections.
+ * @{
*/
#ifndef GNUNET_SOCKS_H
@@ -71,7 +76,9 @@
}
#endif
-
/* ifndef GNUNET_SOCKS_H */
#endif
+
+/** @} */ /* end of group */
+
/* end of gnunet_socks.h */
Modified: gnunet/src/include/gnunet_speaker_lib.h
===================================================================
--- gnunet/src/include/gnunet_speaker_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_speaker_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,11 +19,16 @@
*/
/**
- * @file include/gnunet_speaker_lib.h
- * @brief API to access an audio speaker; provides access to hardware speakers
* @author Simon Dieterle
* @author Andreas Fuchs
* @author Christian Grothoff
+ *
+ * @file
+ * API to access an audio speaker; provides access to hardware speakers
+ *
+ * @defgroup speaker Speaker service
+ * Access hardware audio speakers.
+ * @{
*/
#ifndef GNUNET_SPEAKER_SERVICE_H
#define GNUNET_SPEAKER_SERVICE_H
@@ -135,4 +140,7 @@
#endif
#endif
+
+/** @} */ /* end of group */
+
/* end of gnunet_speaker_lib.h */
Modified: gnunet/src/include/gnunet_statistics_service.h
===================================================================
--- gnunet/src/include/gnunet_statistics_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_statistics_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -19,12 +19,18 @@
*/
/**
- * @file include/gnunet_statistics_service.h
- * @brief API to create, modify and access statistics about
- * the operation of GNUnet; all statistical values
- * must be of type `unsigned long long`.
* @author Christian Grothoff
- * @defgroup statistics Track statistics or provide access to statistics
+ *
+ * @file
+ * API to create, modify and access statistics.
+ *
+ * @defgroup statistics Statistics service
+ * Track statistics or provide access to statistics.
+ *
+ * Create, modify and access statistics about the operation of GNUnet.
+ *
+ * All statistical values must be of type `unsigned long long`.
+ *
* @{
*/
Modified: gnunet/src/include/gnunet_strings_lib.h
===================================================================
--- gnunet/src/include/gnunet_strings_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_strings_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,15 +19,18 @@
*/
/**
- * @file include/gnunet_strings_lib.h
- * @brief strings and string handling functions (including malloc
- * and string tokenizing)
- *
* @author Christian Grothoff
* @author Krista Bennett
* @author Gerd Knorr <address@hidden>
* @author Ioana Patrascu
* @author Tzvetan Horozov
+ *
+ * @file
+ * Strings and string handling functions
+ *
+ * @defgroup strings Strings library
+ * Strings and string handling functions, including malloc and string
tokenizing.
+ * @{
*/
#ifndef GNUNET_STRINGS_LIB_H
@@ -615,7 +618,9 @@
}
#endif
-
/* ifndef GNUNET_UTIL_STRING_H */
#endif
+
+/** @} */ /* end of group */
+
/* end of gnunet_util_string.h */
Modified: gnunet/src/include/gnunet_testbed_logger_service.h
===================================================================
--- gnunet/src/include/gnunet_testbed_logger_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_testbed_logger_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_testbed_logger_service.h
- * @brief API for submitting data to the testbed logger service
* @author Sree Harsha Totakura <address@hidden>
+ *
+ * @file
+ * API for submitting data to the testbed logger service
+ *
+ * @defgroup testbed-logger Testbed Logger service
+ * Submit data to the testbed logger service.
+ * @{
*/
#ifndef GNUNET_TESTBED_LOGGER_SERVICE_H
@@ -122,4 +127,6 @@
#endif /* GNUNET_TESTBED_LOGGER_SERVICE_H */
+/** @} */ /* end of group */
+
/* End of gnunet_testbed_logger_service.h */
Modified: gnunet/src/include/gnunet_testbed_service.h
===================================================================
--- gnunet/src/include/gnunet_testbed_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_testbed_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,10 +19,14 @@
*/
/**
- * @file include/gnunet_testbed_service.h
- * @brief API for writing tests and creating large-scale
- * emulation testbeds for GNUnet.
* @author Christian Grothoff
+ *
+ * @file
+ * API for writing tests and creating large-scale emulation testbeds for
GNUnet.
+ *
+ * @defgroup testbed Testbed service
+ * Writing tests and creating large-scale emulation testbeds for GNUnet.
+ * @{
*/
#ifndef GNUNET_TESTBED_SERVICE_H
@@ -1716,3 +1720,5 @@
#endif
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_testing_lib.h
===================================================================
--- gnunet/src/include/gnunet_testing_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_testing_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,15 +19,21 @@
*/
/**
- * @file include/gnunet_testing_lib.h
- * @brief convenience API for writing testcases for GNUnet;
- * can start/stop one or more peers on a system;
- * testing is responsible for managing private keys,
- * ports and paths; it is a low-level library that
- * does not support higher-level functions such as
- * P2P connection, topology management or distributed
- * testbed maintenance (those are in gnunet_testbed_service.h)
* @author Christian Grothoff
+ *
+ * @file
+ * Convenience API for writing testcases for GNUnet
+ *
+ * @defgroup testing Testing library
+ * Library for writing testcases for GNUnet.
+ *
+ * It can start/stop one or more peers on a system; testing is responsible for
+ * managing private keys, ports and paths; it is a low-level library that does
+ * not support higher-level functions such as P2P connection, topology
+ * management or distributed testbed maintenance (those are provided by the
+ * [Testbed service](@ref testbed))
+ *
+ * @{
*/
#ifndef GNUNET_TESTING_LIB_H
@@ -460,3 +466,5 @@
#endif
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_time_lib.h
===================================================================
--- gnunet/src/include/gnunet_time_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_time_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,10 +19,13 @@
*/
/**
- * @file include/gnunet_time_lib.h
- * @brief functions related to time
* @author Christian Grothoff
- * @defgroup time Time and time calculations
+ *
+ * @file
+ * Functions related to time
+ *
+ * @defgroup time Time library
+ * Time and time calculations.
* @{
*/
@@ -521,9 +524,9 @@
}
#endif
+/* ifndef GNUNET_TIME_LIB_H */
+#endif
+
/** @} */ /* end of group time */
-
-/* ifndef GNUNET_TIME_LIB_H */
-#endif
/* end of gnunet_time_lib.h */
Modified: gnunet/src/include/gnunet_transport_plugin.h
===================================================================
--- gnunet/src/include/gnunet_transport_plugin.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_transport_plugin.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -19,14 +19,19 @@
*/
/**
- * @file include/gnunet_transport_plugin.h
- * @brief API for the transport services. This header
- * specifies the struct that is given to the plugin's entry
- * method and the other struct that must be returned.
- * Note that the destructors of transport plugins will
- * be given the value returned by the constructor
- * and is expected to return a NULL pointer.
* @author Christian Grothoff
+ *
+ * @file
+ * Transport service plugin API
+ *
+ * @defgroup transport-plugin Transport Service plugin API
+ *
+ * Specifies the struct that is given to the plugin's entry method and the
other
+ * struct that must be returned. Note that the destructors of transport
plugins
+ * will be given the value returned by the constructor and is expected to
return
+ * a NULL pointer.
+ *
+ * @{
*/
#ifndef PLUGIN_TRANSPORT_H
#define PLUGIN_TRANSPORT_H
@@ -706,4 +711,7 @@
/*#ifndef PLUGIN_TRANSPORT_H*/
#endif
+
+/** @} */ /* end of group */
+
/* end of gnunet_transport_plugin.h */
Modified: gnunet/src/include/gnunet_transport_service.h
===================================================================
--- gnunet/src/include/gnunet_transport_service.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_transport_service.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_transport_service.h
- * @brief low-level P2P IO
* @author Christian Grothoff
+ *
+ * @file
+ * Low-level P2P IO
+ *
+ * @defgroup transport Transport service
+ * Low-level P2P IO
+ * @{
*/
#ifndef GNUNET_TRANSPORT_SERVICE_H
@@ -950,4 +955,7 @@
/* ifndef GNUNET_TRANSPORT_SERVICE_H */
#endif
+
+/** @} */ /* end of group */
+
/* end of gnunet_transport_service.h */
Modified: gnunet/src/include/gnunet_tun_lib.h
===================================================================
--- gnunet/src/include/gnunet_tun_lib.h 2016-01-11 21:23:17 UTC (rev 36808)
+++ gnunet/src/include/gnunet_tun_lib.h 2016-01-12 12:43:09 UTC (rev 36809)
@@ -19,10 +19,15 @@
*/
/**
- * @file include/gnunet_tun_lib.h
- * @brief standard TCP/IP network structs and IP checksum calculations for TUN
interaction
* @author Philipp Toelke
* @author Christian Grothoff
+ *
+ * @file
+ * Standard TCP/IP network structs and IP checksum calculations for TUN
interaction
+ *
+ * @defgroup tun TUN library
+ * Standard TCP/IP network structs and IP checksum calculations for TUN
interaction
+ * @{
*/
#ifndef GNUNET_TUN_LIB_H
#define GNUNET_TUN_LIB_H
@@ -912,3 +917,5 @@
struct GNUNET_HashCode *hc);
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/gnunet_util_lib.h
===================================================================
--- gnunet/src/include/gnunet_util_lib.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_util_lib.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,10 +19,10 @@
*/
/**
- * @file include/gnunet_util_lib.h
- * @brief convenience header including all headers of subsystems in
- * gnunet_util library
* @author Christian Grothoff
+ *
+ * @file
+ * Convenience header including all headers of subsystems in the gnunet_util
library
*/
#ifndef GNUNET_UTIL_LIB_H
Modified: gnunet/src/include/gnunet_util_taler_wallet_lib.h
===================================================================
--- gnunet/src/include/gnunet_util_taler_wallet_lib.h 2016-01-11 21:23:17 UTC
(rev 36808)
+++ gnunet/src/include/gnunet_util_taler_wallet_lib.h 2016-01-12 12:43:09 UTC
(rev 36809)
@@ -19,15 +19,16 @@
*/
/**
- * @file include/gnunet_util_taler_wallet_lib.h
- * @brief convenience header including all headers of subsystems in
- * gnunet_util_taler_wallet library. Note that (due to the
- * structure of the original headers), not all symbols declared
- * by the included headers are actually included in the
- * gnunet_util_taler_wallet library! The library excludes anything
- * relating to the GNUnet installation location, scheduler, networking
- * or OS-specific logic that would not apply to Apps/Browser extensions.
* @author Christian Grothoff
+ *
+ * @file
+ * Convenience header including all headers of subsystems in
+ * gnunet_util_taler_wallet library. Note that (due to the structure of the
+ * original headers), not all symbols declared by the included headers are
+ * actually included in the gnunet_util_taler_wallet library! The library
+ * excludes anything relating to the GNUnet installation location, scheduler,
+ * networking or OS-specific logic that would not apply to Apps/Browser
+ * extensions.
*/
#ifndef GNUNET_UTIL_TALER_WALLET_LIB_H
Modified: gnunet/src/include/gnunet_vpn_service.h
===================================================================
--- gnunet/src/include/gnunet_vpn_service.h 2016-01-11 21:23:17 UTC (rev
36808)
+++ gnunet/src/include/gnunet_vpn_service.h 2016-01-12 12:43:09 UTC (rev
36809)
@@ -19,9 +19,14 @@
*/
/**
- * @file include/gnunet_vpn_service.h
- * @brief API to access the VPN service.
* @author Christian Grothoff
+ *
+ * @file
+ * API to access the VPN service.
+ *
+ * @defgroup vpn VPN service
+ *
+ * @{
*/
#ifndef GNUNET_VPN_SERVICE_H
#define GNUNET_VPN_SERVICE_H
@@ -99,7 +104,7 @@
GNUNET_VPN_AllocationCallback cb,
void *cb_cls);
-
+
/**
* Tell the VPN that forwarding to the Internet via some exit node is
* requested. Note that both UDP and TCP traffic will be forwarded,
@@ -152,3 +157,5 @@
GNUNET_VPN_disconnect (struct GNUNET_VPN_Handle *vh);
#endif
+
+/** @} */ /* end of group */
Modified: gnunet/src/include/platform.h
===================================================================
--- gnunet/src/include/platform.h 2016-01-11 21:23:17 UTC (rev 36808)
+++ gnunet/src/include/platform.h 2016-01-12 12:43:09 UTC (rev 36809)
@@ -19,10 +19,12 @@
*/
/**
- * @file include/platform.h
- * @brief plaform specific includes and defines
* @author Nils Durner
* @author Christian Grothoff
+ *
+ * @file
+ * Plaform specific includes and defines.
+ *
* This file should never be included by installed
* header files (those starting with "gnunet_").
*/
Modified: gnunet/src/include/plibc.h
===================================================================
--- gnunet/src/include/plibc.h 2016-01-11 21:23:17 UTC (rev 36808)
+++ gnunet/src/include/plibc.h 2016-01-12 12:43:09 UTC (rev 36809)
@@ -18,10 +18,12 @@
*/
/**
- * @file include/plibc.h
- * @brief PlibC header
+ * @file
+ * PlibC header
+ *
* @attention This file is usually not installed under Unix,
* so ship it with your application
+ *
* @version $Revision: 158 $
*/
Modified: gnunet/src/include/tap-windows.h
===================================================================
--- gnunet/src/include/tap-windows.h 2016-01-11 21:23:17 UTC (rev 36808)
+++ gnunet/src/include/tap-windows.h 2016-01-12 12:43:09 UTC (rev 36809)
@@ -22,8 +22,9 @@
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
/**
- * @file include/tap-windows.h
- * @brief TAP32 virtual network driver defines
+ * @file
+ * TAP32 virtual network driver defines
+ *
* @attention This file is part of openvpn and for kept
* as a separate file to allow easier upgrading.
*/
Modified: gnunet/src/include/winproc.h
===================================================================
--- gnunet/src/include/winproc.h 2016-01-11 21:23:17 UTC (rev 36808)
+++ gnunet/src/include/winproc.h 2016-01-12 12:43:09 UTC (rev 36809)
@@ -19,9 +19,10 @@
*/
/**
- * @file include/winproc.h
- * @brief Definitions for MS Windows
* @author Nils Durner
+ *
+ * @file
+ * Definitions for MS Windows
*/
#ifndef _WINPROC_H
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [GNUnet-SVN] r36809 - in gnunet: doc src/include,
gnunet <=