diff options
Diffstat (limited to 'Porting')
| -rw-r--r-- | Porting/Glossary | 17 | ||||
| -rw-r--r-- | Porting/config.sh | 20 | ||||
| -rw-r--r-- | Porting/config_H | 47 | ||||
| -rw-r--r-- | Porting/patching.pod | 35 |
4 files changed, 97 insertions, 22 deletions
diff --git a/Porting/Glossary b/Porting/Glossary index 15ca4f9050..8e7514e10a 100644 --- a/Porting/Glossary +++ b/Porting/Glossary @@ -540,6 +540,11 @@ d_killpg (d_killpg.U): indicates to the C program that the killpg() routine is available to kill process groups. +d_lchown (d_lchown.U): + This variable conditionally defines the HAS_LCHOWN symbol, which + indicates to the C program that the lchown() routine is available + to operate on a symbolic link (instead of following the link). + d_link (d_link.U): This variable conditionally defines HAS_LINK if link() is available to create hard links. @@ -787,6 +792,14 @@ d_semctl (d_semctl.U): This variable conditionally defines the HAS_SEMCTL symbol, which indicates to the C program that the semctl() routine is available. +d_semctl_semid_ds (d_union_senum.U): + This variable conditionally defines USE_SEMCTL_SEMID_DS, which + indicates that struct semid_ds * is to be used for semctl IPC_STAT. + +d_semctl_semun (d_union_senum.U): + This variable conditionally defines USE_SEMCTL_SEMUN, which + indicates that union semun is to be used for semctl IPC_STAT. + d_semget (d_semget.U): This variable conditionally defines the HAS_SEMGET symbol, which indicates to the C program that the semget() routine is available. @@ -1074,6 +1087,10 @@ d_uname (d_gethname.U): indicates to the C program that the uname() routine may be used to derive the host name. +d_union_semun (d_union_senum.U): + This variable conditionally defines HAS_UNION_SEMUN if the + union semun is defined by including <sys/sem.h>. + d_vfork (d_vfork.U): This variable conditionally defines the HAS_VFORK symbol, which indicates the vfork() routine is available. diff --git a/Porting/config.sh b/Porting/config.sh index 69da4a96b0..5a417ae2f0 100644 --- a/Porting/config.sh +++ b/Porting/config.sh @@ -8,7 +8,7 @@ # Package name : perl5 # Source directory : . -# Configuration time: Wed May 13 13:36:52 EDT 1998 +# Configuration time: Thu May 28 12:44:36 EDT 1998 # Configured by : doughera # Target system : linux fractal 2.0.33 #1 tue feb 3 10:11:46 est 1998 i686 unknown @@ -31,8 +31,8 @@ alignbytes='4' ansi2knr='' aphostname='' ar='ar' -archlib='/opt/perl/lib/i686-linux-thread/5.00464' -archlibexp='/opt/perl/lib/i686-linux-thread/5.00464' +archlib='/opt/perl/lib/i686-linux-thread/5.00465' +archlibexp='/opt/perl/lib/i686-linux-thread/5.00465' archname='i686-linux-thread' archobjs='' awk='awk' @@ -52,7 +52,7 @@ ccdlflags='-rdynamic' ccflags='-D_REENTRANT -Dbool=char -DHAS_BOOL -I/usr/local/include' cf_by='doughera' cf_email='yourname@yourhost.yourplace.com' -cf_time='Wed May 13 13:36:52 EDT 1998' +cf_time='Thu May 28 12:44:36 EDT 1998' chgrp='' chmod='' chown='' @@ -151,6 +151,7 @@ d_index='undef' d_inetaton='define' d_isascii='define' d_killpg='define' +d_lchown='undef' d_link='define' d_locconv='define' d_lockf='define' @@ -206,6 +207,8 @@ d_seekdir='define' d_select='define' d_sem='define' d_semctl='define' +d_semctl_semid_ds='define' +d_semctl_semun='define' d_semget='define' d_semop='define' d_setegid='define' @@ -270,6 +273,7 @@ d_truncate='define' d_tzname='define' d_umask='define' d_uname='define' +d_union_semun='define' d_vfork='undef' d_void_closedir='undef' d_voidsig='define' @@ -372,7 +376,7 @@ i_varhdr='stdarg.h' i_vfork='undef' incpath='' inews='' -installarchlib='/opt/perl/lib/i686-linux-thread/5.00464' +installarchlib='/opt/perl/lib/i686-linux-thread/5.00465' installbin='/opt/perl/bin' installman1dir='/opt/perl/man/man1' installman3dir='/opt/perl/man/man3' @@ -392,7 +396,7 @@ lib_ext='.a' libc='' libperl='libperl.a' libpth='/usr/local/lib /lib /usr/lib' -libs='-lnsl -lndbm -lgdbm -ldbm -ldb -ldl -lm -lpthread -lc -lposix -lcrypt' +libs='-lnsl -lgdbm -ldbm -ldb -ldl -lm -lpthread -lc -lposix -lcrypt' libswanted='sfio socket inet nsl nm ndbm gdbm dbm db malloc dl dld ld sun m pthread c cposix posix ndir dir crypt ucb BSD PW x' line='line' lint='' @@ -518,7 +522,7 @@ stdio_filbuf='' stdio_ptr='((fp)->_IO_read_ptr)' strings='/usr/include/string.h' submit='' -subversion='64' +subversion='65' sysman='/usr/man/man1' tail='' tar='' @@ -551,5 +555,5 @@ xlibpth='/usr/lib/386 /lib/386' zcat='' zip='zip' PATCHLEVEL=4 -SUBVERSION=64 +SUBVERSION=65 CONFIG=true diff --git a/Porting/config_H b/Porting/config_H index de0cfd6684..0b1de0855f 100644 --- a/Porting/config_H +++ b/Porting/config_H @@ -17,7 +17,7 @@ /* * Package name : perl5 * Source directory : . - * Configuration time: Wed May 13 13:36:52 EDT 1998 + * Configuration time: Thu May 28 12:44:36 EDT 1998 * Configured by : doughera * Target system : linux fractal 2.0.33 #1 tue feb 3 10:11:46 est 1998 i686 unknown */ @@ -982,6 +982,12 @@ */ #define I_SYS_TIMES /**/ +/* I_SYS_TYPES: + * This symbol, if defined, indicates to the C program that it should + * include <sys/types.h>. + */ +#define I_SYS_TYPES /**/ + /* I_SYS_UN: * This symbol, if defined, indicates to the C program that it should * include <sys/un.h> to get UNIX domain socket definitions. @@ -1213,6 +1219,13 @@ */ #define HAS_ISASCII /**/ +/* HAS_LCHOWN: + * This symbol, if defined, indicates that the lchown routine is + * available to operate on a symbolic link (instead of following the + * link). + */ +/*#define HAS_LCHOWN / **/ + /* HAS_OPEN3: * This manifest constant lets the C program know that the three * argument form of open(2) is available. @@ -1454,8 +1467,8 @@ * This symbol contains the ~name expanded version of ARCHLIB, to be used * in programs that are not prepared to deal with ~ expansion at run-time. */ -#define ARCHLIB "/opt/perl/lib/i686-linux-thread/5.00464" /**/ -#define ARCHLIB_EXP "/opt/perl/lib/i686-linux-thread/5.00464" /**/ +#define ARCHLIB "/opt/perl/lib/i686-linux-thread/5.00465" /**/ +#define ARCHLIB_EXP "/opt/perl/lib/i686-linux-thread/5.00465" /**/ /* CAT2: * This macro catenates 2 tokens together. @@ -1662,6 +1675,28 @@ #define HAS_SOCKET /**/ #define HAS_SOCKETPAIR /**/ +/* HAS_UNION_SEMUN: + * This symbol, if defined, indicates that the union semun is + * defined by including <sys/sem.h>. If not, the user code + * probably needs to define it as: + * union semun { + * int val; + * struct semid_ds *buf; + * unsigned short *array; + * } + */ +/* USE_SEMCTL_SEMUN: + * This symbol, if defined, indicates that union semun is + * used for semctl IPC_STAT. + */ +/* USE_SEMCTL_SEMID_DS: + * This symbol, if defined, indicates that struct semid_ds * is + * used for semctl IPC_STAT. + */ +#define HAS_UNION_SEMUN /**/ +#define USE_SEMCTL_SEMUN /**/ +#define USE_SEMCTL_SEMID_DS /**/ + /* Signal_t: * This symbol's value is either "void" or "int", corresponding to the * appropriate return type of a signal handler. Thus, you can declare @@ -1730,12 +1765,6 @@ /*#define PWCOMMENT / **/ #define PWGECOS /**/ -/* I_SYS_TYPES: - * This symbol, if defined, indicates to the C program that it should - * include <sys/types.h>. - */ -#define I_SYS_TYPES /**/ - /* PRIVLIB: * This symbol contains the name of the private library for this package. * The library is private in the sense that it needn't be in anyone's diff --git a/Porting/patching.pod b/Porting/patching.pod index b2a86b6f34..b528ad7080 100644 --- a/Porting/patching.pod +++ b/Porting/patching.pod @@ -2,10 +2,10 @@ patching.pod - Appropriate format for patches to the perl source tree -=head2re to get this document +=head2 Where to get this document The latest version of this document is available from - http://www.tdrenterprises.com/perl/perlpatch.html + http://perrin.dimensional.com/perl/perlpatch.html =head2 How to contribute to this document @@ -130,8 +130,33 @@ block of code that you are patching. =item Testsuite -Also please include an addition to the regression tests to properly -exercise your patch. +When submitting a patch you should make every effort to also include +an addition to perl's regression tests to properly exercise your +patch. Your testsuite additions should generally follow these +guidelines (courtesy of Gurusamy Sarathy (gsar@engin.umich.edu))- + + Know what you're testing. Read the docs, and the source. + Tend to fail, not succeed. + Interpret results strictly. + Use unrelated features (this will flush out bizarre interactions). + Use non-standard idioms (otherwise you are not testing TIMTOWTDI). + Avoid using hardcoded test umbers whenever possible (the EXPECTED/GOT style + found in t/op/tie.t is much more maintainable, and gives better failure + reports). + Give meaningful error messages when a test fails. + Avoid using qx// and system() unless you are testing for them. If you + do use them, make sure that you cover _all_ perl platforms. + Unlink any temporary files you create. + Promote unforeseen warnings to errors with $SIG{__WARN__}. + Be sure to use the libraries and modules shipped with version being tested, + not those that were already installed. + Add comments to the code explaining what you are testing for. + Make updating the '1..42' string unnecessary. Or make sure that you update it. + Test _all_ behaviors of a given operator, library, or function- + All optional arguments + Return values in various contexts (boolean, scalar, list, lvalue) + Use both global and lexical variables + Don't forget the exceptional, pathological cases. =back @@ -261,7 +286,7 @@ mind. 8-) =head1 Last Modified -Last modified 1 May 1998 by Daniel Grisinger <dgris@tdrenterprises.com> +Last modified 21 May 1998 by Daniel Grisinger <dgris@perrin.dimensional.com> =head1 Author and Copyright Information |