Skip to content
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

"References"/"Dereferencing" in 5-to-6 need to be rewritten #1081

Closed
zoffixznet opened this issue Dec 25, 2016 · 1 comment
Closed

"References"/"Dereferencing" in 5-to-6 need to be rewritten #1081

zoffixznet opened this issue Dec 25, 2016 · 1 comment
Labels
docs Documentation issue (primary issue type)

Comments

@zoffixznet
Copy link
Contributor

zoffixznet commented Dec 25, 2016

The reference as well as Dereferencing need to be completely rewritten as they suggest ridiculous, superfluous operations.

The section needs to say that we don't have references like in Perl 5 at all. While objects get "passed by reference" we don't even use that term when talking about regular code.

The current doc recommend use of things like say keys %($hashref ); or that you need an item() call to store an array in a scalar variable; or that you need a Zen slice to store a $hash in a %hash. All of that is superfluous and not needed.

Moreover, the major utility of references in Perl 5 is to pass around structured data without it being flattened. This is no longer needed in Perl 6, but the sections don't mention that fact at all.

If I'm coming from Perl 5, what I'd learn from those sections is I need to switch -> to . and @{} to @(), when in reality the entire paradigm is different in Perl 6.

@zoffixznet zoffixznet added the docs Documentation issue (primary issue type) label Dec 25, 2016
@coke coke changed the title "References"/"Dereferncing" in 5-to-6 need to be rewritten "References"/"Dereferencing" in 5-to-6 need to be rewritten Dec 28, 2016
@JJ
Copy link
Contributor

JJ commented May 6, 2018

This is still a problem, right? Can you make some suggestions?

@JJ JJ added the JJ TPF Grant label May 6, 2018
@JJ JJ removed the JJ TPF Grant label May 14, 2018
JJ added a commit that referenced this issue May 23, 2018
This refs #1081. Leaves open because there might be some hanging
internal references, and also for general review.
@JJ JJ closed this as completed in 8cd8ed0 May 24, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation issue (primary issue type)
Projects
None yet
Development

No branches or pull requests

2 participants