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>

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

- Raw text -