os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Update documentation now that CVSup service has been shutdown.

Browse source 
PR:		194916
Differential Revision:	https://reviews.freebsd.org/D1137
Approved by:	emaste, remko (mentor)
This commit is contained in:
Jason Helfman 2014-11-11 08:01:42 +00:00
parent 53a5f9cf5b
commit 866ca1aa07
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=45969
1 changed files with 36 additions and 53 deletions

89
en_US.ISO8859-1/articles/building-products/article.xml
View file

@ -547,7 +547,7 @@
<para>FreeBSD traces its roots back nearly twenty years to the
work of the Computer Science Research Group at the
University of California Berkeley.<footnote>
<simpara>FreeBSD's <link xlink:href="http://cvsweb.freebsd.org/">source
<simpara>FreeBSD's <link xlink:href="http://svnweb.freebsd.org/">source
repository</link> contains a history of the project
since its inception, and there are <link xlink:href="http://www.mckusick.com/csrg/">CDROMs
available</link> that contain earlier code from the
@ -581,28 +581,22 @@
<figure xml:id="fig-change-log">
<title>A sample change log entry</title>
<programlisting>
bde 2005-10-29 16:34:50 UTC
r151864 | bde | 2005-10-29 09:34:50 -0700 (Sat, 29 Oct 2005) | 13 lines
Changed paths:
M /head/lib/msun/src/e_rem_pio2f.c
FreeBSD src repository
Use double precision to simplify and optimize arg reduction for small
and medium size args too: instead of conditionally subtracting a float
17+24, 17+17+24 or 17+17+17+24 bit approximation to pi/2, always
subtract a double 33+53 bit one. The float version is now closer to
the double version than to old versions of itself -- it uses the same
33+53 bit approximation as the simplest cases in the double version,
and where the float version had to switch to the slow general case at
|x| == 2^7*pi/2, it now switches at |x| == 2^19*pi/2 the same as the
double version.
Modified files:
lib/msun/src e_rem_pio2f.c
Log:
Use double precision to simplify and optimize arg reduction for small
and medium size args too: instead of conditionally subtracting a float
17+24, 17+17+24 or 17+17+17+24 bit approximation to pi/2, always
subtract a double 33+53 bit one. The float version is now closer to
the double version than to old versions of itself &mdash; it uses the same
33+53 bit approximation as the simplest cases in the double version,
and where the float version had to switch to the slow general case at
|x| == 2^7*pi/2, it now switches at |x| == 2^19*pi/2 the same as the
double version.
This speeds up arg reduction by a factor of 2 for |x| between 3*pi/4 and
2^7*pi/4, and by a factor of 7 for |x| between 2^7*pi/4 and 2^19*pi/4.
Revision Changes Path
1.14 +22 -97 src/lib/msun/src/e_rem_pio2f.c
This speeds up arg reduction by a factor of 2 for |x| between 3*pi/4 and
2^7*pi/4, and by a factor of 7 for |x| between 2^7*pi/4 and 2^19*pi/4.
</programlisting>
</figure>
@ -632,9 +626,9 @@ bde 2005-10-29 16:34:50 UTC
FreeBSD. For example:</para>
<formalpara>
<title>Track FreeBSD source code</title>
<para>The project makes it easy to mirror its CVS
repository using <link xlink:href="&url.articles.cvsup-advanced;"><!--
--><application>CVSup</application></link>. Having
<para>The project makes it easy to mirror its SVN
repository using <link xlink:href="&url.articles.committers-guide;/article.html#svn-advanced-use-setting-up-svnsync"><!--
--><application>svnsync</application></link>. Having
the complete history of the source is useful when
debugging complex problems and offers valuable insight
into the intentions of the original developers. Use a
@ -642,43 +636,32 @@ bde 2005-10-29 16:34:50 UTC
easily merge changes between the upstream FreeBSD code
base and your own in-house code.</para>
</formalpara>
<para><xref linkend="fig-cvs-annotate"/> shows a portion of
<para><xref linkend="fig-svn-blame"/> shows a portion of
an annotated listing of the file referenced by the
change log in <xref linkend="fig-change-log"/>. The
ancestry of each line of the source is clearly visible.
Annotated listings showing the history of every file
that is part of FreeBSD are <link xlink:href="http://cvsweb.freebsd.org/">available on the
that is part of FreeBSD are <link xlink:href="http://svnweb.freebsd.org/">available on the
web</link>.</para>
<figure xml:id="fig-cvs-annotate">
<title>An annotated source listing generated using <command>cvs annotate</command></title>
<figure xml:id="fig-svn-blame">
<title>An annotated source listing generated using <command>svn blame</command></title>
<programlisting>
<![CDATA[
#LINE #REV #WHO #DATE #TEXT
#REV #WHO #DATE #TEXT
62 1.1 (jkh 19-Aug-94): int32_t __ieee754_rem_pio2f(float x, float *y)
63 1.1 (jkh 19-Aug-94): {
64 1.14 (bde 29-Oct-05): double z,w,t,r,fn;
65 1.13 (bde 29-Oct-05): double tx[3];
66 1.14 (bde 29-Oct-05): int32_t e0,i,nx,n,ix,hx;
67 1.1 (jkh 19-Aug-94):
68 1.1 (jkh 19-Aug-94): GET_FLOAT_WORD(hx,x);
69 1.1 (jkh 19-Aug-94): ix = hx&0x7fffffff;
70 1.1 (jkh 19-Aug-94): if(ix<=0x3f490fd8) /* |x| ~<= pi/4 , no need for reduction */
71 1.1 (jkh 19-Aug-94): {y[0] = x; y[1] = 0; return 0;}
72 1.14 (bde 29-Oct-05): /* 33+53 bit pi is good enough for special and medium size cases */
73 1.2 (bde 07-Apr-95): if(ix<0x4016cbe4) { /* |x| < 3pi/4, special case with n=+-1 */
74 1.14 (bde 29-Oct-05): if(hx>0) {
75 1.15 (bde 06-Nov-05): z = x - pio2;
76 1.15 (bde 06-Nov-05): n = 1;
77 1.15 (bde 06-Nov-05): } else {
78 1.15 (bde 06-Nov-05): z = x + pio2;
79 1.15 (bde 06-Nov-05): n = 3;
80 1.9 (bde 08-Oct-05): }
81 1.15 (bde 06-Nov-05): y[0] = z;
82 1.15 (bde 06-Nov-05): y[1] = z - y[0];
83 1.15 (bde 06-Nov-05): return n;
84 1.15 (bde 06-Nov-05): }
85 1.15 (bde 06-Nov-05): if(ix<0x407b53d1) { /* |x| < 5*pi/4, special case with n=+-2 */
176410 bde 2008-02-19 07:42:46 -0800 (Tue, 19 Feb 2008) #include <sys/cdefs.h>
176410 bde 2008-02-19 07:42:46 -0800 (Tue, 19 Feb 2008) __FBSDID("$FreeBSD$");
2116 jkh 1994-08-19 02:40:01 -0700 (Fri, 19 Aug 1994)
2116 jkh 1994-08-19 02:40:01 -0700 (Fri, 19 Aug 1994) /* __ieee754_rem_pio2f(x,y)
8870 rgrimes 1995-05-29 22:51:47 -0700 (Mon, 29 May 1995) *
176552 bde 2008-02-25 05:33:20 -0800 (Mon, 25 Feb 2008) * return the remainder of x rem pi/2 in *y
176552 bde 2008-02-25 05:33:20 -0800 (Mon, 25 Feb 2008) * use double precision for everything except passing x
152535 bde 2005-11-16 18:20:04 -0800 (Wed, 16 Nov 2005) * use __kernel_rem_pio2() for large x
2116 jkh 1994-08-19 02:40:01 -0700 (Fri, 19 Aug 1994) */
2116 jkh 1994-08-19 02:40:01 -0700 (Fri, 19 Aug 1994)
176465 bde 2008-02-22 07:55:14 -0800 (Fri, 22 Feb 2008) #include <float.h>
176465 bde 2008-02-22 07:55:14 -0800 (Fri, 22 Feb 2008)
2116 jkh 1994-08-19 02:40:01 -0700 (Fri, 19 Aug 1994) #include "math.h"
]]>
</programlisting>
</figure>