[Bug manual/212] New: res_init(3) is undocumented

[Bug manual/212] New: res_init(3) is undocumented

[pere at hungry dot com]

The function used to rescan /etc/resolv.conf is not mentioned in the manual.
It would be nice it was documented in the official glibc documentation.

It is documented in the manpages package.

-- 
           Summary: res_init(3) is undocumented
           Product: glibc
           Version: unspecified
            Status: NEW
          Severity: normal
          Priority: P2
         Component: manual
        AssignedTo: roland at gnu dot org
        ReportedBy: pere at hungry dot com
                CC: glibc-bugs at sources dot redhat dot com


http://sources.redhat.com/bugzilla/show_bug.cgi?id=212

------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.

[Bug manual/212] res_init(3) is undocumented

[roland at gnu dot org]

------- Additional Comments From roland at gnu dot org  2006-02-22 06:55 -------
We welcome your contribution of new wording for the manual.

-- 
           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |WAITING


http://sourceware.org/bugzilla/show_bug.cgi?id=212

------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.

[Bug manual/212] res_init(3) is undocumented

[decimal at us dot ibm dot com]

-- 
           What    |Removed                     |Added
----------------------------------------------------------------------------
               Flag|                            |examined+


http://sourceware.org/bugzilla/show_bug.cgi?id=212

------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.

[Bug manual/212] res_init(3) is undocumented

[decimal at us dot ibm dot com]

------- Additional Comments From decimal at us dot ibm dot com  2006-02-28 19:33 -------
Do you have a suggested wording for this documentation?

-- 


http://sourceware.org/bugzilla/show_bug.cgi?id=212

------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.

[Bug manual/212] res_init(3) is undocumented

[pere at hungry dot com]

------- Additional Comments From pere at hungry dot com  2006-03-02 16:04 -------
Not really.  I just noted the lack of documententation and wanted to make
sure it wasn't forgotten.

Not sure if it is OK to just copy from the manual page.  There it is
documented like this along with several of the res_* functions.

  SYNOPSIS
       #include <netinet/in.h>
       #include <arpa/nameser.h>
       #include <resolv.h>
       extern struct state _res;

       int res_init(void);
[...]
       The res_init() function reads the configuration files (see resolv+(8))
       to  get  the  default  domain  name,  search  order  and  name  server
       address(es).   If  no server is given, the local host is tried.  If no
       domain is given, that associated with the local host is used.  It  can
       be  overridden  with the environment variable LOCALDOMAIN.  res_init()
       is normally executed by the first call to one of the other  functions.


-- 


http://sourceware.org/bugzilla/show_bug.cgi?id=212

------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.

[Bug manual/212] res_init(3) is undocumented

[genix at mysoul dot com dot au]

------- Additional Comments From genix at mysoul dot com dot au  2007-11-24 12:11 -------
Created an attachment (id=2106)
 --> (http://sourceware.org/bugzilla/attachment.cgi?id=2106&action=view)
patch documents the remquo functions


-- 


http://sourceware.org/bugzilla/show_bug.cgi?id=212

------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.

[Bug manual/212] res_init(3) is undocumented

[genix at mysoul dot com dot au]

------- Additional Comments From genix at mysoul dot com dot au  2007-11-24 12:18 -------
(From update of attachment 2106)
--- manual/arith.texi	2007-11-19 12:00:50.000000000 +1100
+++ arith.texi	2007-11-24 23:03:06.000000000 +1100
@@ -1546,6 +1546,29 @@
 This function is another name for @code{drem}.
 @end deftypefun

+@comment math.h
+@comment ISO_C99
+@deftypefun double remquo (double @var{numerator}, double @var{denominator},
int @var{*quo})
+@comment math.h
+@comment ISO_C99
+@deftypefunx float remquof (float @var{numerator}, float @var{denominator},
int @var{*quo})
+@comment math.h
+@comment ISO_C99
+@deftypefunx {long double} remquol (long double @var{numerator}, long double
@var{denominator}, int @var{*quo})
+
+These	functions  compute the remainder and part of the quotient upon division
+of @var{numerator} by @var{denominator}. A few bits of the quotient are stored
+via the @var{quo} pointer. The remainder is returned as function value.
+
+The value of the remainder is the same as that computed by the
@code{remainder}
+function above. The value stored via the @var{quo} pointer has the sign of
+@var{numerator}/@var{denominator} and agrees with the quotient in at least the
+low order 3 bits.
+
+For example, @code{remquo(29.0,3.0)} returns @code{-1.0} and might store
@code{2}.
+Note that the actual quotient might not fit in an integer.
+@end deftypefun
+
 @node FP Bit Twiddling
 @subsection Setting and modifying single bits of FP values
 @cindex FP arithmetic


-- 


http://sourceware.org/bugzilla/show_bug.cgi?id=212

------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.

[Bug manual/212] res_init(3) is undocumented

[genix at mysoul dot com dot au]

------- Additional Comments From genix at mysoul dot com dot au  2007-11-24 12:40 -------
(From update of attachment 2106)
this is a mistake, this patch addresses bug 4449, it also should have the first
3 leading '/' removed from the patch. Shaun


-- 


http://sourceware.org/bugzilla/show_bug.cgi?id=212

------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.

[Bug manual/212] res_init(3) is undocumented

[pasky at suse dot cz]

------- Additional Comments From pasky at suse dot cz  2010-06-01 02:02 -------
info provided

-- 
           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|WAITING                     |NEW
   Last reconfirmed|0000-00-00 00:00:00         |2010-06-01 02:02:14
               date|                            |


http://sourceware.org/bugzilla/show_bug.cgi?id=212

------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.