Bug 103873 - Info documents non-existent math functions
Summary: Info documents non-existent math functions
Keywords:
Status: CLOSED WONTFIX
Alias: None
Product: Red Hat Linux
Classification: Retired
Component: man-pages
Version: 9
Hardware: i386
OS: Linux
low
medium
Target Milestone: ---
Assignee: Eido Inoue
QA Contact: Ben Levenson
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2003-09-05 22:10 UTC by Horst H. von Brand
Modified: 2007-03-27 04:09 UTC (History)
0 users

Fixed In Version:
Clone Of:
Environment:
Last Closed: 2003-09-25 17:04:09 UTC
Embargoed:


Attachments (Terms of Use)

Description Horst H. von Brand 2003-09-05 22:10:23 UTC
Description of problem: Functions log2, exp2, exp10 are documented in info, but
not in manpages. The functions do not exist.


Version-Release number of selected component (if applicable): 2.3.2-27.9


How reproducible: Always


Steps to Reproduce:
1. pinfo libc, go to Mathematics
2. Find listed functions documented
3. Go to manpage, use in program, futz around in the math.h header, ...
    
Actual results:
Listed functions aren't there (no manpage, not in the math.h header or library
either)

Expected results:
Just existing functions documented? ;-)

Additional info:
I believe all those are non-essential GNU extensions (or where at some point in
time), they could safely just be removed from the documentation.

Comment 1 Jakub Jelinek 2003-09-05 22:18:41 UTC
The functions of exist. exp2/log2 are ISO C99 functions, so one of
-std=c99, -std=gnu99, -D_ISOC99_SOURCE or -D_GNU_SOURCE is needed to get
their prototypes in math.h (info libc talks about feature macros).
exp10 and pow10 are GNU extensions, so -D_GNU_SOURCE is needed to get their
prototypes.

Comment 2 Horst H. von Brand 2003-09-05 22:35:36 UTC
Then the fact that extra magic is needed to get them is not documented is
certainly a bug, as is the fact that they aren't documented in manpages...

Comment 3 Jakub Jelinek 2003-09-08 07:58:30 UTC
info libc doesn't mention this for any function (nor it mentions which header provides which prototype), it just notes (e.g. for
exp10/pow10) that the functions are GNU extensions, which in standard headers
implies -D_GNU_SOURCE).
Man pages should list things like this, but they are missing (also for lots of
other functions). Changing this to enhancement request for man pages
(patches appreciated as always).

Comment 4 Eido Inoue 2003-09-25 17:04:09 UTC
the info pages will always be the authoritive source and will never be as
complete as the info pages unfortunately. it would be nice if either/both drew
there docs from a common source, but they don't.


Note You need to log in before you can comment on or make changes to this bug.