Commit Graph

982 Commits

Author SHA1 Message Date
Will Newton
6f918f367a manual/setjmp.texi: Improve clarity of Sys V context doc
ChangeLog:

2014-03-13  Will Newton  <will.newton@linaro.org>

	* manual/setjmp.texi (System V contexts): Improve
	clarity and grammar of documentation.
2014-03-13 10:39:47 +00:00
Joseph Myers
355bc9868b Remove INSTALL_INFO setting in manual/Makefile.
* manual/Makefile (INSTALL_INFO): Remove variable setting.
2014-03-06 15:57:24 +00:00
Joseph Myers
e6b6a85705 Don't include individual test ulps in libm-test-ulps.
As recently discussed
<https://sourceware.org/ml/libc-alpha/2014-02/msg00670.html>, it
doesn't seem particularly useful for libm-test-ulps files to contain
huge amounts of data on ulps for individual tests; just the global
maximum observed ulps for each function, together with the
verification of exceptions, errno and special results such as
infinities and NaNs for each test, suffices to verify that a
function's behavior on the given test inputs is within the expected
accuracy.  Removing this data reduces source tree churn caused by
updates to these files when libm tests are added, and reduces the
frequency with which testsuite additions actually need libm-test-ulps
changes at all.

Accordingly, this patch removes that data, so that individual tests
get checked against the global bounds for the given function and only
generate an error if those are exceeded.  Tested x86_64 (including
verifying that if an ulps value is artificially reduced, the tests do
indeed fail as they should and "make regen-ulps" generates the
expected changes).

	* math/libm-test.inc (struct ulp_data): Don't refer to ulps for
	individual tests in comment.
	(libm-test-ulps.h): Don't refer to test_ulps in #include comment.
	(prev_max_error): New variable.
	(prev_real_max_error): Likewise.
	(prev_imag_max_error): Likewise.
	(compare_ulp_data): Don't refer to test names in comment.
	(find_test_ulps): Remove function.
	(find_function_ulps): Likewise.
	(find_complex_function_ulps): Likewise.
	(init_max_error): Take function name as argument.  Look up ulps
	for that function.
	(print_ulps): Remove function.
	(print_max_error): Use prev_max_error instead of calling
	find_function_ulps.
	(print_complex_max_error): Use prev_real_max_error and
	prev_imag_max_error instead of calling find_complex_function_ulps.
	(check_float_internal): Take max_ulp parameter instead of calling
	find_test_ulps.  Don't call print_ulps.
	(check_float): Update call to check_float_internal.
	(check_complex): Update calls to check_float_internal.
	(START): Pass argument to init_max_error.
	* math/gen-libm-test.pl (%results): Don't include "kind"
	information.
	(parse_ulps): Don't handle ulps of individual tests.
	(print_ulps_file): Likewise.
	(output_ulps): Likewise.
	* math/README.libm-test: Update.
	* manual/libm-err-tab.pl (parse_ulps): Don't handle ulps of
	individual tests.
	* sysdeps/aarch64/libm-test-ulps: Remove individual test ulps.
	* sysdeps/alpha/fpu/libm-test-ulps: Likewise.
	* sysdeps/arm/libm-test-ulps: Likewise.
	* sysdeps/i386/fpu/libm-test-ulps: Likewise.
	* sysdeps/ia64/fpu/libm-test-ulps: Likewise.
	* sysdeps/m68k/coldfire/fpu/libm-test-ulps: Likewise.
	* sysdeps/m68k/m680x0/fpu/libm-test-ulps: Likewise.
	* sysdeps/microblaze/libm-test-ulps: Likewise.
	* sysdeps/mips/mips32/libm-test-ulps: Likewise.
	* sysdeps/mips/mips64/libm-test-ulps: Likewise.
	* sysdeps/powerpc/fpu/libm-test-ulps: Likewise.
	* sysdeps/powerpc/nofpu/libm-test-ulps: Likewise.
	* sysdeps/s390/fpu/libm-test-ulps: Likewise.
	* sysdeps/sh/libm-test-ulps: Likewise.
	* sysdeps/sparc/fpu/libm-test-ulps: Likewise.
	* sysdeps/tile/libm-test-ulps: Likewise.
	* sysdeps/x86_64/fpu/libm-test-ulps: Likewise.

	* sysdeps/hppa/fpu/libm-test-ulps: Remove individual test ulps.
