Skip to content

Conversation

@cgay
Copy link
Member

@cgay cgay commented Jun 28, 2023

  • many had an unnecessary preceding backslash
  • generic-function-mandatory-keywords was split across two lines

(Untested. Creating a pull request so I don't forget about this branch. I need to figure out how to setup a web server that will automatically assume .html file extensions. Why is there no README in this repo grumble grumble.)

* many had an unnecessary preceding backslash
* generic-function-mandatory-keywords was split across two lines
@cgay cgay marked this pull request as ready for review June 29, 2023 03:36
@cgay
Copy link
Member Author

cgay commented Jun 29, 2023

I've now tested this here: https://docs.opendylan.org/books/drm/Exported_Names

\~
\~=
\~==
*
Copy link
Member

Choose a reason for hiding this comment

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

Treating these operators as names usually does require an escape backslash, so I think it would be best to keep them.

Copy link
Member Author

Choose a reason for hiding this comment

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

I think I must disagree. This section is specifically listing names, not talking about how they might be imported or exported, and it could be confusing to a newcomer as to whether the name includes the backslash or not.

(It could be confusing when they get to the point of importing these names individually, too, but chances are they will never have to do that.)

Furthermore, we don't do it for other names such as := and for, which IIRC will have the same problem.

@cgay cgay merged commit a483514 into dylan-lang:master Jul 2, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants