Index: ossp-pkg/pth/ChangeLog RCS File: /v/ossp/cvs/ossp-pkg/pth/ChangeLog,v rcsdiff -q -kk '-r1.554' '-r1.555' -u '/v/ossp/cvs/ossp-pkg/pth/ChangeLog,v' 2>/dev/null --- ChangeLog 2002/01/27 10:51:52 1.554 +++ ChangeLog 2002/01/27 12:34:29 1.555 @@ -19,7 +19,7 @@ | ||__ _| __|_(_) |_|_____________________________________________________________ - Changes between 1.4.0 and 1.4.1 (24-Mar-2001 to xx-Jan-2002) + Changes between 1.4.0 and 1.4.1 (24-Mar-2001 to 27-Jan-2002) *) Fixed typos in manual page. [Michael Schloh v. Bennewitz , Index: ossp-pkg/pth/README RCS File: /v/ossp/cvs/ossp-pkg/pth/README,v rcsdiff -q -kk '-r1.193' '-r1.194' -u '/v/ossp/cvs/ossp-pkg/pth/README,v' 2>/dev/null --- README 2002/01/27 11:03:40 1.193 +++ README 2002/01/27 12:34:29 1.194 @@ -5,7 +5,7 @@ |_| \__|_| |_| the impossible.'' GNU Pth - The GNU Portable Threads - Version 1.4.0 (24-Mar-2001) + Version 1.4.1 (27-Jan-2002) ABSTRACT Index: ossp-pkg/pth/pth-config.1 RCS File: /v/ossp/cvs/ossp-pkg/pth/Attic/pth-config.1,v rcsdiff -q -kk '-r1.131' '-r1.132' -u '/v/ossp/cvs/ossp-pkg/pth/Attic/pth-config.1,v' 2>/dev/null --- pth-config.1 2001/03/24 16:30:36 1.131 +++ pth-config.1 2002/01/27 12:34:30 1.132 @@ -1,5 +1,5 @@ -.\" Automatically generated by Pod::Man version 1.02 -.\" Sat Mar 24 17:29:24 2001 +.\" Automatically generated by Pod::Man version 1.15 +.\" Sun Jan 27 13:33:10 2002 .\" .\" Standard preamble: .\" ====================================================================== @@ -46,8 +46,8 @@ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" -. ds C` ` -. ds C' ' +. ds C` "" +. ds C' "" 'br\} .el\{\ . ds -- \|\(em\| @@ -63,7 +63,7 @@ .if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" -. . +.. . nr % 0 . rr F .\} @@ -138,13 +138,13 @@ .\" ====================================================================== .\" .IX Title "PTH-CONFIG 1" -.TH PTH-CONFIG 1 "24-Mar-2001" "GNU Pth 1.4.0" "GNU Portable Threads" +.TH PTH-CONFIG 1 "27-Jan-2002" "GNU Pth 1.4.1" "GNU Portable Threads" .UC .SH "NAME" \&\fBpth-config\fR \- Pth library build utility .SH "VERSION" .IX Header "VERSION" -\&\s-1GNU\s0 Pth \s-11.4.0 (24-Mar-2001)\s0 +\&\s-1GNU\s0 Pth \s-11.4.1 (27-Jan-2002)\s0 .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBpth-config\fR Index: ossp-pkg/pth/pth.3 RCS File: /v/ossp/cvs/ossp-pkg/pth/Attic/pth.3,v rcsdiff -q -kk '-r1.231' '-r1.232' -u '/v/ossp/cvs/ossp-pkg/pth/Attic/pth.3,v' 2>/dev/null --- pth.3 2001/07/12 07:20:04 1.231 +++ pth.3 2002/01/27 12:34:30 1.232 @@ -1,5 +1,5 @@ .\" Automatically generated by Pod::Man version 1.15 -.\" Thu Jul 12 09:19:00 2001 +.\" Sun Jan 27 13:33:11 2002 .\" .\" Standard preamble: .\" ====================================================================== @@ -138,13 +138,13 @@ .\" ====================================================================== .\" .IX Title "pth 3" -.TH pth 3 "24-Mar-2001" "GNU Pth 1.4.0" "GNU Portable Threads" +.TH pth 3 "27-Jan-2002" "GNU Pth 1.4.1" "GNU Portable Threads" .UC .SH "NAME" \&\fBpth\fR \- \s-1GNU\s0 Portable Threads .SH "VERSION" .IX Header "VERSION" -\&\s-1GNU\s0 Pth \s-11.4.0 (24-Mar-2001)\s0 +\&\s-1GNU\s0 Pth \s-11.4.1 (27-Jan-2002)\s0 .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Ip "\fBGlobal Library Management\fR" 4 @@ -756,9 +756,10 @@ .if n .Ip "\f(CW""""PTH_ATTR_JOINABLE""""\fR (read-write> [\f(CW""""int""""\fR]" 4 .el .Ip "\f(CWPTH_ATTR_JOINABLE\fR (read-write> [\f(CWint\fR]" 4 .IX Item "PTH_ATTR_JOINABLE (read-write> [int]" -The thread detachment type, \f(CW\*(C`TRUE\*(C'\fR indicates a joinable thread, \f(CW\*(C`FALSE\*(C'\fR -indicates a detached thread. When a the is detached after termination it is -immediately kicked out of the system instead of inserted into the dead queue. +The thread detachment type, \f(CW\*(C`TRUE\*(C'\fR indicates a joinable thread, +\&\f(CW\*(C`FALSE\*(C'\fR indicates a detached thread. When a thread is detached, +after termination it is immediately kicked out of the system instead of +inserted into the dead queue. .if n .Ip "\f(CW""""PTH_ATTR_CANCEL_STATE""""\fR (read-write) [\f(CW""""unsigned int""""\fR]" 4 .el .Ip "\f(CWPTH_ATTR_CANCEL_STATE\fR (read-write) [\f(CWunsigned int\fR]" 4 .IX Item "PTH_ATTR_CANCEL_STATE (read-write) [unsigned int]" @@ -1006,21 +1007,23 @@ `\f(CW\*(C`pth_cancel(\*(C'\fR\fItid\fR\f(CW\*(C`)\*(C'\fR'. .Ip "int \fBpth_join\fR(pth_t \fItid\fR, void **\fIvalue\fR);" 4 .IX Item "int pth_join(pth_t tid, void **value);" -This joins the current thread with the thread specified via \fItid\fR. It first -suspends the current thread until the \fItid\fR thread has terminated. Then it is -awakened and stores the value of \fItid\fR's \fIpth_exit\fR\|(3) call into *\fIvalue\fR (if -\&\fIvalue\fR and not \f(CW\*(C`NULL\*(C'\fR) and returns to the caller. A thread can be joined -only when it was \fInot\fR spawned with \f(CW\*(C`PTH_FLAG_NOJOIN\*(C'\fR. A thread can only be -joined once, i.e., after the \fIpth_join\fR\|(3) call the thread \fItid\fR is removed -from the system. +This joins the current thread with the thread specified via \fItid\fR. +It first suspends the current thread until the \fItid\fR thread has +terminated. Then it is awakened and stores the value of \fItid\fR's +\&\fIpth_exit\fR\|(3) call into *\fIvalue\fR (if \fIvalue\fR and not \f(CW\*(C`NULL\*(C'\fR) and +returns to the caller. A thread can be joined only when it has the +attribute \f(CW\*(C`PTH_ATTR_JOINABLE\*(C'\fR set to \f(CW\*(C`TRUE\*(C'\fR (the default). A thread +can only be joined once, i.e., after the \fIpth_join\fR\|(3) call the thread +\&\fItid\fR is completely removed from the system. .Ip "void \fBpth_exit\fR(void *\fIvalue\fR);" 4 .IX Item "void pth_exit(void *value);" -This terminates the current thread. Whether it's immediately removed from the -system or inserted into the dead queue of the scheduler depends on its join -type which was specified at spawning time. When it was spawned with -\&\f(CW\*(C`PTH_FLAG_NOJOIN\*(C'\fR it's immediately removed and \fIvalue\fR is ignored. -Else the thread is inserted into the dead queue and \fIvalue\fR remembered -for a \fIpth_join\fR\|(3) call by another thread. +This terminates the current thread. Whether it's immediately removed +from the system or inserted into the dead queue of the scheduler depends +on its join type which was specified at spawning time. If it has the +attribute \f(CW\*(C`PTH_ATTR_JOINABLE\*(C'\fR set to \f(CW\*(C`FALSE\*(C'\fR, it's immediately removed +and \fIvalue\fR is ignored. Else the thread is inserted into the dead queue +and \fIvalue\fR remembered for a subsequent \fIpth_join\fR\|(3) call by another +thread. .Sh "Utilities" .IX Subsection "Utilities" The following functions are utility functions. @@ -1098,7 +1101,7 @@ .el .Ip "\f(CWPTH_EVENT_FD\fR" 4 .IX Item "PTH_EVENT_FD" This is a file descriptor event. One or more of \f(CW\*(C`PTH_UNTIL_FD_READABLE\*(C'\fR, -\&\f(CW\*(C`PTH_UNTIL_FD_WRITEABLE\*(C'\fR or \f(CW\*(C`PTH_UNTIL_FD_EXECPTION\*(C'\fR have to be OR-ed into +\&\f(CW\*(C`PTH_UNTIL_FD_WRITEABLE\*(C'\fR or \f(CW\*(C`PTH_UNTIL_FD_EXCEPTION\*(C'\fR have to be OR-ed into \&\fIspec\fR to specify on which state of the file descriptor you want to wait. The file descriptor itself has to be given as an additional argument. Example: `\f(CW\*(C`pth_event(PTH_EVENT_FD|PTH_UNTIL_FD_READABLE, fd)\*(C'\fR'. @@ -1821,9 +1824,8 @@ \& | rm -f Makefile .Ve Because \fBautoconf\fR generates additional files, we added a canonical -\&\f(CW\*(C`distclean\*(C'\fR target which cleanups this, too. Second, we write -a (minimalistic) \fBautoconf\fR script specification in a file -\&\f(CW\*(C`configure.in\*(C'\fR: +\&\f(CW\*(C`distclean\*(C'\fR target which cleans this up. Secondly, we wrote +\&\f(CW\*(C`configure.in\*(C'\fR, a (minimal) \fBautoconf\fR script specification: .PP .Vb 4 \& $ vi configure.in @@ -1881,8 +1883,8 @@ .IX Subsection "Autoconf Build Environment with Local Copy of Pth (Expert)" Finally let us assume the \f(CW\*(C`foo\*(C'\fR program stays under either a \fI\s-1GPL\s0\fR or \&\fI\s-1LGPL\s0\fR distribution license and we want to make it a stand-alone package for -easier distribution and installation. That is, we don't want that the -end-user first has to install \fBPth\fR just to allow our \f(CW\*(C`foo\*(C'\fR package to +easier distribution and installation. That is, we don't want to oblige the +end-user to install \fBPth\fR just to allow our \f(CW\*(C`foo\*(C'\fR package to compile. For this, it is a convenient practice to include the required libraries (here \fBPth\fR) into the source tree of the package (here \f(CW\*(C`foo\*(C'\fR). \&\fBPth\fR ships with all necessary support to allow us to easily achieve this Index: ossp-pkg/pth/pth.spec RCS File: /v/ossp/cvs/ossp-pkg/pth/pth.spec,v rcsdiff -q -kk '-r1.7' '-r1.8' -u '/v/ossp/cvs/ossp-pkg/pth/pth.spec,v' 2>/dev/null --- pth.spec 2002/01/27 11:03:40 1.7 +++ pth.spec 2002/01/27 12:34:30 1.8 @@ -30,7 +30,7 @@ # distribution tarball. %define prefix /usr -%define ver 1.4.0 +%define ver 1.4.1 %define rel 1 Name: pth Index: ossp-pkg/pth/pth_vers.c RCS File: /v/ossp/cvs/ossp-pkg/pth/pth_vers.c,v rcsdiff -q -kk '-r1.138' '-r1.139' -u '/v/ossp/cvs/ossp-pkg/pth/pth_vers.c,v' 2>/dev/null --- pth_vers.c 2001/03/24 16:30:36 1.138 +++ pth_vers.c 2002/01/27 12:34:30 1.139 @@ -8,7 +8,7 @@ #ifndef _PTH_VERS_C_ #define _PTH_VERS_C_ -#define PTH_INTERNAL_VERSION 0x104200 +#define PTH_INTERNAL_VERSION 0x104201 typedef struct { const int v_hex; @@ -32,13 +32,13 @@ #undef _PTH_VERS_C_AS_HEADER_ pth_internal_version_t pth_internal_version = { - 0x104200, - "1.4.0", - "1.4.0 (24-Mar-2001)", - "This is GNU Pth, Version 1.4.0 (24-Mar-2001)", - "GNU Pth 1.4.0 (24-Mar-2001)", - "GNU Pth/1.4.0", - "@(#)GNU Pth 1.4.0 (24-Mar-2001)", + 0x104201, + "1.4.1", + "1.4.1 (27-Jan-2002)", + "This is GNU Pth, Version 1.4.1 (27-Jan-2002)", + "GNU Pth 1.4.1 (27-Jan-2002)", + "GNU Pth/1.4.1", + "@(#)GNU Pth 1.4.1 (27-Jan-2002)", "$Id$" }; Index: ossp-pkg/pth/pthread-config.1 RCS File: /v/ossp/cvs/ossp-pkg/pth/Attic/pthread-config.1,v rcsdiff -q -kk '-r1.96' '-r1.97' -u '/v/ossp/cvs/ossp-pkg/pth/Attic/pthread-config.1,v' 2>/dev/null --- pthread-config.1 2001/03/24 16:30:36 1.96 +++ pthread-config.1 2002/01/27 12:34:30 1.97 @@ -1,5 +1,5 @@ -.\" Automatically generated by Pod::Man version 1.02 -.\" Sat Mar 24 17:29:28 2001 +.\" Automatically generated by Pod::Man version 1.15 +.\" Sun Jan 27 13:33:12 2002 .\" .\" Standard preamble: .\" ====================================================================== @@ -46,8 +46,8 @@ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" -. ds C` ` -. ds C' ' +. ds C` "" +. ds C' "" 'br\} .el\{\ . ds -- \|\(em\| @@ -63,7 +63,7 @@ .if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" -. . +.. . nr % 0 . rr F .\} @@ -138,13 +138,13 @@ .\" ====================================================================== .\" .IX Title "PTHREAD-CONFIG 1" -.TH PTHREAD-CONFIG 1 "24-Mar-2001" "GNU Pth 1.4.0" "POSIX Threading API of GNU Pth" +.TH PTHREAD-CONFIG 1 "27-Jan-2002" "GNU Pth 1.4.1" "POSIX Threading API of GNU Pth" .UC .SH "NAME" \&\fBpthread-config\fR \- Pth pthread library build utility .SH "VERSION" .IX Header "VERSION" -\&\s-1GNU\s0 Pth \s-11.4.0 (24-Mar-2001)\s0 +\&\s-1GNU\s0 Pth \s-11.4.1 (27-Jan-2002)\s0 .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBpthread-config\fR Index: ossp-pkg/pth/pthread.3 RCS File: /v/ossp/cvs/ossp-pkg/pth/Attic/pthread.3,v rcsdiff -q -kk '-r1.101' '-r1.102' -u '/v/ossp/cvs/ossp-pkg/pth/Attic/pthread.3,v' 2>/dev/null --- pthread.3 2001/03/24 16:30:36 1.101 +++ pthread.3 2002/01/27 12:34:30 1.102 @@ -1,5 +1,5 @@ -.\" Automatically generated by Pod::Man version 1.02 -.\" Sat Mar 24 17:29:29 2001 +.\" Automatically generated by Pod::Man version 1.15 +.\" Sun Jan 27 13:33:12 2002 .\" .\" Standard preamble: .\" ====================================================================== @@ -46,8 +46,8 @@ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" -. ds C` ` -. ds C' ' +. ds C` "" +. ds C' "" 'br\} .el\{\ . ds -- \|\(em\| @@ -63,7 +63,7 @@ .if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" -. . +.. . nr % 0 . rr F .\} @@ -138,13 +138,13 @@ .\" ====================================================================== .\" .IX Title "pthread 3" -.TH pthread 3 "24-Mar-2001" "GNU Pth 1.4.0" "POSIX Threading API of GNU Pth" +.TH pthread 3 "27-Jan-2002" "GNU Pth 1.4.1" "POSIX Threading API of GNU Pth" .UC .SH "NAME" \&\fBpthread\fR \- \s-1POSIX\s0.1c Threading \s-1API\s0 of \s-1GNU\s0 Pth .SH "VERSION" .IX Header "VERSION" -\&\s-1GNU\s0 Pth \s-11.4.0 (24-Mar-2001)\s0 +\&\s-1GNU\s0 Pth \s-11.4.1 (27-Jan-2002)\s0 .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBApplication Makefiles:\fR