X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/1933e12cd0d32c774bd7f483285802de52dc8cbc..c2d2fdd09b649a6c5691b462909152208167f3e6:/README.os2 diff --git a/README.os2 b/README.os2 index 05c088a..359fc84 100644 --- a/README.os2 +++ b/README.os2 @@ -151,7 +151,7 @@ versions of EMX. =item * -You need a separate perl executable F (see L) +You need a separate perl executable F (see L) if you want to use PM code in your application (as Perl/Tk or OpenGL Perl modules do) without having a text-mode window present. @@ -162,7 +162,7 @@ Using F avoids such a degradation. =item * There is no simple way to access WPS objects. The only way I know -is via C and C extensions (see L, L). +is via C and C extensions (see L, L). However, we do not have access to convenience methods of Object-REXX. (Is it possible at all? I know of no Object-REXX API.) The C extension (currently in alpha-text) @@ -186,7 +186,7 @@ Note that not all features of Perl are available under these environments. This depends on the features the I - most probably RSX - decided to implement. -Cf. L. +Cf. L. =head2 Prerequisites @@ -208,9 +208,8 @@ under earlier versions of EMX, but this is not tested. One can get different parts of EMX from, say - http://www.leo.org/pub/comp/os/os2/leo/gnu/emx+gcc/ - http://powerusersbbs.com/pub/os2/dev/ [EMX+GCC Development] - http://hobbes.nmsu.edu/pub/os2/dev/emx/v0.9d/ + ftp://crydee.sai.msu.ru/pub/comp/os/os2/leo/gnu/emx+gcc/ + http://hobbes.nmsu.edu/h-browse.php?dir=/pub/os2/dev/emx/v0.9d/ The runtime component should have the name F. @@ -235,9 +234,8 @@ can have Perl development environment under DOS. One can get RSX from, say - ftp://ftp.cdrom.com/pub/os2/emx09c/contrib - ftp://ftp.uni-bielefeld.de/pub/systems/msdos/misc - ftp://ftp.leo.org/pub/comp/os/os2/leo/devtools/emx+gcc/contrib + http://cd.textfiles.com/hobbesos29804/disk1/EMX09C/ + ftp://crydee.sai.msu.ru/pub/comp/os/os2/leo/gnu/emx+gcc/contrib/ Contact the author on C. @@ -266,7 +264,7 @@ either in the wired-in-during-compile locations (usually F), or in configurable location (see L<"PERL_SH_DIR">). For best results use EMX pdksh. The standard binary (5.2.14 or later) runs -under DOS (with L) as well, see +under DOS (with L) as well, see http://www.ilyaz.org/software/os2/ @@ -317,7 +315,7 @@ or whatever method you prefer. There are also endless possibilities to use I of 4os2, I of WPS and so on... However, if you use *nixish shell (like F supplied in the binary distribution), -you need to follow the syntax specified in L. +you need to follow the syntax specified in L. Note that B<-S> switch supports scripts with additional extensions F<.cmd>, F<.btm>, F<.bat>, F<.pl> as well. @@ -437,7 +435,7 @@ managed to goof. C<;-)> =item * Did you run your programs with C<-w> switch? See -L. +L2 (and DOS) programs under Perl>. =item * @@ -477,10 +475,10 @@ should be done "correctly". =head2 C<``> and pipe-C do not work under DOS. This may a variant of just L<"I cannot run external programs">, or a -deeper problem. Basically: you I RSX (see L<"Prerequisites">) +deeper problem. Basically: you I RSX (see L) for these commands to work, and you may need a port of F which understands command arguments. One of such ports is listed in -L<"Prerequisites"> under RSX. Do not forget to set variable +L under RSX. Do not forget to set variable C> as well. DPMI is required for RSX. @@ -489,7 +487,7 @@ DPMI is required for RSX. The whole idea of the "standard C API to start applications" is that the forms C and C<"foo"> of program arguments are completely -interchangable. F breaks this paradigm; +interchangeable. F breaks this paradigm; find "pattern" file find pattern file @@ -559,7 +557,7 @@ of this file. B. Because of a typo the binary installer of 5.00305 would install a variable C into F. Please -remove this variable and put C> instead. +remove this variable and put C> instead. =head2 Manual binary installation @@ -620,7 +618,7 @@ C in F, see L<"PERLLIB_PREFIX">. =item Additional Perl modules - unzip perl_ste.zip -d f:/perllib/lib/site_perl/5.8.3/ + unzip perl_ste.zip -d f:/perllib/lib/site_perl/5.15.0/ Same remark as above applies. Additionally, if this directory is not one of directories on @INC (and @INC is influenced by C), you @@ -799,8 +797,7 @@ can be constructed using C. =head1 BUILD -Here we discuss how to build Perl under OS/2. There is an alternative -(but maybe older) view on L. +Here we discuss how to build Perl under OS/2. =head2 The short story @@ -846,10 +843,11 @@ optionally - Berkeley DB headers and libraries, and crypt. Possible locations to get the files: - ftp://hobbes.nmsu.edu/os2/unix/ - ftp://ftp.cdrom.com/pub/os2/unix/ - ftp://ftp.cdrom.com/pub/os2/dev32/ - ftp://ftp.cdrom.com/pub/os2/emx09c/ + + ftp://ftp.uni-heidelberg.de/pub/os2/unix/ + http://hobbes.nmsu.edu/h-browse.php?dir=/pub/os2 + http://cd.textfiles.com/hobbesos29804/disk1/DEV32/ + http://cd.textfiles.com/hobbesos29804/disk1/EMX09C/ It is reported that the following archives contain enough utils to build perl: F, F, F, F, @@ -857,7 +855,7 @@ F, F, F, F, F an F (or a later version). Note that all these utilities are known to be available from LEO: - ftp://ftp.leo.org/pub/comp/os/os2/leo/gnu + ftp://crydee.sai.msu.ru/pub/comp/os/os2/leo/gnu/ Note also that the F and F from the EMX distribution are not suitable for multi-threaded compile (even single-threaded @@ -901,8 +899,8 @@ link386 prompts, press C to exit. You need to fetch the latest perl source (including developers releases). With some probability it is located in - http://www.cpan.org/src/5.0 - http://www.cpan.org/src/5.0/unsupported + http://www.cpan.org/src/ + http://www.cpan.org/src/unsupported If not, you may need to dig in the indices to find it in the directory of the current maintainer. @@ -1063,7 +1061,7 @@ Run to convert perl utilities to F<.cmd> files and put them on PATH. You need to put F<.EXE>-utilities on path manually. They are installed in C<$prefix/bin>, here C<$prefix> is what you gave to -F, see L. +F, see L. If you use C, either move the installed F<*/man/> directories to your C, or modify C to match the location. (One @@ -1266,7 +1264,7 @@ redirect the new version of Perl to a new location, and copy the installed files to this new location. Redo the tests to make sure that the versions of modules inherited from older versions of Perl are not needed. -Actually, the log output of L during the step 6 gives a very detailed +Actually, the log output of L during the step 6 gives a very detailed info about which modules are loaded from which place; so you may use it as an additional verification tool. @@ -1501,7 +1499,7 @@ Here is the sample C file: { main_t f; handler_t h; - + me = argv[0]; /**/ handle = load_perl_dll(PERL_DLL_BASENAME); @@ -1523,11 +1521,11 @@ Here is the sample C file: =head2 Some C became C<\> in pdksh. -You have a very old pdksh. See L. +You have a very old pdksh. See L. =head2 C<'errno'> - unresolved external -You do not have MT-safe F. See L. +You do not have MT-safe F. See L. =head2 Problems with tr or sed @@ -1540,11 +1538,11 @@ broke the build of extensions. =head2 Library ... not found -You did not run C. See L. +You did not run C. See L. =head2 Segfault in make -You use an old version of GNU make. See L. +You use an old version of GNU make. See L. =head2 op/sprintf test failure @@ -1651,7 +1649,7 @@ leaves drive as it is. =item C -chanes the "current" drive. +changes the "current" drive. =item C @@ -1898,7 +1896,7 @@ _DLLInitTerm() (e.g., F). This means that even if you do not I any function in the DLL, just the act of loading this DLL will reset your flags. What is worse, the same compiler was used to compile some HOOK DLLs. Given that HOOK dlls are executed in the context of I the applications -in the system, this means a complete unpredictablity of floating point +in the system, this means a complete unpredictability of floating point flags on systems using such HOOK DLLs. E.g., F of B origin changes the floating point flags on each write to the TTY of a VIO (windowed text-mode) applications. @@ -2027,7 +2025,7 @@ WM_QUIT, and which did not process the received WM_QUIT message, the shutdown will be automatically cancelled. Do not call C unless you are going to process messages on an orderly basis. -=item * Treating errors reported by OS/2 API +=item Treating errors reported by OS/2 API There are two principal conventions (it is useful to call them C and C - though this part of the function signature is not always @@ -2104,7 +2102,7 @@ Sets C to C, and sets $^E to the corresponding value. =back -=item * Loading DLLs and ordinals in DLLs +=item Loading DLLs and ordinals in DLLs Some DLLs are only present in some versions of OS/2, or in some configurations of OS/2. Some exported entry points are present only @@ -2205,7 +2203,7 @@ in the I behaviour. One can start I executable in I kind of session by using the arguments C, C or C switches of the command C (of F or a similar shell). Alternatively, one can use the numeric first argument of the -C Perl function (see L>). +C Perl function (see L). =head2 F @@ -2219,7 +2217,7 @@ It is a VIO application. =head2 Why strange names? Since Perl processes the C<#!>-line (cf. -L, L, +L, L, L, L), it should know when a program I. There is some naming convention which allows @@ -2550,8 +2548,9 @@ it has the same effect.) B. C, C and C are not environment variables, although F emulates them on C lines. From Perl they may be accessed by L and -L. +...> lines. From Perl they may be accessed by +L and +L. =head2 DLL forwarder generation @@ -2606,7 +2605,7 @@ are F and F. Having perl build itself would be impossible with F as a shell, thus I picked up C. This assures almost 100% compatibility with the scripts coming from *nix. As an added benefit this works as well under DOS if you use DOS-enabled port of pdksh -(see L<"Prerequisites">). +(see L). B currently F of pdksh calls external programs via fork()/exec(), and there is I functioning exec() on @@ -2639,7 +2638,7 @@ I will include it into distribution. I have no need for such a module, so cannot test it. For the details of the current situation with calling external programs, -see L. Set us mention a couple +see L2 (and DOS) programs under Perl>. Set us mention a couple of features: =over 4 @@ -2701,7 +2700,7 @@ have a low probability of affecting small programs. =head1 BUGS This description is not updated often (since 5.6.1?), see F<./os2/Changes> -(L) for more info. +for more info. =cut