projects
/
mono.git
/ commitdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
| commitdiff |
tree
raw
|
patch
|
inline
| side by side (parent:
60c26e4
)
[docs] Update formatting in mono-api-jitinternal.
author
Jon Purdy
<evincarofautumn@gmail.com>
Thu, 9 Mar 2017 21:45:59 +0000
(13:45 -0800)
committer
Jon Purdy
<evincarofautumn@gmail.com>
Fri, 24 Mar 2017 20:43:07 +0000
(13:43 -0700)
docs/sources/mono-api-jitinternal.html
patch
|
blob
|
history
mono/metadata/mempool.c
patch
|
blob
|
history
mono/metadata/mono-hash.c
patch
|
blob
|
history
mono/metadata/object.c
patch
|
blob
|
history
mono/metadata/profiler.c
patch
|
blob
|
history
mono/profiler/mono-profiler-aot.c
patch
|
blob
|
history
mono/utils/mono-math.c
patch
|
blob
|
history
mono/utils/mono-md5.c
patch
|
blob
|
history
mono/utils/mono-sha1.c
patch
|
blob
|
history
mono/utils/monobitset.c
patch
|
blob
|
history
diff --git
a/docs/sources/mono-api-jitinternal.html
b/docs/sources/mono-api-jitinternal.html
index 1feff043f65acf732fdce5c649592d25fb2b01bc..bf6650e0b43b071de2241d0fbc3cbd1d15e9e377 100644
(file)
--- a/
docs/sources/mono-api-jitinternal.html
+++ b/
docs/sources/mono-api-jitinternal.html
@@
-147,6
+147,4
@@
<h4><a name="api:mono_profiler_startup">mono_profiler_startup</a></h4>
<h4><a name="api:mono_profiler_gc_event">mono_profiler_gc_event</a></h4>
<h4><a name="api:mono_profiler_gc_heap_resize">mono_profiler_gc_heap_resize</a></h4>
<h4><a name="api:mono_profiler_startup">mono_profiler_startup</a></h4>
<h4><a name="api:mono_profiler_gc_event">mono_profiler_gc_event</a></h4>
<h4><a name="api:mono_profiler_gc_heap_resize">mono_profiler_gc_heap_resize</a></h4>
-<h4><a name="api:mono_profiler_gc_event">mono_profiler_gc_event</a></h4>
-<h4><a name="api:mono_profiler_gc_heap_resize">mono_profiler_gc_heap_resize</a></h4>
<h4><a name="api:mono_profiler_stat_hit">mono_profiler_stat_hit</a></h4>
<h4><a name="api:mono_profiler_stat_hit">mono_profiler_stat_hit</a></h4>
diff --git
a/mono/metadata/mempool.c
b/mono/metadata/mempool.c
index 36f8079d3db4724d8db34fbf938b9fea5c2e9a91..e6fe9b25d0ad188eb61a7be7be1dcac149ee548b 100644
(file)
--- a/
mono/metadata/mempool.c
+++ b/
mono/metadata/mempool.c
@@
-160,7
+160,7
@@
mono_mempool_invalidate (MonoMemPool *pool)
/**
* mono_mempool_stats:
/**
* mono_mempool_stats:
- * \param pool the m
o
mory pool we need stats for
+ * \param pool the m
e
mory pool we need stats for
*
* Print a few stats about the mempool:
* - Total memory allocated (malloced) by mem pool
*
* Print a few stats about the mempool:
* - Total memory allocated (malloced) by mem pool
@@
-314,7
+314,7
@@
mono_mempool_alloc (MonoMemPool *pool, guint size)
/**
* mono_mempool_alloc0:
*
/**
* mono_mempool_alloc0:
*
- * same as mono_mempool_alloc, but fills memory with zero.
+ * same as
\c
mono_mempool_alloc, but fills memory with zero.
*/
gpointer
mono_mempool_alloc0 (MonoMemPool *pool, guint size)
*/
gpointer
mono_mempool_alloc0 (MonoMemPool *pool, guint size)
@@
-343,7
+343,7
@@
mono_mempool_alloc0 (MonoMemPool *pool, guint size)
/**
* mono_mempool_contains_addr:
*
/**
* mono_mempool_contains_addr:
*
- *
Determines whenever ADDR
is inside the memory used by the mempool.
+ *
Determines whether \p addr
is inside the memory used by the mempool.
*/
gboolean
mono_mempool_contains_addr (MonoMemPool *pool,
*/
gboolean
mono_mempool_contains_addr (MonoMemPool *pool,
diff --git
a/mono/metadata/mono-hash.c
b/mono/metadata/mono-hash.c
index 25efb00586a0b620be57f7f555682b204967dfba..1b558370d02c12c4bfc3ce7d7394a0ffff774f8d 100644
(file)
--- a/
mono/metadata/mono-hash.c
+++ b/
mono/metadata/mono-hash.c
@@
-257,6
+257,9
@@
rehash (MonoGHashTable *hash)
mg_free (old_values);
}
mg_free (old_values);
}
+/**
+ * mono_g_hash_table_size:
+ */
guint
mono_g_hash_table_size (MonoGHashTable *hash)
{
guint
mono_g_hash_table_size (MonoGHashTable *hash)
{
@@
-265,6
+268,9
@@
mono_g_hash_table_size (MonoGHashTable *hash)
return hash->in_use;
}
return hash->in_use;
}
+/**
+ * mono_g_hash_table_lookup:
+ */
gpointer
mono_g_hash_table_lookup (MonoGHashTable *hash, gconstpointer key)
{
gpointer
mono_g_hash_table_lookup (MonoGHashTable *hash, gconstpointer key)
{
@@
-276,6
+282,9
@@
mono_g_hash_table_lookup (MonoGHashTable *hash, gconstpointer key)
return NULL;
}
return NULL;
}
+/**
+ * mono_g_hash_table_lookup_extended:
+ */
gboolean
mono_g_hash_table_lookup_extended (MonoGHashTable *hash, gconstpointer key, gpointer *orig_key, gpointer *value)
{
gboolean
mono_g_hash_table_lookup_extended (MonoGHashTable *hash, gconstpointer key, gpointer *orig_key, gpointer *value)
{
@@
-294,6
+303,9
@@
mono_g_hash_table_lookup_extended (MonoGHashTable *hash, gconstpointer key, gpoi
return FALSE;
}
return FALSE;
}
+/**
+ * mono_g_hash_table_foreach:
+ */
void
mono_g_hash_table_foreach (MonoGHashTable *hash, GHFunc func, gpointer user_data)
{
void
mono_g_hash_table_foreach (MonoGHashTable *hash, GHFunc func, gpointer user_data)
{
@@
-323,6
+335,9
@@
mono_g_hash_table_find (MonoGHashTable *hash, GHRFunc predicate, gpointer user_d
return NULL;
}
return NULL;
}
+/**
+ * mono_g_hash_table_remove:
+ */
gboolean
mono_g_hash_table_remove (MonoGHashTable *hash, gconstpointer key)
{
gboolean
mono_g_hash_table_remove (MonoGHashTable *hash, gconstpointer key)
{
@@
-375,6
+390,9
@@
mono_g_hash_table_remove (MonoGHashTable *hash, gconstpointer key)
return TRUE;
}
return TRUE;
}
+/**
+ * mono_g_hash_table_foreach_remove:
+ */
guint
mono_g_hash_table_foreach_remove (MonoGHashTable *hash, GHRFunc func, gpointer user_data)
{
guint
mono_g_hash_table_foreach_remove (MonoGHashTable *hash, GHRFunc func, gpointer user_data)
{
@@
-397,6
+415,9
@@
mono_g_hash_table_foreach_remove (MonoGHashTable *hash, GHRFunc func, gpointer u
return count;
}
return count;
}
+/**
+ * mono_g_hash_table_destroy:
+ */
void
mono_g_hash_table_destroy (MonoGHashTable *hash)
{
void
mono_g_hash_table_destroy (MonoGHashTable *hash)
{
@@
-455,12
+476,18
@@
mono_g_hash_table_insert_replace (MonoGHashTable *hash, gpointer key, gpointer v
}
}
}
}
+/**
+ * mono_g_hash_table_insert:
+ */
void
mono_g_hash_table_insert (MonoGHashTable *h, gpointer k, gpointer v)
{
mono_g_hash_table_insert_replace (h, k, v, FALSE);
}
void
mono_g_hash_table_insert (MonoGHashTable *h, gpointer k, gpointer v)
{
mono_g_hash_table_insert_replace (h, k, v, FALSE);
}
+/**
+ * mono_g_hash_table_replace:
+ */
void
mono_g_hash_table_replace(MonoGHashTable *h, gpointer k, gpointer v)
{
void
mono_g_hash_table_replace(MonoGHashTable *h, gpointer k, gpointer v)
{
diff --git
a/mono/metadata/object.c
b/mono/metadata/object.c
index e86f743c29fdd9703bf5268e9691c63b71c6249d..ebc0efed6d6ab16b64ea2f82f1ef63127440f52f 100644
(file)
--- a/
mono/metadata/object.c
+++ b/
mono/metadata/object.c
@@
-8231,10
+8231,10
@@
mono_store_remote_field_new_checked (MonoObject *this_obj, MonoClass *klass, Mon
}
#endif
}
#endif
-/*
+/*
*
* mono_create_ftnptr:
*
* mono_create_ftnptr:
*
- *
Given a function address, create a function descriptor for it.
+ * Given a function address, create a function descriptor for it.
* This is only needed on some platforms.
*/
gpointer
* This is only needed on some platforms.
*/
gpointer
diff --git
a/mono/metadata/profiler.c
b/mono/metadata/profiler.c
index c8d3ff845cf2ded846da1ee5f77eea85ff946ba1..3d1d8ebbd175628c4899a1c02d6febd10c2efdae 100644
(file)
--- a/
mono/metadata/profiler.c
+++ b/
mono/metadata/profiler.c
@@
-443,6
+443,9
@@
mono_profiler_install_class (MonoProfileClassFunc start_load, MonoProfileC
prof_list->class_end_unload = end_unload;
}
prof_list->class_end_unload = end_unload;
}
+/**
+ * mono_profiler_method_enter:
+ */
void
mono_profiler_method_enter (MonoMethod *method)
{
void
mono_profiler_method_enter (MonoMethod *method)
{
@@
-453,6
+456,9
@@
mono_profiler_method_enter (MonoMethod *method)
}
}
}
}
+/**
+ * mono_profiler_method_leave:
+ */
void
mono_profiler_method_leave (MonoMethod *method)
{
void
mono_profiler_method_leave (MonoMethod *method)
{
@@
-463,6
+469,9
@@
mono_profiler_method_leave (MonoMethod *method)
}
}
}
}
+/**
+ * mono_profiler_method_jit:
+ */
void
mono_profiler_method_jit (MonoMethod *method)
{
void
mono_profiler_method_jit (MonoMethod *method)
{
@@
-473,6
+482,9
@@
mono_profiler_method_jit (MonoMethod *method)
}
}
}
}
+/**
+ * mono_profiler_method_end_jit:
+ */
void
mono_profiler_method_end_jit (MonoMethod *method, MonoJitInfo* jinfo, int result)
{
void
mono_profiler_method_end_jit (MonoMethod *method, MonoJitInfo* jinfo, int result)
{
@@
-517,6
+529,9
@@
mono_profiler_method_end_invoke (MonoMethod *method)
}
}
}
}
+/**
+ * mono_profiler_code_transition:
+ */
void
mono_profiler_code_transition (MonoMethod *method, int result)
{
void
mono_profiler_code_transition (MonoMethod *method, int result)
{
@@
-527,6
+542,9
@@
mono_profiler_code_transition (MonoMethod *method, int result)
}
}
}
}
+/**
+ * mono_profiler_allocation:
+ */
void
mono_profiler_allocation (MonoObject *obj)
{
void
mono_profiler_allocation (MonoObject *obj)
{
@@
-546,6
+564,9
@@
mono_profiler_monitor_event (MonoObject *obj, MonoProfilerMonitorEvent even
}
}
}
}
+/**
+ * mono_profiler_stat_hit:
+ */
void
mono_profiler_stat_hit (guchar *ip, void *context)
{
void
mono_profiler_stat_hit (guchar *ip, void *context)
{
@@
-596,6
+617,9
@@
mono_profiler_exception_clause_handler (MonoMethod *method, int clause_type, int
}
}
}
}
+/**
+ * mono_profiler_thread_start:
+ */
void
mono_profiler_thread_start (gsize tid)
{
void
mono_profiler_thread_start (gsize tid)
{
@@
-606,6
+630,9
@@
mono_profiler_thread_start (gsize tid)
}
}
}
}
+/**
+ * mono_profiler_thread_end:
+ */
void
mono_profiler_thread_end (gsize tid)
{
void
mono_profiler_thread_end (gsize tid)
{
@@
-626,6
+653,9
@@
mono_profiler_thread_name (gsize tid, const char *name)
}
}
}
}
+/**
+ * mono_profiler_assembly_event:
+ */
void
mono_profiler_assembly_event (MonoAssembly *assembly, int code)
{
void
mono_profiler_assembly_event (MonoAssembly *assembly, int code)
{
@@
-653,6
+683,9
@@
mono_profiler_assembly_event (MonoAssembly *assembly, int code)
}
}
}
}
+/**
+ * mono_profiler_assembly_loaded:
+ */
void
mono_profiler_assembly_loaded (MonoAssembly *assembly, int result)
{
void
mono_profiler_assembly_loaded (MonoAssembly *assembly, int result)
{
@@
-672,6
+705,9
@@
void mono_profiler_iomap (char *report, const char *pathname, const char *new_pa
}
}
}
}
+/**
+ * mono_profiler_module_event:
+ */
void
mono_profiler_module_event (MonoImage *module, int code)
{
void
mono_profiler_module_event (MonoImage *module, int code)
{
@@
-699,6
+735,9
@@
mono_profiler_module_event (MonoImage *module, int code)
}
}
}
}
+/**
+ * mono_profiler_module_loaded:
+ */
void
mono_profiler_module_loaded (MonoImage *module, int result)
{
void
mono_profiler_module_loaded (MonoImage *module, int result)
{
@@
-709,6
+748,9
@@
mono_profiler_module_loaded (MonoImage *module, int result)
}
}
}
}
+/**
+ * mono_profiler_class_event:
+ */
void
mono_profiler_class_event (MonoClass *klass, int code)
{
void
mono_profiler_class_event (MonoClass *klass, int code)
{
@@
-736,6
+778,9
@@
mono_profiler_class_event (MonoClass *klass, int code)
}
}
}
}
+/**
+ * mono_profiler_class_loaded:
+ */
void
mono_profiler_class_loaded (MonoClass *klass, int result)
{
void
mono_profiler_class_loaded (MonoClass *klass, int result)
{
@@
-746,6
+791,9
@@
mono_profiler_class_loaded (MonoClass *klass, int result)
}
}
}
}
+/**
+ * mono_profiler_appdomain_event:
+ */
void
mono_profiler_appdomain_event (MonoDomain *domain, int code)
{
void
mono_profiler_appdomain_event (MonoDomain *domain, int code)
{
@@
-773,6
+821,9
@@
mono_profiler_appdomain_event (MonoDomain *domain, int code)
}
}
}
}
+/**
+ * mono_profiler_appdomain_loaded:
+ */
void
mono_profiler_appdomain_loaded (MonoDomain *domain, int result)
{
void
mono_profiler_appdomain_loaded (MonoDomain *domain, int result)
{
@@
-807,6
+858,9
@@
mono_profiler_context_unloaded (MonoAppContext *context)
prof->context_unload (prof->profiler, context);
}
prof->context_unload (prof->profiler, context);
}
+/**
+ * mono_profiler_shutdown:
+ */
void
mono_profiler_shutdown (void)
{
void
mono_profiler_shutdown (void)
{
@@
-819,6
+873,9
@@
mono_profiler_shutdown (void)
mono_profiler_set_events ((MonoProfileFlags)0);
}
mono_profiler_set_events ((MonoProfileFlags)0);
}
+/**
+ * mono_profiler_gc_heap_resize:
+ */
void
mono_profiler_gc_heap_resize (gint64 new_size)
{
void
mono_profiler_gc_heap_resize (gint64 new_size)
{
@@
-829,6
+886,9
@@
mono_profiler_gc_heap_resize (gint64 new_size)
}
}
}
}
+/**
+ * mono_profiler_gc_event:
+ */
void
mono_profiler_gc_event (MonoGCEvent event, int generation)
{
void
mono_profiler_gc_event (MonoGCEvent event, int generation)
{
diff --git
a/mono/profiler/mono-profiler-aot.c
b/mono/profiler/mono-profiler-aot.c
index 59f8aeea2a0a838e89d3cf8ca5422d65db89c60c..384e624b64ea447806f8fc054b44443bbe2a6b43 100644
(file)
--- a/
mono/profiler/mono-profiler-aot.c
+++ b/
mono/profiler/mono-profiler-aot.c
@@
-119,7
+119,10
@@
match_option (const char* p, const char *opt, char **rval)
void
mono_profiler_startup (const char *desc);
void
mono_profiler_startup (const char *desc);
-/* the entry point */
+/**
+ * mono_profiler_startup:
+ * the entry point
+ */
void
mono_profiler_startup (const char *desc)
{
void
mono_profiler_startup (const char *desc)
{
diff --git
a/mono/utils/mono-math.c
b/mono/utils/mono-math.c
index 20a3432ca6ebb1c7d2ca6746dd41bcdac74e4af0..7672b0cca9b2bd0daeee62160a8425a33fed6c78 100644
(file)
--- a/
mono/utils/mono-math.c
+++ b/
mono/utils/mono-math.c
@@
-6,6
+6,9
@@
#ifndef HAVE_SIGNBIT
#ifndef HAVE_SIGNBIT
+/**
+ * mono_signbit_float:
+ */
int
mono_signbit_float (float x)
{
int
mono_signbit_float (float x)
{
@@
-16,6
+19,9
@@
mono_signbit_float (float x)
return u.i < 0;
}
return u.i < 0;
}
+/**
+ * mono_signbit_double:
+ */
int
mono_signbit_double (double x)
{
int
mono_signbit_double (double x)
{
diff --git
a/mono/utils/mono-md5.c
b/mono/utils/mono-md5.c
index 64d6b903f477791c105e2b88c98f0a7f2434d941..e353c84256aa0fff865ed77ba9b94510c531e45a 100644
(file)
--- a/
mono/utils/mono-md5.c
+++ b/
mono/utils/mono-md5.c
@@
-30,18
+30,27
@@
#if HAVE_COMMONCRYPTO_COMMONDIGEST_H
#if HAVE_COMMONCRYPTO_COMMONDIGEST_H
+/**
+ * mono_md5_init:
+ */
void
mono_md5_init (MonoMD5Context *ctx)
{
CC_MD5_Init (ctx);
}
void
mono_md5_init (MonoMD5Context *ctx)
{
CC_MD5_Init (ctx);
}
+/**
+ * mono_md5_update:
+ */
void
mono_md5_update (MonoMD5Context *ctx, const guchar *buf, guint32 len)
{
CC_MD5_Update (ctx, buf, len);
}
void
mono_md5_update (MonoMD5Context *ctx, const guchar *buf, guint32 len)
{
CC_MD5_Update (ctx, buf, len);
}
+/**
+ * mono_md5_final:
+ */
void
mono_md5_final (MonoMD5Context *ctx, guchar digest[16])
{
void
mono_md5_final (MonoMD5Context *ctx, guchar digest[16])
{
@@
-322,14
+331,14
@@
md5_transform (guint32 buf[4], const guint32 in[16])
/**
/**
- * mono_md5_get_digest:
get the md5 hash of a buffer
- *
@buffer:
byte buffer
- *
@buffer_size:
buffer size (in bytes)
- *
@digest: 16 bytes
buffer receiving the hash code.
+ * mono_md5_get_digest:
+ *
\param buffer
byte buffer
+ *
\param buffer_size
buffer size (in bytes)
+ *
\param digest 16-byte
buffer receiving the hash code.
*
*
- * Get the
md
5 hash of a buffer. The result is put in
- * the 16
bytes buffer @digest
.
- *
*
/
+ * Get the
MD
5 hash of a buffer. The result is put in
+ * the 16
-byte buffer \p digest
.
+ */
void
mono_md5_get_digest (const guchar *buffer, gint buffer_size, guchar digest[16])
{
void
mono_md5_get_digest (const guchar *buffer, gint buffer_size, guchar digest[16])
{
@@
-343,15
+352,15
@@
mono_md5_get_digest (const guchar *buffer, gint buffer_size, guchar digest[16])
/**
/**
- * mono_md5_get_digest_from_file:
get the md5 hash of a file
- *
@filename:
file name
- *
@digest: 16 bytes
buffer receiving the hash code.
+ * mono_md5_get_digest_from_file:
+ *
\param filename
file name
+ *
\param digest 16-byte
buffer receiving the hash code.
*
*
- * Get the
md
5 hash of a file. The result is put in
- * the 16
bytes buffer @digest
.
+ * Get the
MD
5 hash of a file. The result is put in
+ * the 16
-byte buffer \p digest
.
*
*
- * If an IO error happens the value in
@
digest is not updated.
- *
*
/
+ * If an IO error happens the value in
\p
digest is not updated.
+ */
void
mono_md5_get_digest_from_file (const gchar *filename, guchar digest[16])
{
void
mono_md5_get_digest_from_file (const gchar *filename, guchar digest[16])
{
diff --git
a/mono/utils/mono-sha1.c
b/mono/utils/mono-sha1.c
index 9780090541d831661d9a778b663d9b4effc251ff..4a6415f3fde705cff9e03433c353ad5fc06dfe05 100644
(file)
--- a/
mono/utils/mono-sha1.c
+++ b/
mono/utils/mono-sha1.c
@@
-78,18
+78,27
@@
A million repetitions of "a"
#if HAVE_COMMONCRYPTO_COMMONDIGEST_H
#if HAVE_COMMONCRYPTO_COMMONDIGEST_H
+/**
+ * mono_sha1_init:
+ */
void
mono_sha1_init (MonoSHA1Context* context)
{
CC_SHA1_Init (context);
}
void
mono_sha1_init (MonoSHA1Context* context)
{
CC_SHA1_Init (context);
}
+/**
+ * mono_sha1_update:
+ */
void
mono_sha1_update (MonoSHA1Context* context, const guchar* data, guint32 len)
{
CC_SHA1_Update (context, data, len);
}
void
mono_sha1_update (MonoSHA1Context* context, const guchar* data, guint32 len)
{
CC_SHA1_Update (context, data, len);
}
+/**
+ * mono_sha1_final:
+ */
void
mono_sha1_final (MonoSHA1Context* context, unsigned char digest[20])
{
void
mono_sha1_final (MonoSHA1Context* context, unsigned char digest[20])
{
@@
-268,7
+277,10
@@
unsigned char finalcount[8];
}
#endif
}
#endif
-
+
+/**
+ * mono_sha1_get_digest:
+ */
void
mono_sha1_get_digest (const guchar *buffer, gint buffer_size, guchar digest [20])
{
void
mono_sha1_get_digest (const guchar *buffer, gint buffer_size, guchar digest [20])
{
@@
-281,15
+293,15
@@
mono_sha1_get_digest (const guchar *buffer, gint buffer_size, guchar digest [20]
}
/**
}
/**
- * mono_sha1_get_digest_from_file:
get the sha1 hash of a file
- *
@filename:
file name
- *
@digest: 20 bytes
buffer receiving the hash code.
+ * mono_sha1_get_digest_from_file:
+ *
\param filename
file name
+ *
\param digest 20-byte
buffer receiving the hash code.
*
*
- * Get the
sha
1 hash of a file. The result is put in
- * the 20
bytes buffer @digest
.
+ * Get the
SHA-
1 hash of a file. The result is put in
+ * the 20
-byte buffer \p digest
.
*
*
- * If an IO error happens the value in
@
digest is not updated.
- *
*
/
+ * If an IO error happens the value in
\p
digest is not updated.
+ */
void
mono_sha1_get_digest_from_file (const gchar *filename, guchar digest [20])
{
void
mono_sha1_get_digest_from_file (const gchar *filename, guchar digest [20])
{
@@
-317,11
+329,11
@@
mono_sha1_get_digest_from_file (const gchar *filename, guchar digest [20])
mono_sha1_final (&ctx, digest);
}
mono_sha1_final (&ctx, digest);
}
-/*
+/*
*
* mono_digest_get_public_token:
*
* Get the public token from public key data.
* mono_digest_get_public_token:
*
* Get the public token from public key data.
- *
@
token must point to at least 8 bytes of storage.
+ *
\p
token must point to at least 8 bytes of storage.
*/
void
mono_digest_get_public_token (guchar* token, const guchar *pubkey, guint32 len)
*/
void
mono_digest_get_public_token (guchar* token, const guchar *pubkey, guint32 len)
diff --git
a/mono/utils/monobitset.c
b/mono/utils/monobitset.c
index 4111a9ee4e914bcc70a043d57d70b335bd626032..987689a9cd8e946671fd35f5ae4d42c39cc61a30 100644
(file)
--- a/
mono/utils/monobitset.c
+++ b/
mono/utils/monobitset.c
@@
-10,14
+10,13
@@
#define BITS_PER_CHUNK MONO_BITSET_BITS_PER_CHUNK
#define BITS_PER_CHUNK MONO_BITSET_BITS_PER_CHUNK
-/*
+/*
*
* mono_bitset_alloc_size:
* mono_bitset_alloc_size:
- * @max_size: The number of bits you want to hold
- * @flags: unused
- *
- * Return the number of bytes required to hold the bitset.
+ * \param max_size The number of bits you want to hold
+ * \param flags unused
+ * \returns the number of bytes required to hold the bitset.
* Useful to allocate it on the stack or with mempool.
* Useful to allocate it on the stack or with mempool.
- * Use with
mono_bitset_mem_new ()
.
+ * Use with
\c mono_bitset_mem_new
.
*/
guint32
mono_bitset_alloc_size (guint32 max_size, guint32 flags) {
*/
guint32
mono_bitset_alloc_size (guint32 max_size, guint32 flags) {
@@
-26,13
+25,12
@@
mono_bitset_alloc_size (guint32 max_size, guint32 flags) {
return sizeof (MonoBitSet) + sizeof (gsize) * (real_size - MONO_ZERO_LEN_ARRAY);
}
return sizeof (MonoBitSet) + sizeof (gsize) * (real_size - MONO_ZERO_LEN_ARRAY);
}
-/*
+/*
*
* mono_bitset_new:
* mono_bitset_new:
- * @max_size: The numer of bits you want to hold
- * @flags: bitfield of flags
- *
- * Return a bitset of size max_size. It must be freed using
- * mono_bitset_free.
+ * \param max_size The numer of bits you want to hold
+ * \param flags bitfield of flags
+ * \returns a bitset of size \p max_size. It must be freed using
+ * \c mono_bitset_free.
*/
MonoBitSet *
mono_bitset_new (guint32 max_size, guint32 flags) {
*/
MonoBitSet *
mono_bitset_new (guint32 max_size, guint32 flags) {
@@
-45,15
+43,15
@@
mono_bitset_new (guint32 max_size, guint32 flags) {
return result;
}
return result;
}
-/*
+/*
*
* mono_bitset_mem_new:
* mono_bitset_mem_new:
- *
@mem:
The location the bitset is stored
- *
@max_size:
The number of bits you want to hold
- *
@flags:
bitfield of flags
+ *
\param mem
The location the bitset is stored
+ *
\param max_size
The number of bits you want to hold
+ *
\param flags
bitfield of flags
*
*
- * Return
mem, which is now a initialized bitset of size
max_size. It is
- * not freed even if called with
mono_bitset_free.
mem must be at least
- * as big as
mono_bitset_alloc_size returns for the same
max_size.
+ * Return
\p mem, which is now a initialized bitset of size \p
max_size. It is
+ * not freed even if called with
\c mono_bitset_free. \p
mem must be at least
+ * as big as
\c mono_bitset_alloc_size returns for the same \p
max_size.
*/
MonoBitSet *
mono_bitset_mem_new (gpointer mem, guint32 max_size, guint32 flags) {
*/
MonoBitSet *
mono_bitset_mem_new (gpointer mem, guint32 max_size, guint32 flags) {
@@
-67,11
+65,11
@@
mono_bitset_mem_new (gpointer mem, guint32 max_size, guint32 flags) {
/*
* mono_bitset_free:
/*
* mono_bitset_free:
- *
@set:
bitset ptr to free
+ *
\param set
bitset ptr to free
*
*
- * Free bitset unless flags have MONO_BITSET_DONT_FREE set. Does not
- * free anything if flag MONO_BITSET_DONT_FREE is set or bitset was
- * made with mono_bitset_mem_new.
+ * Free bitset unless flags have
\c
MONO_BITSET_DONT_FREE set. Does not
+ * free anything if flag
\c
MONO_BITSET_DONT_FREE is set or bitset was
+ * made with
\c
mono_bitset_mem_new.
*/
void
mono_bitset_free (MonoBitSet *set) {
*/
void
mono_bitset_free (MonoBitSet *set) {
@@
-79,12
+77,12
@@
mono_bitset_free (MonoBitSet *set) {
g_free (set);
}
g_free (set);
}
-/*
+/*
*
* mono_bitset_set:
* mono_bitset_set:
- *
@set:
bitset ptr
- *
@pos:
set bit at this pos
+ *
\param set
bitset ptr
+ *
\param pos
set bit at this pos
*
*
- * Set bit at
pos @
pos, counting from 0.
+ * Set bit at
\p
pos, counting from 0.
*/
void
mono_bitset_set (MonoBitSet *set, guint32 pos) {
*/
void
mono_bitset_set (MonoBitSet *set, guint32 pos) {
@@
-96,13
+94,12
@@
mono_bitset_set (MonoBitSet *set, guint32 pos) {
set->data [j] |= (gsize)1 << bit;
}
set->data [j] |= (gsize)1 << bit;
}
-/*
+/*
*
* mono_bitset_test:
* mono_bitset_test:
- * @set: bitset ptr
- * @pos: test bit at this pos
- *
- * Test bit at pos @pos, counting from 0.
- * Returns a value != 0 if set, 0 otherwise.
+ * \param set bitset ptr
+ * \param pos test bit at this pos
+ * Test bit at \p pos, counting from 0.
+ * \returns a nonzero value if set, 0 otherwise.
*/
int
mono_bitset_test (const MonoBitSet *set, guint32 pos) {
*/
int
mono_bitset_test (const MonoBitSet *set, guint32 pos) {
@@
-114,12
+111,11
@@
mono_bitset_test (const MonoBitSet *set, guint32 pos) {
return (set->data [j] & ((gsize)1 << bit)) > 0;
}
return (set->data [j] & ((gsize)1 << bit)) > 0;
}
-/*
+/*
*
* mono_bitset_test_bulk:
* mono_bitset_test_bulk:
- * @set: bitset ptr
- * @pos: test bit at this pos
- *
- * Return 32/64 bits from the bitset, starting from @pos, which must be
+ * \param set bitset ptr
+ * \param pos test bit at this pos
+ * \returns 32/64 bits from the bitset, starting from \p pos, which must be
* divisible with 32/64.
*/
gsize
* divisible with 32/64.
*/
gsize
@@
-132,12
+128,12
@@
mono_bitset_test_bulk (const MonoBitSet *set, guint32 pos) {
return set->data [j];
}
return set->data [j];
}
-/*
+/*
*
* mono_bitset_clear:
* mono_bitset_clear:
- *
@set:
bitset ptr
- *
@pos:
unset bit at this pos
+ *
\param set
bitset ptr
+ *
\param pos
unset bit at this pos
*
*
- * Unset bit at
pos 'pos'
, counting from 0.
+ * Unset bit at
\p pos
, counting from 0.
*/
void
mono_bitset_clear (MonoBitSet *set, guint32 pos) {
*/
void
mono_bitset_clear (MonoBitSet *set, guint32 pos) {
@@
-149,9
+145,9
@@
mono_bitset_clear (MonoBitSet *set, guint32 pos) {
set->data [j] &= ~((gsize)1 << bit);
}
set->data [j] &= ~((gsize)1 << bit);
}
-/*
+/*
*
* mono_bitset_clear_all:
* mono_bitset_clear_all:
- *
@set:
bitset ptr
+ *
\param set
bitset ptr
*
* Unset all bits.
*/
*
* Unset all bits.
*/
@@
-160,9
+156,9
@@
mono_bitset_clear_all (MonoBitSet *set) {
memset (set->data, 0, set->size / 8);
}
memset (set->data, 0, set->size / 8);
}
-/*
+/*
*
* mono_bitset_set_all:
* mono_bitset_set_all:
- *
@set:
bitset ptr
+ *
\param set
bitset ptr
*
* Set all bits.
*/
*
* Set all bits.
*/
@@
-171,9
+167,9
@@
mono_bitset_set_all (MonoBitSet *set) {
memset (set->data, -1, set->size / 8);
}
memset (set->data, -1, set->size / 8);
}
-/*
+/*
*
* mono_bitset_invert:
* mono_bitset_invert:
- *
@set:
bitset ptr
+ *
\param set
bitset ptr
*
* Flip all bits.
*/
*
* Flip all bits.
*/
@@
-184,11
+180,10
@@
mono_bitset_invert (MonoBitSet *set) {
set->data [i] = ~set->data [i];
}
set->data [i] = ~set->data [i];
}
-/*
+/*
*
* mono_bitset_size:
* mono_bitset_size:
- * @set: bitset ptr
- *
- * Returns the number of bits this bitset can hold.
+ * \param set bitset ptr
+ * \returns the number of bits this bitset can hold.
*/
guint32
mono_bitset_size (const MonoBitSet *set) {
*/
guint32
mono_bitset_size (const MonoBitSet *set) {
@@
-200,11
+195,10
@@
mono_bitset_size (const MonoBitSet *set) {
*/
#if 1
*/
#if 1
-/*
+/*
*
* mono_bitset_count:
* mono_bitset_count:
- * @set: bitset ptr
- *
- * return number of bits that is set.
+ * \param set bitset ptr
+ * \returns number of bits that are set.
*/
guint32
mono_bitset_count (const MonoBitSet *set) {
*/
guint32
mono_bitset_count (const MonoBitSet *set) {
@@
-387,11
+381,10
@@
find_first_unset (gsize mask, gint nth_bit)
return -1;
}
return -1;
}
-/*
+/*
*
* mono_bitset_find_start:
* mono_bitset_find_start:
- * @set: bitset ptr
- *
- * Equivalent to mono_bitset_find_first (set, -1) but faster.
+ * \param set bitset ptr
+ * Equivalent to <code>mono_bitset_find_first (set, -1)</code> but faster.
*/
int
mono_bitset_find_start (const MonoBitSet *set)
*/
int
mono_bitset_find_start (const MonoBitSet *set)
@@
-405,13
+398,12
@@
mono_bitset_find_start (const MonoBitSet *set)
return -1;
}
return -1;
}
-/*
+/*
*
* mono_bitset_find_first:
* mono_bitset_find_first:
- * @set: bitset ptr
- * @pos: pos to search _after_ (not including)
- *
- * Returns position of first set bit after @pos. If pos < 0 begin search from
- * start. Return -1 if no bit set is found.
+ * \param set bitset ptr
+ * \param pos pos to search after (not including)
+ * \returns position of first set bit after \p pos. If \p pos < 0, begin search from
+ * start. Return \c -1 if no bit set is found.
*/
int
mono_bitset_find_first (const MonoBitSet *set, gint pos) {
*/
int
mono_bitset_find_first (const MonoBitSet *set, gint pos) {
@@
-441,13
+433,12
@@
mono_bitset_find_first (const MonoBitSet *set, gint pos) {
return -1;
}
return -1;
}
-/*
+/*
*
* mono_bitset_find_last:
* mono_bitset_find_last:
- * @set: bitset ptr
- * @pos: pos to search _before_ (not including)
- *
- * Returns position of last set bit before pos. If pos < 0 search is
- * started from the end. Returns -1 if no set bit is found.
+ * \param set bitset ptr
+ * \param pos pos to search before (not including)
+ * \returns position of last set bit before \p pos. If \p pos < 0 search is
+ * started from the end. Returns \c -1 if no set bit is found.
*/
int
mono_bitset_find_last (const MonoBitSet *set, gint pos) {
*/
int
mono_bitset_find_last (const MonoBitSet *set, gint pos) {
@@
-473,13
+464,12
@@
mono_bitset_find_last (const MonoBitSet *set, gint pos) {
return -1;
}
return -1;
}
-/*
+/*
*
* mono_bitset_find_first_unset:
* mono_bitset_find_first_unset:
- * @set: bitset ptr
- * @pos: pos to search _after_ (not including)
- *
- * Returns position of first unset bit after @pos. If pos < 0 begin search from
- * start. Return -1 if no bit set is found.
+ * \param set bitset ptr
+ * \param pos pos to search after (not including)
+ * \returns position of first unset bit after \p pos. If \p pos < 0 begin search from
+ * start. Return \c -1 if no bit set is found.
*/
int
mono_bitset_find_first_unset (const MonoBitSet *set, gint pos) {
*/
int
mono_bitset_find_first_unset (const MonoBitSet *set, gint pos) {
@@
-510,13
+500,12
@@
mono_bitset_find_first_unset (const MonoBitSet *set, gint pos) {
return -1;
}
return -1;
}
-/*
+/*
*
* mono_bitset_clone:
* mono_bitset_clone:
- * @set: bitset ptr to clone
- * @new_size: number of bits the cloned bitset can hold
- *
- * Return a cloned bitset of size new_size. MONO_BITSET_DONT_FREE
- * unset in cloned bitset. If new_size is 0, the cloned object is just
+ * \param set bitset ptr to clone
+ * \param new_size number of bits the cloned bitset can hold
+ * \returns a cloned bitset of size \p new_size. \c MONO_BITSET_DONT_FREE
+ * unset in cloned bitset. If \p new_size is 0, the cloned object is just
* as big.
*/
MonoBitSet*
* as big.
*/
MonoBitSet*
@@
-531,10
+520,10
@@
mono_bitset_clone (const MonoBitSet *set, guint32 new_size) {
return result;
}
return result;
}
-/*
+/*
*
* mono_bitset_copyto:
* mono_bitset_copyto:
- *
@src:
bitset ptr to copy from
- *
@dest:
bitset ptr to copy to
+ *
\param src
bitset ptr to copy from
+ *
\param dest
bitset ptr to copy to
*
* Copy one bitset to another.
*/
*
* Copy one bitset to another.
*/
@@
-545,10
+534,10
@@
mono_bitset_copyto (const MonoBitSet *src, MonoBitSet *dest) {
memcpy (&dest->data, &src->data, dest->size / 8);
}
memcpy (&dest->data, &src->data, dest->size / 8);
}
-/*
+/*
*
* mono_bitset_union:
* mono_bitset_union:
- *
@dest:
bitset ptr to hold union
- *
@src:
bitset ptr to copy
+ *
\param dest
bitset ptr to hold union
+ *
\param src
bitset ptr to copy
*
* Make union of one bitset and another.
*/
*
* Make union of one bitset and another.
*/
@@
-563,10
+552,10
@@
mono_bitset_union (MonoBitSet *dest, const MonoBitSet *src) {
dest->data [i] |= src->data [i];
}
dest->data [i] |= src->data [i];
}
-/*
+/*
*
* mono_bitset_intersection:
* mono_bitset_intersection:
- *
@dest:
bitset ptr to hold intersection
- *
@src:
bitset ptr to copy
+ *
\param dest
bitset ptr to hold intersection
+ *
\param src
bitset ptr to copy
*
* Make intersection of one bitset and another.
*/
*
* Make intersection of one bitset and another.
*/
@@
-581,11
+570,11
@@
mono_bitset_intersection (MonoBitSet *dest, const MonoBitSet *src) {
dest->data [i] &= src->data [i];
}
dest->data [i] &= src->data [i];
}
-/*
+/*
*
* mono_bitset_intersection_2:
* mono_bitset_intersection_2:
- *
@dest:
bitset ptr to hold intersection
- *
@src1:
first bitset
- *
@src2:
second bitset
+ *
\param dest
bitset ptr to hold intersection
+ *
\param src1
first bitset
+ *
\param src2
second bitset
*
* Make intersection of two bitsets
*/
*
* Make intersection of two bitsets
*/
@@
-601,12
+590,12
@@
mono_bitset_intersection_2 (MonoBitSet *dest, const MonoBitSet *src1, const Mono
dest->data [i] = src1->data [i] & src2->data [i];
}
dest->data [i] = src1->data [i] & src2->data [i];
}
-/*
+/*
*
* mono_bitset_sub:
* mono_bitset_sub:
- *
@dest:
bitset ptr to hold bitset - src
- *
@src:
bitset ptr to copy
+ *
\param dest
bitset ptr to hold bitset - src
+ *
\param src
bitset ptr to copy
*
*
- * Unset all bits in
dest, which are set in
src.
+ * Unset all bits in
\p dest that are set in \p
src.
*/
void
mono_bitset_sub (MonoBitSet *dest, const MonoBitSet *src) {
*/
void
mono_bitset_sub (MonoBitSet *dest, const MonoBitSet *src) {
@@
-619,12
+608,11
@@
mono_bitset_sub (MonoBitSet *dest, const MonoBitSet *src) {
dest->data [i] &= ~src->data [i];
}
dest->data [i] &= ~src->data [i];
}
-/*
+/*
*
* mono_bitset_equal:
* mono_bitset_equal:
- * @src: bitset ptr
- * @src1: bitset ptr
- *
- * return TRUE if their size are the same and the same bits are set in
+ * \param src bitset ptr
+ * \param src1 bitset ptr
+ * \returns TRUE if their size are the same and the same bits are set in
* both bitsets.
*/
gboolean
* both bitsets.
*/
gboolean
@@
-639,13
+627,12
@@
mono_bitset_equal (const MonoBitSet *src, const MonoBitSet *src1) {
return TRUE;
}
return TRUE;
}
-/*
+/*
*
* mono_bitset_foreach:
* mono_bitset_foreach:
- * @set: bitset ptr
- * @func: Function to call for every set bit
- * @data: pass this as second arg to func
- *
- * Calls func for every bit set in bitset. Argument 1 is the number of
+ * \param set bitset ptr
+ * \param func Function to call for every set bit
+ * \param data pass this as second arg to func
+ * Calls \p func for every bit set in bitset. Argument 1 is the number of
* the bit set, argument 2 is data
*/
void
* the bit set, argument 2 is data
*/
void