Summary:  res_init(3) is undocumented  

Product:  glibc  Reporter:  Petter Reinholdtsen <pere> 
Component:  manual  Assignee:  Roland McGrath <roland> 
Status:  NEW   
Severity:  normal  CC:  carlos, fweimer, glibcbugs 
Priority:  P2  Flags:  fweimer:
security

Version:  unspecified  
Target Milestone:    
Host:  Target:  
Build:  Last reconfirmed:  20100601 02:02:14  
Attachments:  patch documents the remquo functions 
Description
Petter Reinholdtsen
20040610 10:09:45 UTC
We welcome your contribution of new wording for the manual. Do you have a suggested wording for this documentation? 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. Created attachment 2106 [details]
patch documents the remquo functions
Comment on attachment 2106 [details]
patch documents the remquo functions
 manual/arith.texi 20071119 12:00:50.000000000 +1100
+++ arith.texi 20071124 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
Comment on attachment 2106 [details] patch documents the remquo functions this is a mistake, this patch addresses bug 4449, it also should have the first 3 leading '/' removed from the patch. Shaun info provided 