IO::Select TIMEOUT units

[p5pRT]

Migrated from rt.perl.org#3665 (status was 'resolved')

Searchable as RT3665$

[p5pRT]

From friedman@minc1.cs.umass.edu

Created by timur@research.att.com

The documentation for IO​::Select does not mention what units are used for TIMEOUT (i.e. is it a number of seconds\, or milliseconds?)

The documentation should mention the units. If the units are not fixed\, but are system-dependent\, then this fact should be mentioned\, and a cross-reference supplied.

This report concerns the documentation at \<http​://www.perl.com/pub/doc/manual/html/lib/IO/Select.html>.

Perl Info

``` Site configuration information for perl 5.00503: Configured by markm at $Date: 1999/05/05 19:42:40 $. Summary of my perl5 (5.0 patchlevel 5 subversion 3) configuration: Platform: osname=freebsd, osvers=4.0-current, archname=i386-freebsd uname='freebsd freefall.freebsd.org 4.0-current freebsd 4.0-current #0: $Date: 1999/05/05 19:42:40 $' hint=recommended, useposix=true, d_sigaction=define usethreads=undef useperlio=undef d_sfio=undef Compiler: cc='cc', optimize='undef', gccversion=egcs-2.91.66 19990314 (egcs-1.1.2 release) cppflags='' ccflags ='' stdchar='char', d_stdstdio=undef, usevfork=true intsize=4, longsize=4, ptrsize=4, doublesize=8 d_longlong=define, longlongsize=8, d_longdbl=define, longdblsize=12 alignbytes=4, usemymalloc=n, prototype=define Linker and Libraries: ld='cc', ldflags ='-Wl,-E' libpth=/usr/lib libs=-lm -lc -lcrypt libc=/usr/lib/libc.so, so=so, useshrplib=true, libperl=libperl.so.3 Dynamic Linking: dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef, ccdlflags=' ' cccdlflags='-DPIC -fpic', lddlflags='-shared' Locally applied patches: @INC for perl 5.00503: /usr/libdata/perl/5.00503/mach /usr/libdata/perl/5.00503 /usr/local/lib/perl5/site_perl/5.005/i386-freebsd /usr/local/lib/perl5/site_perl/5.005 . Environment for perl 5.00503: HOME=/home/friedman LANG (unset) LANGUAGE (unset) LD_LIBRARY_PATH (unset) LOGDIR (unset) PATH=.:/home/friedman/projects/groupsize/bin/fbsd:/home/friedman/bin/fbsd:/home/friedman/nimi/bin:/usr/local/bin:/usr/bin:/usr/sbin:/bin:/sbin:/usr/ucb:/usr/bsd:/usr/ccs/bin:/etc:/usr/etc:/usr/bin/X11:/usr/openwin/bin PERL_BADLANG (unset) SHELL=/usr/local/bin/tcsh ```

[p5pRT]

From @jhi

The documentation for IO​::Select does not mention what units are used for TIMEOUT (i.e. is it a number of seconds\, or milliseconds?)

The documentation should mention the units. If the units are not fixed\, but are system-dependent\, then this fact should be mentioned\, and a cross-reference supplied.

Thank you for your report. The timeout is in seconds\, possibly fractional\, just as the timeout of Perl's 4-arg select(). This will be documented in upcoming Perl releases.