X-Recipient: archive-cygwin AT delorie DOT com
DomainKey-Signature: a=rsa-sha1; c=nofws; d=sourceware.org; h=list-id
	:list-unsubscribe:list-subscribe:list-archive:list-post
	:list-help:sender:mime-version:from:date:message-id:subject:to
	:cc:content-type; q=dns; s=default; b=Me/F15uavl+dqa30FK3ZOTqqvn
	4hQCdJnMvTzAcQlKlp78SeUHOApBg2fj8fF5Klx9foqI/bQR6HJ7TjBDNIeD1boh
	R6E8xCy6c2R74IPt/zFKrucS8VuiMQHlTNJgTk7ifY89FSalAvmdBSioapuFfuxI
	tm1Ki0lDd8DQwpwkY=
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=sourceware.org; h=list-id
	:list-unsubscribe:list-subscribe:list-archive:list-post
	:list-help:sender:mime-version:from:date:message-id:subject:to
	:cc:content-type; s=default; bh=FgKnIy+VsmHspJ3Hkev0cBerRj8=; b=
	vjuiSrOo7LwGL7+LrwnmpRCOyAkXmeqJNwm12h6CzDKKLiHimEdtorqJcIyQyACN
	c5zbmEURgxBVb1xJ8mFB/crwVZ8hgn1DXnKBQBtbB05V1+ZnLtuNyNuU6jUpS/4H
	YTpD/MQxuoL/jBdFTXooR64EmdkT+YGsv/JqLaZ1PSk=
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Id: <cygwin.cygwin.com>
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sourceware.org/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/ml/#faqs>
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
Delivered-To: mailing list cygwin AT cygwin DOT com
Authentication-Results: sourceware.org; auth=none
X-Spam-SWARE-Status: No, score=-1.9 required=5.0 tests=BAYES_00,FREEMAIL_FROM,RCVD_IN_DNSWL_NONE,SPF_PASS autolearn=ham version=3.3.1 spammy=
X-HELO: mail-ed1-f51.google.com
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;        d=gmail.com; s=20161025;        h=mime-version:from:date:message-id:subject:to:cc;        bh=zmWIAXiHnNZfPl1h3DxrV39rkS9i+uiGHTAGjT5LB+Y=;        b=SJMGiys3sNZ9h5ieROXPEFPjpNogs16InoFv4Nrkm14Bm0HmOQ3CeMfIrOQZs+sDzH         ILI5Qja7gpuFqldvL3a8c9esawr1d/JOxjmmSFhEsxD9sV2R8kKUERHdMRGIMNA4GNYr         BjHx9E7wTu21w15I1KU2/qcUymtTS9HbrxFDDlHfxEOmwxSj5lDOi0bLjohh9MkBMttS         LqNgZ6S+lP/G6Rk6QeTa/So9aQYFGDzCmwcDCnl2ik8ujUnx9mJ6ODlI1Ea1XvXfChyb         Wyhqpb7ca+1ktJP1n4/j2U5q+qPSY/huCzCM+wJcTPjqrRjR4QDKFdBEiN3pNhbIgTl1         6zyg==
MIME-Version: 1.0
From: Keith Thompson <Keith DOT S DOT Thompson AT gmail DOT com>
Date: Sat, 8 Feb 2020 14:33:47 -0800
Message-ID: <CAAHpriNDNogQw7VR1CSJLqf57q6w0P+8rNV_8Tn7X27i2YTsSA@mail.gmail.com>
Subject: Library man pages don't mention "-D_GNU_SOURCE" (newlib)
To: cygwin AT cygwin DOT com
Cc: Keith Thompson <Keith DOT S DOT Thompson AT gmail DOT com>
Content-Type: text/plain; charset="UTF-8"

The exp10 function is a GNU extension, as the man page acknowledges.

The exp10(3) man page (available if you install the "cygwin-doc"
package) doesn't mention that you need to compile with "-D_GNU_SOURCE"
to use it. It seems to be inordinately difficult to find this
information.

The corresponding GNU man page, for example exp10(3) on Ubuntu, says:

SYNOPSIS
       #define _GNU_SOURCE         /* See feature_test_macros(7) */
       #include <math.h>

I suggest adding similar wording to the Cygwin/newlib man pages for
functions that require it.

--
Problem reports:       http://cygwin.com/problems.html
FAQ:                   http://cygwin.com/faq/
Documentation:         http://cygwin.com/docs.html
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple