Skip to content

perlpacktut: Remove some jargon #23251

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: blead
Choose a base branch
from

Conversation

khwilliamson
Copy link
Contributor

Fixes #22697

That a native English speaker could be confused by this is prima facie evidence that the wording should be improved. It's al right to be clever, but not at the expense of clarity.

  • This set of changes does not require a perldelta entry.

this is likely to remind you of a dump program, or some desperate last
message unfortunate programs are wont to throw at you before they expire
into the wild blue yonder. Assuming that the variable C<$mem> holds a
this is likely to remind you of a dump program, or some terse panic
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

While I think your phrasing is an improvement, I have to wonder why unpack is likely to remind me of a dump program or a panic message.

Copy link
Contributor

@Grinnz Grinnz May 4, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This could be improved by swapping the order of the sentence, like "Since this is likely to remind you..., let's use unpack."

@khwilliamson khwilliamson force-pushed the perlpack_desperate branch from 9b51d83 to 070b513 Compare May 4, 2025 16:47
@khwilliamson
Copy link
Contributor Author

I delved further into this, and think the result of the latest push is much better.

Comment on lines +64 to +66
print unpack( 'A*', $mem), "\n"

A MAN A PLAN A CANAL PANAMA
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is no different to:

print $mem, "\n";

I don't see how it adds anything

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[doc] perl pack rephrase
4 participants