Branch: refs/heads/blead
Home: https://github.com/Perl/perl5
Commit: f87d08569b779eeb9445716e595090f23fdab8e0
https://github.com/Perl/perl5/commit/f87d08569b779eeb9445716e595090f23fdab8e0
Author: Dan Church <amphetamach...@gmail.com>
Date: 2023-09-08 (Fri, 08 Sep 2023)
Changed paths:
M AUTHORS
M dist/Data-Dumper/Dumper.pm
M dist/base/lib/fields.pm
M pod/perl5180delta.pod
M pod/perl561delta.pod
M pod/perl56delta.pod
M pod/perldiag.pod
M pod/perlunicode.pod
M sv.c
M t/uni/lex_utf8.t
Log Message:
-----------
[doc] Fix 'comprised of'
- It's not the meaning of the word; the whole comprises the parts, the
parts compose the whole.
- The etymology of the word comes from Latin words meaning to hold or
grasp together.
- "Comprised of" is often used unnecessarily to aggrandize a sentence
instead of just using a more precise "composed of" or "consists of."
- Many English style manuals state it's not to be used.
Further reading: https://en.m.wikipedia.org/wiki/User:Giraffedata/comprised_of
Existing instances of 'comprise' being used correctly in the Perl docs:
- perlunicode.pod: "Those [character types] listed above comprised the complete
set for many Unicode releases, but others were added in Unicode 6.3; [...]"
- Encode / Supported.pod: "You may also have found out by now why 7bit ISO-2022
cannot comprise a CCS [Coded Character Set]."
- cpan / perlfaq.pod: "The perlfaq comprises several documents that answer the
most commonly asked questions about Perl and Perl programming."
- bytes.pm: "This pragma allows for the examination of the individual bytes
that together comprise a character."
- perldocstyle.pod: "Most of the perfunc man page comprises a single list,
found under the header [...]"
