summaryrefslogtreecommitdiff
path: root/pod/perlembed.pod
Commit message (Collapse)AuthorAgeFilesLines
* replace all instances of PERL_IMPLICIT_CONTEXT with MULTIPLICITYTomasz Konojacki2021-06-091-1/+1
| | | | | | | | | | | | Since the removal of PERL_OBJECT (acfe0abcedaf592fb4b9cb69ce3468308ae99d91) PERL_IMPLICIT_CONTEXT and MULTIPLICITY have been synonymous and they're being used interchangeably. To simplify the code, this commit replaces all instances of PERL_IMPLICIT_CONTEXT with MULTIPLICITY. PERL_IMPLICIT_CONTEXT will stay defined for compatibility with XS modules.
* Fix broken ExtUtils::Embed URLMax Maischein2019-10-111-1/+1
| | | | | | | | This only fixes the link. Maybe the whole paragraph should be removed, as 5.004 is now almost 20 years in the past and ExtUtils::Embed has been in core for all that time. This is out of scope for this series of commits.
* Add thread-safe locale handlingKarl Williamson2018-02-181-0/+5
| | | | | | This (large) commit allows locales to be used in threaded perls on platforms that support it. This includes recent Windows and Posix 2008 ones.
* perlembed: Fix typosKarl Williamson2018-01-301-2/+2
| | | | | Perl is capitalized when referring to the language; lowercased when referring to a particular executable.
* (perl #131878) don't call croak() with a potential format stringTony Cook2018-01-181-1/+1
| | | | | Since this has security implications, explain the change in perldelta.
* properly define perl_parse() return valueZefram2017-12-101-13/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | perl_parse()'s return value has historically had conflicting purposes. perlmain.c uses it as a truth value, but perlembed.pod has shown it being used as an exit code. perl_parse() has not had its own documentation. What the function has actually done is to return zero for normal completion and an exit code for early termination. For this to be a usable convention depended on early termination never using exit code 0, and that's specifically *native* exit code 0, which could have any significance. In fact exit code 0 could arise for a compile-time termination even on Unix through "CHECK { exit 0 }", and the mishandling of that situation was bug [perl #2754]. Since perl_destruct() provides a native exit code unencumbered by any attempt to simultaneously be a truth value, perl_parse() doesn't really need to provide an exit code. So define that perl_parse()'s return value is principally a truth value. Change the perlembed tutorial to show it being so used, with an exit code coming from perl_destruct(). However, most of the historical usage of perl_parse()'s return value as an exit code can be preserved. Make it return 0x100 for exit(0), which both serves as the essential truth value and on Unix also serves as the proper exit code, because that set bit will be masked off when actually exiting. This works on Unix but will have variable effect on other OSes; at least it will reliably indicate an actual exit. perl_run() has a similar problem in the interpretation of its return value, but not affecting the main perl executable, because perlmain.c ignores its return value. Similarly define that it is principally a truth value, with preserved usage of non-zero return values as exit codes, with exit code 0 transformed into 0x100. This requires some extra logic to distinguish between local completion and exit(0), which were not previously distinguished. Fully document perl_parse(), perl_run(), and perl_destruct() as API functions. Make the perlembed tutorial always show a proper exit from main(), using "exit(EXIT_SUCCESS)" for portability when errors are not being checked. Make perlembed always show a null argv[argc] being supplied to perl_parse(), where an argv is constructed. (Commit 54c85bb058e15520a2fc0ba34007743aae56be34 added a note to perlembed saying that that's required, but didn't fix the examples to show it being done.)
* Don't attempt to define or use STANDARD_CAaron Crane2017-10-211-1/+1
| | | | We rely on a C89 implementation anyway.
* pods: Add L<> for links missing them; a couple nitsKarl Williamson2017-04-051-2/+2
|
* clarify the contents of argv[]Stefan Seifert2016-11-091-0/+3
|
* pod/*: remove deprecated L<"section"> and L<section> syntaxLukas Mai2016-06-111-2/+2
|
* Add parameters to "use locale"Karl Williamson2014-06-051-1/+1
| | | | | | | This commit allows one to specify to enable locale-awareness for only a specified subset of the locale categories. Thus you could make a section of code LC_MESSAGES aware, with no locale-awareness for the other categories.
* Fixed 27 issues in perlembed.pod reported by podcheckGideon Israel Dsouza2013-10-051-110/+123
| | | | | | | | | | Fixed mostly lines exceeding 80 characters by decreasing leading space in verbatim lines to one space. Also fixed long code lines with a slash and line break. Add Gideon Israel Dsouza to list of Perl authors. For: RT #120093
* Use SSize_t for arraysFather Chrysostomos2013-08-251-5/+5
| | | | | | | | | | Make the array interface 64-bit safe by using SSize_t instead of I32 for array indices. This is based on a patch by Chip Salzenberg. This completes what the previous commit began when it changed av_extend.
* locale documentation: Grammaar and appearance nitsKarl Williamson2013-07-091-1/+1
|
* PATCH: [perl #38193] embedded perl always calls setlocale(LC_ALL,"")Karl Williamson2013-07-091-0/+19
| | | | | | | | | | | | | | | | | | This commit causes the locale initialization to skip calling setlocal(foo, "") if the environment variable PERL_SKIP_LOCALE_INIT is set. Instead, the setup code calls setlocale(LC_ALL, NULL) (plus other similar calls for the subcategories) in order to find out what the current locale is. The original poster for this ticket has a workaround for it which involves using a modified copy of Perl core code. This patch defines the C preprocessor variable HAS_SKIP_LOCALE_INIT that can be used by XS writers to discover if the current Perl version needs the workaround or not. I was unable to come up with a test for this patch that did not involve building extensive infrastructure for testing embedded Perl. That does not seem worth it for such a trivial patch. I tested by hand.
* Change pods to not refer to av_len()Karl Williamson2013-02-081-1/+1
| | | | This name for the function is misleading; don't encourage its use.
* [perl #96000] Apply standard copyright license statementDominic Hargreaves2011-08-201-15/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The original authors have agreed to alter the licensing of these files, in order to remove a potentially problematic invariant title clause: From: Doug MacEachern <dougm@…..com> To: Jon Orwant <orwant@….com> Cc: Jesse Vincent <jesse@fsck.com> Subject: Re: [fwd] [perl #96000] Restrictive licensing term on pod/perlembed.pod, pod/perlmodinstall.pod Message-ID: <1dc71b53-12e2-45d3-af62-f6d169147921@ox.local> In-Reply-To: <CAJs5hDaW+k6mf_NBj-6hPyr4rGvkEjhVtXyJ8ziLXyXimcvgHA@mail.gmail.com> Any license changes to perlembed.pod are fine with me. Or just revert to the original version of the document: "Look at perlmain.c, and do something like that." ;) Best, -Doug ----- Original Message ----- > From: "Jon Orwant" <orwant@….com> > To: "Jesse Vincent" <jesse@fsck.com> > Cc: dougm@….com > Sent: Sunday, July 31, 2011 7:38:49 PM > Subject: Re: [fwd] [perl #96000] Restrictive licensing term on pod/perlembed.pod, pod/perlmodinstall.pod > > Sure, happy to relicense. > > > Jon > > > On Sun, Jul 31, 2011 at 4:03 PM, Jesse Vincent < jesse@fsck.com > > wrote: > > > Hi Doug & Jon, > > I know it's been forever since you last touched the perl core- > > It looks like the Debian folks would like us to relax the licensing > terms on docs that bear your copyrights. > > Would you be willing to relicense the contributions you made to the > two > documents listed below under the same terms as the rest of Perl? > > Thanks! > Jesse > --
* genmake mention from perlembed.pod is bogusVadim Konovalov2011-02-211-28/+0
| | | | | | | it appears that chunk of explanations in perlembed.pod is repeating some facts that already present in README.win32, yet they are now old and mostly questionable: no special care should be taken on Win32 nowadays.
* Fix bad pod links found by Test::Pod::LinkCheckApocalypse2011-02-151-2/+2
|
* We're going to embed two interpreters, not fourFlorian Ragwitz2010-09-221-1/+0
|
* don't use $[ in library codeZefram2010-04-271-1/+1
| | | | | | | Remove all uses of $[, both reads and writes, from library code. Test code (which must test behaviour of $[) is unchanged, as is the actual implementation of $[. Uses in CPAN libraries are also untouched: I've opened tickets at rt.cpan.org regarding them.
* PATCH: minor typo cleanup of pod/ directoryTom Christiansen2010-01-051-1/+1
| | | | | | | | | | | | | | These are all in the pod/ directory, and only the first is a code fix. There was also a single lingering ISO 8859-1 encoding that missed the UTF-8 upconvert. The rest are cleanups for typos, some of which seem to have been around for a rather long time: spelling errors, incorrect possessives, and extra, missing, or duplicated words. If you actually read through, I bet you'll realize what sparked this. :) --tom Signed-off-by: Abigail <abigail@abigail.be>
* Clarify PERL_SYS_INIT3() usage.Niko Tyni2009-04-201-0/+4
| | | | | | As seen in [perl #64326] and <http://bugs.debian.org/522099>, the PERL_SYS_INIT3() documentation in perlembed.pod could be clearer about the macro arguments.
* document PERL_SYS_INIT, PERL_SYS_TERM and that they should only be used onceDavid Mitchell2009-04-021-5/+10
|
* Update the documentation of get_sv() to note that it calls Perl_gv_fetchpv(),Nicholas Clark2009-01-211-4/+4
| | | | | and hence the 'create' argument is actually 'flags'. Fix core code and documentation that used TRUE or FALSE to use 0 or GV_ADD.
* Update the documentation of get_av() to note that it calls Perl_gv_fetchpv(),Nicholas Clark2009-01-211-1/+1
| | | | | and hence the 'create' argument is actually 'flags'. Fix code and documentation that used TRUE or FALSE to use 0 or GV_ADD.
* Purge C<n_a> thoughtcrime from the pods.Nicholas Clark2008-08-101-17/+10
| | | p4raw-id: //depot/perl@34197
* POD cleanupsDavid Landgren2007-10-041-2/+2
| | | | | Message-ID: <46FD4B30.9070802@landgren.net> p4raw-id: //depot/perl@32026
* reentr reshuffleJarkko Hietaniemi2006-09-281-0/+2
| | | | | Message-ID: <451B9874.7060000@iki.fi> p4raw-id: //depot/perl@28896
* Change all NEWSV() to newSV() in the core and non-dual-lived modules.Steve Hay2006-01-181-4/+4
| | | | | | | | Keep NEWSV() itself for backwards-compatibility outside of the core, but don't advertise it any more. (cf. change #25101). p4raw-link: @25101 on //depot/perl: a02a5408b2f199007c4dcb74559cc79066307ada p4raw-id: //depot/perl@26901
* Make setting 'PL_origalen = 1' before perl_parse() disableGisle Aas2006-01-111-0/+16
| | | | | argv[0] munging when $0 is assigned to. p4raw-id: //depot/perl@26779
* Remove stale date.Gisle Aas2006-01-101-2/+0
| | | p4raw-id: //depot/perl@26762
* Reformat a long line in perlembed.pod (bug #24623).Rafael Garcia-Suarez2003-12-131-1/+10
| | | p4raw-id: //depot/perl@21897
* embedding perlRadu Greab2003-10-211-7/+15
| | | | | Message-Id: <20030805.205715.113441323.radu@yx.primIT.ro> p4raw-id: //depot/perl@21514
* Update Jon Orwant's email address as he wants it,Jarkko Hietaniemi2003-08-091-2/+2
| | | | | drop TPJ URL; upate also Doug MacEachern's address. p4raw-id: //depot/perl@20588
* EmbeddingIlya Zakharevich2003-04-051-4/+23
| | | | | | | | Message-ID: <20030331203924.GA3602@math.berkeley.edu> Advertise the pair of macros PERL_SYS_INIT3 / PERL_SYS_TERM to be used in a C program's main function. p4raw-id: //depot/perl@19147
* Bunch of doc patches from Stas; plus regen.Stas Bekman2003-03-101-2/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Subject: [doc patch] perl.c's pod api entry Date: Mon, 10 Mar 2003 12:35:52 +1100 Message-ID: <3E6BEBF8.80402@stason.org> Subject: Re: [patch] perlguts.pod From: Stas Bekman <stas@stason.org> Date: Mon, 10 Mar 2003 12:38:57 +1100 Message-ID: <3E6BECB1.7050009@stason.org> Subject: Re: [PATCH ext/DynaLoader/DynaLoader_pm.PL] doc fix: s/dl_loadflags/dl_load_flags/ From: Stas Bekman <stas@stason.org> Date: Mon, 10 Mar 2003 12:41:46 +1100 Message-ID: <3E6BED5A.801@stason.org> Subject: Re: [patch] perlapi.pod fix From: Stas Bekman <stas@stason.org> Date: Mon, 10 Mar 2003 12:43:33 +1100 Message-ID: <3E6BEDC5.6010405@stason.org> Subject: Re: [docs patch] replace gets() with fgets() in example From: Stas Bekman <stas@stason.org> Date: Mon, 10 Mar 2003 12:45:41 +1100 Message-ID: <3E6BEE45.9030901@stason.org> Subject: [doc patch] perlrun.pod From: Stas Bekman <stas@stason.org> Date: Mon, 10 Mar 2003 14:49:59 +1100 Message-ID: <3E6C0B67.4050606@stason.org> p4raw-id: //depot/perl@18873
* NO_SHORT_NAMES is better than HIDE_SHORT_NAMES.Jarkko Hietaniemi2003-02-161-1/+1
| | | p4raw-id: //depot/perl@18729
* As suggested by Sarathy, add -DPERL_HIDE_SHORT_NAMES optionJarkko Hietaniemi2003-02-161-0/+18
| | | | | | which will disable the short forms of the Perl_ API, good for embedding stuff. (Kind of like the old NO_EMBED, but better.) p4raw-id: //depot/perl@18718
* perlembed.pod: make some examples work with multiplicityBrendan O'Dea2002-09-261-9/+12
| | | | | | From: "Brendan O'Dea" <bod@debian.org> Message-ID: <20020909231905.GA31868@londo.odea.dropbear.id.au> p4raw-id: //depot/perl@17916
* More URL "whitespacing".Jarkko Hietaniemi2002-03-271-3/+3
| | | p4raw-id: //depot/perl@15543
* a few typo fixes Jeffrey Friedl2001-11-121-1/+1
| | | | | | | | | | | Message-Id: <200111120515.fAC5FIc74795@ventrue.corp.yahoo.com> Patching README.foo instead of pod/perlfoo.pod, not patching Math::BigInt (Tels will take care of that), dropping broken hv.c and sv.h patches, patching libnetcfg.PL and perldoc.PL instead of libnetcfg and perldoc, patching ext/Digest/MD5/t/files.t since MD5.pm was changed. p4raw-id: //depot/perl@12954
* Document the changes with regards to running of END blocks.Artur Bergman2001-09-031-5/+17
| | | | | And DESTROY on global objects are called in perl_destruct()! p4raw-id: //depot/perl@11839
* Integrate change #9501 from maintperl into mainline.Jarkko Hietaniemi2001-04-011-5/+33
| | | | | | | | | | | | fix the perlembed notes on multiple interpreters fix ExtUtils::Embed to work passably on Windows p4raw-link: @9501 on //depot/maint-5.6/perl: fa102aa9a975aaa2a384e09b6377476f565fdcc2 p4raw-id: //depot/perl@9502 p4raw-integrated: from //depot/maint-5.6/perl@9500 'copy in' pod/perlembed.pod (@8627..) 'merge in' lib/ExtUtils/Embed.pm (@8153..)
* ; was Re: Perlbug 20000322.006 status +updateRobin Barker2000-12-221-10/+30
| | | | | Message-Id: <200012221217.MAA21332@tempest.npl.co.uk> p4raw-id: //depot/perl@8228
* Pod updatesStephen P. Potter2000-11-071-14/+13
| | | | | Message-Id: <200011062357.SAA18173@spotter.yi.org> p4raw-id: //depot/perl@7585
* Re: Array vs. List contextDaniel Chetlin2000-08-041-2/+2
| | | | | Message-ID: <20000804002244.A5924@ilmd.chetlin.org> p4raw-id: //depot/perl@6522
* tweak perlembed for multiplicity/usethreads sanity; correct notesGurusamy Sarathy2000-06-301-24/+9
| | | | | about Windows p4raw-id: //depot/perl@6284
* whitespace and readabiliti nits in the pods (from Michael G SchwernGurusamy Sarathy2000-03-031-39/+39
| | | | | and Robin Barker) p4raw-id: //depot/perl@5493
* fix pods to reflect newer canonical names for call_sv() etc.Gurusamy Sarathy2000-02-291-31/+31
| | | p4raw-id: //depot/perl@5371
View Lorry Controller Status