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

Update documentation #658

Merged
merged 5 commits into from
Dec 8, 2022
Merged

Update documentation #658

merged 5 commits into from
Dec 8, 2022

Conversation

r0qs
Copy link
Member

@r0qs r0qs commented Sep 12, 2022

The PR fixes the below issues adding documentation about their respective topics:

@coveralls
Copy link

coveralls commented Sep 13, 2022

Coverage Status

Coverage remained the same at 84.537% when pulling 3549bf4 on doc-update into fc232fe on master.

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
></script>
```

(Alternatively use `https://binaries.soliditylang.org/bin/soljson-latest.js` to get the latests version.)
This will load `solc` into the global variable `window.Module`.
Copy link
Member

Choose a reason for hiding this comment

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

Into the global variable or is that a namespace / object? Maybe saying assigning it as a member of window.Module would be more precise?

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 global variable is correct. I mean, the Module is a property of window and thus a global variable since window is a global object of a web page that refers to itself. I may be wrong, but solc is not assigned as a member of the window.Module, it is loaded as the Module object in the window. Maybe global object would be correct, too. Like:

This will load solc as the global object window.Module.

But honestly, I'm not sure about the terminology. I usually refer to any window property as global variables, but I may be calling them by the wrong name, haha

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated
}
});
```

The version **must** be in the long format string.
Thus, if you would like to use version `v0.8.17` you need to provide it, including the committed version of the release.
You can extract the long version string for each version from the [public available release list](https://binaries.soliditylang.org/bin/list.json).
Copy link
Member

Choose a reason for hiding this comment

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

I wanted to say that we should rather point people towards the new emscripten-wasm32/ and emscripten-asmjs/ dirs but I realized that it would be inconsistent because we're still using and mentioning bin/ everywhere. So I guess it's out of scope of this PR. FYI I created an issue for it: #671.

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
@cameel
Copy link
Member

cameel commented Oct 6, 2022

Needs rebase for the hardhat job to pass. It's already fixed on master.

@r0qs r0qs requested review from cameel, christianparpart and matheusaaguiar and removed request for axic October 31, 2022 17:49
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
Copy link
Contributor

@matheusaaguiar matheusaaguiar left a comment

Choose a reason for hiding this comment

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

LGTM.

Copy link
Member

@cameel cameel left a comment

Choose a reason for hiding this comment

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

LGTM. Please remember to squash review fixes into the original commits before merging.

README.md Outdated Show resolved Hide resolved
@r0qs r0qs force-pushed the doc-update branch 2 times, most recently from ca6ff29 to 4769b63 Compare December 5, 2022 11:41
r0qs and others added 3 commits December 5, 2022 12:43
- Document the necessity of using long version string in loadRemoteVersion
- Add note about low-level functions
- Fix SRI documentation
- Improve text

Co-authored-by: Christian Parpart <[email protected]>
Co-authored-by: matheusaaguiar <[email protected]>
Co-authored-by: Kamil Śliwak <[email protected]>
Co-authored-by: matheusaaguiar <[email protected]>
Co-authored-by: Kamil Śliwak <[email protected]>
@cameel cameel merged commit bf49720 into master Dec 8, 2022
@cameel cameel deleted the doc-update branch December 8, 2022 13:11
@r0qs r0qs mentioned this pull request Mar 9, 2023
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.

5 participants