2014-03-05 15:02:38 +00:00
Carlos O'Donell
ef563f925a Add header and standard information to threads.texi.
The glibc manual uses special annotations to include functions
in the summary chapter. These annotations were missing from the
functions in the threads chapter. This patch adds those special
markers and in turn adds these functions to the summary chapter.
2014-02-28 18:30:22 -05:00
Roland McGrath
f08e9a2629 Fix fallout from Joseph's untested Makeconfig change. 2014-02-28 13:00:27 -08:00
Joseph Myers
a5f891ac8d Consistently include Makeconfig after defining subdir.
In <https://sourceware.org/ml/libc-alpha/2014-01/msg00196.html> I
noted it was necessary to add includes of Makeconfig early in various
subdirectory makefiles for the tests-special variable settings added
by that patch to be conditional on configuration information.  No-one
commented on the general question there of whether Makeconfig should
always be included immediately after the definition of subdir.

This patch implements that early inclusion of Makeconfig in each
directory (which is a lot easier than consistent placement of includes
of Rules).  Includes are added if needed, or moved up if already
present.  Subdirectory "all:" targets are removed, since Makeconfig
provides one.

There is potential for further cleanups I haven't done.  Rules and
Makerules have code such as

ifneq   "$(findstring env,$(origin headers))" ""
headers :=
endif

to override to empty any value of various variables that came from the
environment.  I think there is a case for Makeconfig setting all the
subdirectory variables (other than subdir) to empty to ensure no
outside value is going to take effect if a subdirectory fails to
define a variable.  (A list of such variables, possibly out of date
and incomplete, is in manual/maint.texi.)  Rules and Makerules would
give errors if Makeconfig hadn't already been included, instead of
including it themselves.  The special code to override values coming
from the environment would then be obsolete and could be removed.

Tested x86_64, including that installed binaries are identical before
and after the patch.

	* argp/Makefile: Include Makeconfig immediately after defining
	subdir.
	* assert/Makefile: Likewise.
	* benchtests/Makefile: Likewise.
	* catgets/Makefile: Likewise.
	* conform/Makefile: Likewise.
	* crypt/Makefile: Likewise.
	* csu/Makefile: Likewise.
	(all): Remove target.
	* ctype/Makefile: Include Makeconfig immediately after defining
	subdir.
	* debug/Makefile: Likewise.
	* dirent/Makefile: Likewise.
	* dlfcn/Makefile: Likewise.
	* gmon/Makefile: Likewise.
	* gnulib/Makefile: Likewise.
	* grp/Makefile: Likewise.
	* gshadow/Makefile: Likewise.
	* hesiod/Makefile: Likewise.
	* hurd/Makefile: Likewise.
	(all): Remove target.
	* iconvdata/Makefile: Include Makeconfig immediately after
	defining subdir.
	* inet/Makefile: Likewise.
	* intl/Makefile: Likewise.
	* io/Makefile: Likewise.
	* libio/Makefile: Likewise.
	(all): Remove target.
	* locale/Makefile: Include Makeconfig immediately after defining
	subdir.
	* login/Makefile: Likewise.
	* mach/Makefile: Likewise.
	(all): Remove target.
	* malloc/Makefile: Include Makeconfig immediately after defining
	subdir.
	(all): Remove target.
	* manual/Makefile: Include Makeconfig immediately after defining
	subdir.
	* math/Makefile: Likewise.
	* misc/Makefile: Likewise.
	* nis/Makefile: Likewise.
	* nss/Makefile: Likewise.
	* po/Makefile: Likewise.
	(all): Remove target.
	* posix/Makefile: Include Makeconfig immediately after defining
	subdir.
	* pwd/Makefile: Likewise.
	* resolv/Makefile: Likewise.
	* resource/Makefile: Likewise.
	* rt/Makefile: Likewise.
	* setjmp/Makefile: Likewise.
	* shadow/Makefile: Likewise.
	* signal/Makefile: Likewise.
	* socket/Makefile: Likewise.
	* soft-fp/Makefile: Likewise.
	* stdio-common/Makefile: Likewise.
	* stdlib/Makefile: Likewise.
	* streams/Makefile: Likewise.
	* string/Makefile: Likewise.
	* sunrpc/Makefile: Likewise.
	(all): Remove target.
	* sysvipc/Makefile: Include Makeconfig immediately after defining
	subdir.
	* termios/Makefile: Likewise.
	* time/Makefile: Likewise.
	* timezone/Makefile: Likewise.
	(all): Remove target.
	* wcsmbs/Makefile: Include Makeconfig immediately after defining
	subdir.
	* wctype/Makefile: Likewise.

libidn/ChangeLog:
	* Makefile: Include Makeconfig immediately after defining subdir.

localedata/ChangeLog:
	* Makefile: Include Makeconfig immediately after defining subdir.
	(all): Remove target.

nptl/ChangeLog:
	* Makefile: Include Makeconfig immediately after defining subdir.

nptl_db/ChangeLog:
	* Makefile: Include Makeconfig immediately after defining subdir.
