From d4d868a28076273e828f299e896dbc1af827208a Mon Sep 17 00:00:00 2001 From: Ralf Wildenhues Date: Thu, 3 Feb 2011 07:23:59 +0000 Subject: libiberty: documentation markup and order fixes. libiberty/: * splay-tree.c: Escape wrapping newlines in texinfo markup with '@', to fix function declaration output rendering. * gather-docs: Relax and improve macro name matching to actually match all current names and to allow input line wrapping. * bsearch.c, concat.c, crc32.c, fnmatch.txh, fopen_unlocked.c, hashtab.c, insque.c, make-relative-prefix.c, memchr.c, memcmp.c, memcpy.c, memmem.c, memmove.c, mempcpy.c, memset.c, pexecute.txh, random.c, setenv.c, setproctitle.c, simple-object.txh, snprintf.c, stpncpy.c, strncmp.c, strtod.c, strtol.c, vasprintf.c, vprintf.c, vsnprintf.c, xmemdup.c: Wrap long texinfo input lines. * functions.texi: Regenerate. --- libiberty/simple-object.txh | 45 +++++++++++++++++++++++++++++++++------------ 1 file changed, 33 insertions(+), 12 deletions(-) (limited to 'libiberty/simple-object.txh') diff --git a/libiberty/simple-object.txh b/libiberty/simple-object.txh index 907233a..34639f1 100644 --- a/libiberty/simple-object.txh +++ b/libiberty/simple-object.txh @@ -1,5 +1,7 @@ @c -*- mode: texinfo -*- -@deftypefn Extension {simple_object_read *} simple_object_open_read (int @var{descriptor}, off_t @var{offset}, const char *{segment_name}, const char **@var{errmsg}, int *@var{err}) +@deftypefn Extension {simple_object_read *} simple_object_open_read @ + (int @var{descriptor}, off_t @var{offset}, const char *{segment_name}, @ + const char **@var{errmsg}, int *@var{err}) Opens an object file for reading. Creates and returns an @code{simple_object_read} pointer which may be passed to other @@ -22,7 +24,10 @@ an errno value or @code{0} if there is no relevant errno. @end deftypefn -@deftypefn Extension {const char *} simple_object_find_sections (simple_object_read *@var{simple_object}, int (*@var{pfn}) (void *@var{data}, const char *@var{name}, off_t @var{offset}, off_t @var{length}), void *@var{data}, int *@var{err}) +@deftypefn Extension {const char *} simple_object_find_sections @ + (simple_object_read *@var{simple_object}, int (*@var{pfn}) (void *@var{data}, @ + const char *@var{name}, off_t @var{offset}, off_t @var{length}), @ + void *@var{data}, int *@var{err}) This function calls @var{pfn} for each section in @var{simple_object}. It calls @var{pfn} with the section name, the offset within the file @@ -41,7 +46,9 @@ or @code{0} if there is no relevant errno. @end deftypefn -@deftypefn Extension {int} simple_object_find_section (simple_object_read *@var{simple_object} off_t *@var{offset}, off_t *@var{length}, const char **@var{errmsg}, int *@var{err}) +@deftypefn Extension {int} simple_object_find_section @ + (simple_object_read *@var{simple_object} off_t *@var{offset}, @ + off_t *@var{length}, const char **@var{errmsg}, int *@var{err}) Look for the section @var{name} in @var{simple_object}. This returns information for the first section with that name. @@ -63,14 +70,16 @@ relevant errno. @end deftypefn -@deftypefn Extension {void} simple_object_release_read (simple_object_read *@var{simple_object}) +@deftypefn Extension {void} simple_object_release_read @ + (simple_object_read *@var{simple_object}) Release all resources associated with @var{simple_object}. This does not close the file descriptor. @end deftypefn -@deftypefn Extension {simple_object_attributes *} simple_object_fetch_attributes (simple_object_read *@var{simple_object}, const char **@var{errmsg}, int *@var{err}) +@deftypefn Extension {simple_object_attributes *} simple_object_fetch_attributes @ + (simple_object_read *@var{simple_object}, const char **@var{errmsg}, int *@var{err}) Fetch the attributes of @var{simple_object}. The attributes are internal information such as the format of the object file, or the @@ -84,7 +93,9 @@ error message, and sets @code{*@var{err}} to an errno value or @end deftypefn -@deftypefn Extension {const char *} simple_object_attributes_compare (simple_object_attributes *@var{attrs1}, simple_object_attributes *@var{attrs2}, int *@var{err}) +@deftypefn Extension {const char *} simple_object_attributes_compare @ + (simple_object_attributes *@var{attrs1}, simple_object_attributes *@var{attrs2}, @ + int *@var{err}) Compare @var{attrs1} and @var{attrs2}. If they could be linked together without error, return @code{NULL}. Otherwise, return an @@ -93,13 +104,16 @@ if there is no relevant errno. @end deftypefn -@deftypefn Extension {void} simple_object_release_attributes (simple_object_attributes *@var{attrs}) +@deftypefn Extension {void} simple_object_release_attributes @ + (simple_object_attributes *@var{attrs}) Release all resources associated with @var{attrs}. @end deftypefn -@deftypefn Extension {simple_object_write *} simple_object_start_write (simple_object_attributes @var{attrs}, const char *@var{segment_name}, const char **@var{errmsg}, int *@var{err}) +@deftypefn Extension {simple_object_write *} simple_object_start_write @ + (simple_object_attributes @var{attrs}, const char *@var{segment_name}, @ + const char **@var{errmsg}, int *@var{err}) Start creating a new object file using the object file format described in @var{attrs}. You must fetch attribute information from @@ -117,7 +131,9 @@ to an errno value or @code{0} if there is no relevant errno. @end deftypefn -@deftypefn Extension {simple_object_write_section *} simple_object_write_create_section (simple_object_write *@var{simple_object}, const char *@var{name}, unsigned int @var{align}, const char **@var{errmsg}, int *@var{err}) +@deftypefn Extension {simple_object_write_section *} simple_object_write_create_section @ + (simple_object_write *@var{simple_object}, const char *@var{name}, @ + unsigned int @var{align}, const char **@var{errmsg}, int *@var{err}) Add a section to @var{simple_object}. @var{name} is the name of the new section. @var{align} is the required alignment expressed as the @@ -134,7 +150,10 @@ error message, and sets @code{*@var{err}} to an errno value or @end deftypefn -@deftypefn Extension {const char *} simple_object_write_add_data (simple_object_write *@var{simple_object}, simple_object_write_section *@var{section}, const void *@var{buffer}, size_t @var{size}, int @var{copy}, int *@var{err}) +@deftypefn Extension {const char *} simple_object_write_add_data @ + (simple_object_write *@var{simple_object}, @ + simple_object_write_section *@var{section}, const void *@var{buffer}, @ + size_t @var{size}, int @var{copy}, int *@var{err}) Add data @var{buffer}/@var{size} to @var{section} in @var{simple_object}. If @var{copy} is non-zero, the data will be @@ -148,7 +167,8 @@ no relevant erro. @end deftypefn -@deftypefn Extension {const char *} simple_object_write_to_file (simple_object_write *@var{simple_object}, int @var{descriptor}, int *@var{err}) +@deftypefn Extension {const char *} simple_object_write_to_file @ + (simple_object_write *@var{simple_object}, int @var{descriptor}, int *@var{err}) Write the complete object file to @var{descriptor}, an open file descriptor. This writes out all the data accumulated by calls to @@ -161,7 +181,8 @@ there is no relevant errno. @end deftypefn -@deftypefn Extension {void} simple_object_release_write (simple_object_write *@var{simple_object}) +@deftypefn Extension {void} simple_object_release_write @ + (simple_object_write *@var{simple_object}) Release all resources associated with @var{simple_object}. -- cgit v1.1