diff options
author | Karl Williamson <khw@cpan.org> | 2015-05-08 21:25:33 -0600 |
---|---|---|
committer | Karl Williamson <khw@cpan.org> | 2015-09-03 23:10:37 -0600 |
commit | c5608a1f701aaeaf4724bd21cb2a64e880598574 (patch) | |
tree | c17057b46f1533a187d11108bba924fe386d2b91 | |
parent | 4a4088c46812cbd5bfe69cf9728912de92c28b94 (diff) | |
download | perl-c5608a1f701aaeaf4724bd21cb2a64e880598574.tar.gz |
perlapi: Change slightly weird construct
As a native English speaker, I find it clearer to say that a bit vector
has a particular bit set, rather than to say that it includes that bit.
-rw-r--r-- | pad.c | 2 | ||||
-rw-r--r-- | sv.c | 22 | ||||
-rw-r--r-- | toke.c | 24 |
3 files changed, 24 insertions, 24 deletions
@@ -2334,7 +2334,7 @@ An SV may be passed as a second argument. If so, the name will be assigned to it and it will be returned. Otherwise the returned SV will be a new mortal. -If C<flags> include C<CV_NAME_NOTQUAL>, then the package name will not be +If C<flags> has the C<CV_NAME_NOTQUAL> bit set, then the package name will not be included. If the first argument is neither a CV nor a GV, this flag is ignored (subject to change). @@ -2420,7 +2420,7 @@ S_sv_2iuv_common(pTHX_ SV *const sv) =for apidoc sv_2iv_flags Return the integer value of an SV, doing any necessary string -conversion. If C<flags> includes C<SV_GMAGIC>, does an C<mg_get()> first. +conversion. If C<flags> has the C<SV_GMAGIC> bit set, does an C<mg_get()> first. Normally used via the C<SvIV(sv)> and C<SvIVx(sv)> macros. =cut @@ -2516,7 +2516,7 @@ Perl_sv_2iv_flags(pTHX_ SV *const sv, const I32 flags) =for apidoc sv_2uv_flags Return the unsigned integer value of an SV, doing any necessary string -conversion. If C<flags> includes C<SV_GMAGIC>, does an C<mg_get()> first. +conversion. If C<flags> has the C<SV_GMAGIC> bit set, does an C<mg_get()> first. Normally used via the C<SvUV(sv)> and C<SvUVx(sv)> macros. =cut @@ -2599,7 +2599,7 @@ Perl_sv_2uv_flags(pTHX_ SV *const sv, const I32 flags) =for apidoc sv_2nv_flags Return the num value of an SV, doing any necessary string or integer -conversion. If C<flags> includes C<SV_GMAGIC>, does an C<mg_get()> first. +conversion. If C<flags> has the C<SV_GMAGIC> bit set, does an C<mg_get()> first. Normally used via the C<SvNV(sv)> and C<SvNVx(sv)> macros. =cut @@ -2925,7 +2925,7 @@ S_infnan_2pv(NV nv, char* buffer, size_t maxlen, char plus) { =for apidoc sv_2pv_flags Returns a pointer to the string value of an SV, and sets C<*lp> to its length. -If flags includes C<SV_GMAGIC>, does an C<mg_get()> first. Coerces C<sv> to a +If flags has the C<SV_GMAGIC> bit set, does an C<mg_get()> first. Coerces C<sv> to a string if necessary. Normally invoked via the C<SvPV_flags> macro. C<sv_2pv()> and C<sv_2pv_nomg> usually end up here too. @@ -3236,7 +3236,7 @@ Like C<sv_copypv>, but doesn't invoke get magic first. =for apidoc sv_copypv_flags Implementation of C<sv_copypv> and C<sv_copypv_nomg>. Calls get magic iff flags -include C<SV_GMAGIC>. +has the C<SV_GMAGIC> bit set. =cut */ @@ -5408,8 +5408,8 @@ and C<L</sv_catsv_nomg>>. Concatenates the string from SV C<ssv> onto the end of the string in SV C<dsv>. If C<ssv> is null, does nothing; otherwise modifies only C<dsv>. -If C<flags> include C<SV_GMAGIC> bit set, will call C<mg_get> on both SVs if -appropriate. If C<flags> include C<SV_SMAGIC>, C<mg_set> will be called on +If C<flags> has the C<SV_GMAGIC> bit set, will call C<mg_get> on both SVs if +appropriate. If C<flags> has the C<SV_SMAGIC> bit set, C<mg_set> will be called on the modified SV afterward, if appropriate. C<sv_catsv>, C<sv_catsv_nomg>, and C<sv_catsv_mg> are implemented in terms of this function. @@ -7637,7 +7637,7 @@ coerce its args to strings if necessary. Returns a boolean indicating whether the strings in the two SVs are identical. Is UTF-8 and S<C<'use bytes'>> aware and coerces its args to strings -if necessary. If C<flags> includes C<SV_GMAGIC>, it handles get-magic, too. +if necessary. If the flags has the C<SV_GMAGIC> bit set, it handles get-magic, too. =cut */ @@ -7730,7 +7730,7 @@ coerce its args to strings if necessary. See also C<L</sv_cmp_locale>>. Compares the strings in two SVs. Returns -1, 0, or 1 indicating whether the string in C<sv1> is less than, equal to, or greater than the string in C<sv2>. Is UTF-8 and S<C<'use bytes'>> aware and will coerce its args to strings -if necessary. If the flags includes C<SV_GMAGIC>, it handles get magic. See +if necessary. If the flags has the C<SV_GMAGIC> bit set, it handles get magic. See also C<L</sv_cmp_locale_flags>>. =cut @@ -9825,7 +9825,7 @@ can't cope with complex macro expressions. Always use the macro instead. =for apidoc sv_pvn_force_flags Get a sensible string out of the SV somehow. -If C<flags> has C<SV_GMAGIC> bit set, will C<mg_get> on C<sv> if +If C<flags> has the C<SV_GMAGIC> bit set, will C<mg_get> on C<sv> if appropriate, else not. C<sv_pvn_force> and C<sv_pvn_force_nomg> are implemented in terms of this function. You normally want to use the various wrapper macros instead: see @@ -10817,7 +10817,7 @@ When running with taint checks enabled, indicates via C<maybe_tainted> if results are untrustworthy (often due to the use of locales). -If called as C<sv_vcatpvfn> or flags include C<SV_GMAGIC>, calls get magic. +If called as C<sv_vcatpvfn> or flags has the C<SV_GMAGIC> bit set, calls get magic. Usually used via one of its frontends C<sv_vcatpvf> and C<sv_vcatpvf_mg>. @@ -1241,7 +1241,7 @@ the current chunk at this time. If L</PL_parser-E<gt>bufptr> is pointing to the very end of the current chunk (i.e., the current chunk has been entirely consumed), normally the current chunk will be discarded at the same time that the new chunk is -read in. If C<flags> includes C<LEX_KEEP_PREVIOUS>, the current chunk +read in. If C<flags> has the C<LEX_KEEP_PREVIOUS> bit set, the current chunk will not be discarded. If the current chunk has not been entirely consumed, then it will not be discarded regardless of the flag. @@ -1362,8 +1362,8 @@ peeked character, use L</lex_read_unichar>. If the next character is in (or extends into) the next chunk of input text, the next chunk will be read in. Normally the current chunk will be -discarded at the same time, but if C<flags> includes C<LEX_KEEP_PREVIOUS> -then the current chunk will not be discarded. +discarded at the same time, but if C<flags> has the C<LEX_KEEP_PREVIOUS> +bit set, then the current chunk will not be discarded. If the input is being interpreted as UTF-8 and a UTF-8 encoding error is encountered, an exception is generated. @@ -1433,8 +1433,8 @@ examine the next character, use L</lex_peek_unichar> instead. If the next character is in (or extends into) the next chunk of input text, the next chunk will be read in. Normally the current chunk will be -discarded at the same time, but if C<flags> includes C<LEX_KEEP_PREVIOUS> -then the current chunk will not be discarded. +discarded at the same time, but if C<flags> has the C<LEX_KEEP_PREVIOUS> +bit set, then the current chunk will not be discarded. If the input is being interpreted as UTF-8 and a UTF-8 encoding error is encountered, an exception is generated. @@ -1471,7 +1471,7 @@ at a non-space character (or the end of the input text). If spaces extend into the next chunk of input text, the next chunk will be read in. Normally the current chunk will be discarded at the same -time, but if C<flags> includes C<LEX_KEEP_PREVIOUS> then the current +time, but if C<flags> has the C<LEX_KEEP_PREVIOUS> bit set, then the current chunk will not be discarded. =cut @@ -11275,7 +11275,7 @@ Parse a Perl arithmetic expression. This may contain operators of precedence down to the bit shift operators. The expression must be followed (and thus terminated) either by a comparison or lower-precedence operator or by something that would normally terminate an expression such as semicolon. -If C<flags> includes C<PARSE_OPTIONAL> then the expression is optional, +If C<flags> has the C<PARSE_OPTIONAL> bit set, then the expression is optional, otherwise it is mandatory. It is up to the caller to ensure that the dynamic parser state (L</PL_parser> et al) is correctly set to reflect the source of the code to be parsed and the lexical context for the @@ -11307,7 +11307,7 @@ Parse a Perl term expression. This may contain operators of precedence down to the assignment operators. The expression must be followed (and thus terminated) either by a comma or lower-precedence operator or by something that would normally terminate an expression such as semicolon. -If C<flags> includes C<PARSE_OPTIONAL> then the expression is optional, +If C<flags> has the C<PARSE_OPTIONAL> bit set, then the expression is optional, otherwise it is mandatory. It is up to the caller to ensure that the dynamic parser state (L</PL_parser> et al) is correctly set to reflect the source of the code to be parsed and the lexical context for the @@ -11339,7 +11339,7 @@ Parse a Perl list expression. This may contain operators of precedence down to the comma operator. The expression must be followed (and thus terminated) either by a low-precedence logic operator such as C<or> or by something that would normally terminate an expression such as semicolon. -If C<flags> includes C<PARSE_OPTIONAL> then the expression is optional, +If C<flags> has the C<PARSE_OPTIONAL> bit set, then the expression is optional, otherwise it is mandatory. It is up to the caller to ensure that the dynamic parser state (L</PL_parser> et al) is correctly set to reflect the source of the code to be parsed and the lexical context for the @@ -11372,8 +11372,8 @@ expression grammar, including the lowest-precedence operators such as C<or>. The expression must be followed (and thus terminated) by a token that an expression would normally be terminated by: end-of-file, closing bracketing punctuation, semicolon, or one of the keywords that -signals a postfix expression-statement modifier. If C<flags> includes -C<PARSE_OPTIONAL> then the expression is optional, otherwise it is +signals a postfix expression-statement modifier. If C<flags> has the +C<PARSE_OPTIONAL> bit set, then the expression is optional, otherwise it is mandatory. It is up to the caller to ensure that the dynamic parser state (L</PL_parser> et al) is correctly set to reflect the source of the code to be parsed and the lexical context for the expression. @@ -11477,7 +11477,7 @@ Perl_parse_barestmt(pTHX_ U32 flags) Parse a single label, possibly optional, of the type that may prefix a Perl statement. It is up to the caller to ensure that the dynamic parser state (L</PL_parser> et al) is correctly set to reflect the source of -the code to be parsed. If C<flags> includes C<PARSE_OPTIONAL> then the +the code to be parsed. If C<flags> has the C<PARSE_OPTIONAL> bit set, then the label is optional, otherwise it is mandatory. The name of the label is returned in the form of a fresh scalar. If an |