2014-02-26 23:12:03 +00:00
Ondřej Bílka
cf822e3c94 Fix two spaces after sentence.
Minor formatting fix that was carried by issuing
sed -e"s/\. \([A-Z]\)/.  \1/" followed by editing result.
2014-02-26 23:27:38 +01:00
Carlos O'Donell
f067bf1f33 Use @Theglibc{} in manual/ipc.texi. 2014-02-26 13:39:02 -05:00
Carlos O'Donell
085d0e354a Add a new "Inter-Process Communication" chapter.
This patch adds a new "Inter-Process Communication"
chapter to cover the sem*, msg*, and shm* functions.
Initially we document only the sem* function signatures
and their safety notes.
2014-02-26 11:05:09 -05:00
Joseph Myers
c941736c92 Remove _BSD_SOURCE and _SVID_SOURCE.
This is a minimal patch to remove _BSD_SOURCE and _SVID_SOURCE from
the documented user API, making them into aliases for _DEFAULT_SOURCE
with a #warning given, but keeping most of the features.h logic using
those macros and all the exising __USE_* conditionals, on the basis
that all the consequent cleanups will go in followup patches.

Tested x86_64.

	* include/features.h: Update comment documenting feature test
	macros.
	[_BSD_SOURCE || _SVID_SOURCE]: Give #warning.  Define
	_DEFAULT_SOURCE.
	* manual/creature.texi (_BSD_SOURCE): Remove documentation.
	(_SVID_SOURCE): Likewise.
	(_DEFAULT_SOURCE): Update description of default features.
	(Feature Test Macros): Don't mention _SVID_SOURCE in conjunction
	with _GNU_SOURCE.
	* manual/filesys.texi (__ftw_func_t): Do not refer to _BSD_SOURCE.
	(S_ISVTX): Likewise.
	* manual/math.texi (Mathematical Constants): Likewise.
	* manual/signal.texi (Interrupted Primitives): Likewise.
	* manual/startup.texi (putenv): Do not refer to _SVID_SOURCE.
	* math/test-matherr.c (_SVID_SOURCE): Do not define.
	* sysvipc/sys/ipc.h [__USE_SVID && !__USE_XOPEN && __GNUC__ >= 2]:
	Don't refer to _SVID_SOURCE in warning text.
2014-02-11 23:40:07 +00:00
Will Newton
d35f1e8073 manual/probes.texi: Use "triggered" instead of "hit"
Use the term "triggered" instead of "hit" when talking about probe
points.

ChangeLog:

2014-02-11  Will Newton  <will.newton@linaro.org>

	* manual/probes.texi (Mathematical Function Probes): Use
	"triggered" instead of "hit".
2014-02-11 10:21:00 +00:00
Will Newton
7b3436d468 manual/probes.texi: Add documentation of setjmp/longjmp probes
Add some documentation of the setjmp, longjmp and longjmp_target
Systemtap probe points.

ChangeLog:

2014-02-11  Will Newton  <will.newton@linaro.org>

	* manual/probes.texi (Internal Probes): Add documentation
	of setjmp, longjmp and longjmp_target probes.
