From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 10691 invoked by alias); 9 Feb 2009 05:38:35 -0000 Received: (qmail 10597 invoked by uid 22791); 9 Feb 2009 05:38:33 -0000 X-SWARE-Spam-Status: No, hits=-0.6 required=5.0 tests=AWL,BAYES_05 X-Spam-Check-By: sourceware.org Received: from sirppi.helsinki.fi (HELO sirppi.helsinki.fi) (128.214.205.27) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Mon, 09 Feb 2009 05:38:26 +0000 Received: from sirppi.helsinki.fi (localhost [127.0.0.1]) by sirppi.helsinki.fi (8.13.7/8.13.7) with ESMTP id n195cM0X489717 for ; Mon, 9 Feb 2009 07:38:22 +0200 (EET) Received: (from jpihlaja@localhost) by sirppi.helsinki.fi (8.13.7/8.13.7/Submit) id n195cL7X495083; Mon, 9 Feb 2009 07:38:21 +0200 (EET) Date: Mon, 09 Feb 2009 05:38:00 -0000 From: M Joonas Pihlaja To: gsl-discuss@sources.redhat.com Subject: Legendre polynomial documentation Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed Mailing-List: contact gsl-discuss-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gsl-discuss-owner@sourceware.org X-SW-Source: 2009-q1/txt/msg00006.txt.bz2 Hi, The reference manual's entries for the array versions of the associated Legendre polynomials and spherical harmonics are a little confusing I think. 1) The _array function documentation uses the absolute value |m| as the lower bound of the array indices yet also specifies m >= 0. Why the absolute value if negative m aren't allowed after all? 2) The docs say the _deriv_array functions compute "optionally their derivatives", which made me think that the result_deriv_array parameter could be passed in as NULL if one didn't need the derivatives. Turns out that's not what it meant. :) The phrasing could be a little bit more explicit IMHO. Cheers, Joonas