From owner-freebsd-numerics@FreeBSD.ORG Sun Aug 5 19:19:55 2012 Return-Path: Delivered-To: freebsd-numerics@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 770D8106566B for ; Sun, 5 Aug 2012 19:19:55 +0000 (UTC) (envelope-from sgk@troutmask.apl.washington.edu) Received: from troutmask.apl.washington.edu (troutmask.apl.washington.edu [128.95.76.21]) by mx1.freebsd.org (Postfix) with ESMTP id 505A58FC14 for ; Sun, 5 Aug 2012 19:19:55 +0000 (UTC) Received: from troutmask.apl.washington.edu (localhost.apl.washington.edu [127.0.0.1]) by troutmask.apl.washington.edu (8.14.5/8.14.5) with ESMTP id q75JJsPd050391; Sun, 5 Aug 2012 12:19:54 -0700 (PDT) (envelope-from sgk@troutmask.apl.washington.edu) Received: (from sgk@localhost) by troutmask.apl.washington.edu (8.14.5/8.14.5/Submit) id q75JJsVv050390; Sun, 5 Aug 2012 12:19:54 -0700 (PDT) (envelope-from sgk) Date: Sun, 5 Aug 2012 12:19:54 -0700 From: Steve Kargl To: Stephen Montgomery-Smith Message-ID: <20120805191954.GA50379@troutmask.apl.washington.edu> References: <5017111E.6060003@missouri.edu> <501C361D.4010807@missouri.edu> <20120804165555.X1231@besplex.bde.org> <501D51D7.1020101@missouri.edu> <20120805030609.R3101@besplex.bde.org> <501D9C36.2040207@missouri.edu> <20120805175106.X3574@besplex.bde.org> <501EC015.3000808@missouri.edu> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <501EC015.3000808@missouri.edu> User-Agent: Mutt/1.4.2.3i Cc: freebsd-numerics@freebsd.org, Bruce Evans Subject: Re: Complex arg-trig functions X-BeenThere: freebsd-numerics@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Discussions of high quality implementation of libm functions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 05 Aug 2012 19:19:55 -0000 On Sun, Aug 05, 2012 at 01:48:53PM -0500, Stephen Montgomery-Smith wrote: > On 08/05/2012 05:05 AM, Bruce Evans wrote: > >On Sat, 4 Aug 2012, Stephen Montgomery-Smith wrote: > > >> > >>What is the purpose of the macros norm and spadd? > > > >[Answer snipped for brevity] > > Thank you. Your answers are very helpful. I had no idea what norm and > spadd did, and now just even glancing through your answers tells me > exactly what they do (even if I haven't yet fully understood why they work). > > If you don't want lengthy comments in the code, perhaps you could simply > include the following link in a comment: > http://lists.freebsd.org/pipermail/freebsd-numerics/2012-August/000020.html > > Let me say that in my proposed code for casinh, etc, that I do have > essay length comments. > http://people.freebsd.org/~stephen/catrig.c > > I plan to respect your style (keep out very lengthy comments), but I > hope whomever commits my code will respect my style and keep the lengthy > comments. Essay long comments probably belong in the man page if the essay is important to the details of implementation. Bruce may disagree with me. -- Steve