2014-02-11 10:19:24 +00:00
Mike Frysinger
6349768c8b manual: setjmp: fix typos/grammar
Should hopefully be all obvious stuff.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
2014-02-08 07:59:36 -05:00
Siddhesh Poyarekar
ee7cc38537 Update contrib.texi
Update blurb for Roland, Alex, Ryan, Joseph and Carlos.
2014-02-06 11:01:35 +05:30
Siddhesh Poyarekar
6815994630 Update contrib.texi
This may not be a complete list of new contributors added to the list,
so I'd love it if more people look at contributions and suggest
additions.
2014-02-05 12:22:58 +05:30
Carlos O'Donell
481e3524bb Fix manual build warnings.
The mixed use of automatic and manual node next, previous,
and top specification causes warning when building the manual.
This fix explicitly specifies the node's next, previous and top
values to fix the warning.
2014-02-03 15:27:53 -05:00
Alexandre Oliva
375592d364 * manual/macros.texi: Add comments before MTASC-safety macros. 2014-02-03 17:26:08 -02:00
Alexandre Oliva
f54838baf8 * manual/users.texi: Document MTASC-safety properties. 2014-02-03 17:25:38 -02:00
Alexandre Oliva
909e12ad34 * manual/threads.texi (pthread_key_create, pthread_key_delete,
pthread_getspecific, pthread_setspecific): Format with
@deftypefun, and add @safety note.
* manual/signal.texi: Move comments that analyze the above
functions to their home place.
2014-02-03 17:17:59 -02:00
Alexandre Oliva
597636d736 * manual/time.texi (timegm): Add missing blank after @c.
Reported by Joseph Myers <joseph@codesourcery.com>.
2014-02-02 21:50:54 -02:00
Alexandre Oliva
ee196e3ca4 * manual/check-safety.sh: New.
* manual/Makefile ($(objpfx)stamp-summary): Run it.
2014-02-01 04:31:05 -02:00
Alexandre Oliva
f8d529d519 * manual/terminal.texi: Document MTASC-safety properties. 2014-02-01 03:53:15 -02:00
Alexandre Oliva
de55fdf4b5 * manual/filesys.texi: Document MTASC-safety properties. 2014-02-01 03:50:11 -02:00
Alexandre Oliva
c3299c08d1 * manual/errno.texi: Document MTASC-safety properties. 2014-02-01 03:49:25 -02:00
Alexandre Oliva
06e90b14b4 * manual/intro.texi: Document safety identifiers and
conditionals.
2014-02-01 03:48:32 -02:00
Alexandre Oliva
1acd4371c0 * manual/string.texi (wcstok): Fix prototype.
(wcstok, strtok, strtok_r): Adjust reentrancy remarks.
2014-02-01 03:38:33 -02:00
Alexandre Oliva
23e5b8cb1b * manual/time.texi: Document MTASC-safety properties. 2014-02-01 02:51:51 -02:00
Alexandre Oliva
11087373a6 * manual/string.texi: Document MTASC-safety properties. 2014-02-01 02:46:54 -02:00
Alexandre Oliva
5da2c93d24 * manual/threads.texi: Document MTASC-safety properties. 2014-02-01 01:29:35 -02:00
Alexandre Oliva
171e921053 * manual/stdio.texi: Document MTASC-safety properties. 2014-02-01 01:27:52 -02:00
Alexandre Oliva
d9e025328b * manual/syslog.texi: Document MTASC-safety properties. 2014-02-01 01:22:09 -02:00
Alexandre Oliva
6af8bab7e0 * manual/sysinfo.texi: Document MTASC-safety properties. 2014-02-01 01:16:09 -02:00
Alexandre Oliva
663b02d7bd * manual/startup.texi: Document MTASC-safety properties. 2014-02-01 01:04:59 -02:00
Alexandre Oliva
973f180bd5 * manual/socket.texi: Document MTASC-safety properties. 2014-02-01 01:03:33 -02:00
Alexandre Oliva
8f3c25c8d9 * manual/signal.texi: Document MTASC-safety properties. 2014-02-01 00:58:50 -02:00
Alexandre Oliva
542210fbc5 * manual/setjmp.texi: Document MTASC-safety properties. 2014-01-31 23:49:07 -02:00
Alexandre Oliva
433c45a247 * manual/search.texi: Document MTASC-safety properties. 2014-01-31 23:47:28 -02:00
Alexandre Oliva
c8ce789c81 * manual/resource.texi: Document MTASC-safety properties. 2014-01-31 23:46:01 -02:00
Alexandre Oliva
19f5d29c35 * manual/process.texi: Document MTASC-safety properties. 2014-01-31 23:44:19 -02:00
Alexandre Oliva
e2dfb7f4ca * manual/platform.texi: Document MTASC-safety properties. 2014-01-31 23:40:29 -02:00
Alexandre Oliva
8c1413f5ac * manual/pipe.texi: Document MTASC-safety properties. 2014-01-31 23:37:28 -02:00
Alexandre Oliva
03483adac5 * manual/pattern.texi: Document MTASC-safety properties. 2014-01-31 23:36:46 -02:00
Alexandre Oliva
29e7e2dfea * manual/message.texi: Document MTASC-safety properties. 2014-01-31 23:31:22 -02:00
Alexandre Oliva
9f529d7cfa [BZ #12751]
* manual/memory.texi: Document MTASC-safety properties.
2014-01-31 23:28:38 -02:00
Alexandre Oliva
27aaa79114 * manual/math.texi: Document MTASC-safety properties. 2014-01-31 23:27:25 -02:00
Alexandre Oliva
f2d5872628 * manual/locale.texi: Document MTASC-safety properties. 2014-01-31 23:26:23 -02:00
Alexandre Oliva
2cc3615ce8 * manual/llio.texi: Document MTASC-safety properties. 2014-01-31 23:25:06 -02:00
Alexandre Oliva
d9f0ec97d6 * manual/libdl.texi: New. 2014-01-31 23:23:59 -02:00
Alexandre Oliva
e7c4409a64 * manual/lang.texi: Document MTASC-safety properties. 2014-01-31 23:21:48 -02:00
Alexandre Oliva
27bdc63ce3 * manual/job.texi: Document MTASC-safety properties. 2014-01-31 23:20:02 -02:00