Skip to content

English documentation updates up to v0.8.31-pre.1-36-g08c4e0c6c (2025-11-10)#172

Open
github-actions[bot] wants to merge 116 commits intodevelopfrom
sync-v0.8.31-pre.1-36-g08c4e0c6c
Open

English documentation updates up to v0.8.31-pre.1-36-g08c4e0c6c (2025-11-10)#172
github-actions[bot] wants to merge 116 commits intodevelopfrom
sync-v0.8.31-pre.1-36-g08c4e0c6c

Conversation

@github-actions
Copy link
Copy Markdown

This is an automatically-generated sync PR to bring this translation repository up to date with the state of the English documentation as of 2025-11-10 (commit 08c4e0c6).

How to work on a sync PR

Resolve conflicts and translate newly added text

  • The PR includes all documentation changes from the main repository since the last time a sync PR was merged. If this translation repository is fully caught up with the English version, translate any newly added English text you see here by pushing more commits to the PR. However, if the translation is incomplete, you may prefer to leave the text added in this PR and add it to your translation checklist to handle at a later time.
  • Scan the PR for merge conflict markers. If there were changes in the English text that has already been translated, the PR will contain merge conflicts that need to be resolved:
    <<<<<<< HEAD
        El valor más grande representable por el tipo ``T``.
    =======
        The smallest value representable by type ``T``.
    >>>>>>> 800088e38b5835ebdc71e9ba5299a70a5accd7c2
    The top part of the conflict is the current translation (corresponding to the old English text), the bottom shows the new English text. To solve the conflict simply translate the new text, possibly reusing parts of the current translation. After doing so, do not forget to remove the conflict markers.
  • You may get conflicts also if there were structual changes that did not affect the meaning of the text and therefore do not require retranslation. For example when text is moved from one page to another, you will find matching conflicts in two places and the solution is to move the translation to the new spot. If only whitespace changed, it may even seem like there was no change at all but if there is a conflict, there is always a reason, however trivial it may be. Be careful, though, because there is a possibility that the text was both moved and modified.

Work on one sync PR at a time

  • Sync PRs are produced by the translation bot in regular intervals as long as there are changes in the English documentation. You will not lose any updates by closing this PR. The next sync PR will also include them. The latest sync PR will always include all changes that need to be done. If you haven't worked on any sync PR yet and there are several open sync PRs in your repo, choose the latest (newest) one to get started.
  • It is recommended to work only on one sync PR at a time. Close this PR if you are already working on a different one.
  • Once you merge this PR, the conflict resolutions and new commits you pushed to it are likely to cause conflicts with other open sync PRs. It is possible solve these conflicts if you are proficient with git and fully understand what changed in which PR, but for simplicity it is recommended to close all pending sync PRs and wait for a fresh one, which will no longer include the merged changes.

Do not squash merge or rebase this PR

Rebasing or squashing a sync PR erases the information about the commits that the changes originally came from, which will result in extra conflicts in the next sync PR.
If you do it by accident, don't worry - simply make sure to handle the next sync PR properly, which will restore the missing commits.

Review checklist

The following files were modified in this pull request. Please review them before merging the PR:

clonker and others added 30 commits August 28, 2025 15:11
Update links to github org as argotorg and ipsilon where appropriate
…missions

Update permissions for welcome-external-pr bot commenting
Pin actions-comment-pull-request action to specific commit and update to the latest version
re-enable full prb-math preset matrix
Nightly foundry for prb math and docs build dependencies`
dockerfiles: bump emscripten to v21 containing boost 1.83.0
…windows builds and of GCC and Clang to 13.3 and 18.1.3, respectively.

Fixes infinite recursion on `boost::rational` comparison affecting compiler binaries built with GCC<14.0 and Boost<1.75.
Bump boost, gcc, clang for non-windows builds and add CI job with these versions
Move ssa pipeline things into own subdirectory
If a variable is referenced downstream, a counter gets incremented. If it gets used different amount of times in different branches, we take the max of these. The number reflects how many times a value is going to be used downstream _at most_.
r0qs and others added 29 commits October 20, 2025 14:15
EVM instruction interpreter: record linker symbols
Optimize SSA CFG datastructure + construction
…s ^128.

In the text description of the State Properties paragraph:
[...]
As an example, consider a 2D grid where both axis have coordinates in the range (-2^128, 2^128 - 1).
[...]

In the example:
[...]
require(x > type(int128).min && x < type(int128).max);
require(y > type(int128).min && y < type(int128).max);
[...]


With int128 we use a bit for the sign, then 127 bits remain for the value.

Changed in the text description to be coherent:
...in the range (-2^127, 2^127 - 1).
before:   0000...0000 1111 1111
after:      0000...0000 0111 1111
Fix: max int8 has 7 bits set to 1, not 8 bits
Update smtchecker.rst: fix int128 range = [-2^127,2^127-1], was ^128
Chore: drop unused isfile import from wasm isolate script
docs: fix links to solc-bin github page and remix offline installation
SSACFG backend: add stack abstraction
Fix parse_bool handling of "false" values in parse_eth_gas_report
…-11-10)

# Conflicts:
#	.circleci/compare_bytecode_reports.sh
#	.circleci/config.yml
#	.circleci/osx_install_dependencies.sh
#	.circleci/parallel_bytecode_report.sh
#	.circleci/soltest_all.sh
#	.github/workflows/buildpack-deps.yml
#	.github/workflows/stale.yml
#	.github/workflows/welcome-external-pr.yml
#	CODING_STYLE.md
#	Changelog.md
#	README.md
#	ReleaseChecklist.md
#	SECURITY.md
#	cmake/EthDependencies.cmake
#	docs/050-breaking-changes.rst
#	docs/060-breaking-changes.rst
#	docs/070-breaking-changes.rst
#	docs/080-breaking-changes.rst
#	docs/bugs.rst
#	docs/contributing.rst
#	docs/index.rst
#	docs/installing-solidity.rst
#	docs/internals/optimizer.rst
#	docs/layout-of-source-files.rst
#	docs/path-resolution.rst
#	docs/smtchecker.rst
#	docs/yul.rst
#	libevmasm/Instruction.cpp
#	libevmasm/Instruction.h
#	libevmasm/SimplificationRule.h
#	liblangutil/EVMVersion.cpp
#	liblangutil/EVMVersion.h
#	libsolidity/experimental/analysis/Analysis.cpp
#	libsolidity/interface/ImportRemapper.h
#	libsolidity/interface/Natspec.h
#	libsolutil/DisjointSet.cpp
#	libsolutil/DisjointSet.h
#	libyul/AsmAnalysis.cpp
#	libyul/CMakeLists.txt
#	libyul/YulStack.cpp
#	libyul/backends/evm/EVMDialect.cpp
#	libyul/backends/evm/ssa/ControlFlow.cpp
#	libyul/backends/evm/ssa/ControlFlow.h
#	libyul/backends/evm/ssa/SSACFG.cpp
#	libyul/backends/evm/ssa/SSACFG.h
#	libyul/backends/evm/ssa/SSACFGBuilder.cpp
#	libyul/backends/evm/ssa/SSACFGBuilder.h
#	libyul/backends/evm/ssa/SSACFGJsonExporter.cpp
#	libyul/backends/evm/ssa/SSACFGLoopNestingForest.cpp
#	libyul/backends/evm/ssa/SSACFGLoopNestingForest.h
#	libyul/backends/evm/ssa/SSACFGTopologicalSort.cpp
#	libyul/backends/evm/ssa/SSACFGTopologicalSort.h
#	scripts/Dockerfile
#	scripts/Dockerfile_alpine
#	scripts/build.sh
#	scripts/build_emscripten.sh
#	scripts/ci/build.sh
#	scripts/ci/build_emscripten.sh
#	scripts/ci/buildpack-deps_test_ubuntu2404.arm.sh
#	scripts/ci/post_style_errors_on_github.sh
#	scripts/common/rest_api_helpers.py
#	scripts/create_source_tarball.sh
#	scripts/docker/buildpack-deps/Dockerfile.emscripten
#	scripts/docker/buildpack-deps/Dockerfile.ubuntu.clang.ossfuzz
#	scripts/docker/buildpack-deps/Dockerfile.ubuntu2404
#	scripts/docker/buildpack-deps/Dockerfile.ubuntu2404.clang
#	scripts/docker_deploy_manual.sh
#	scripts/docs_version_pragma_check.sh
#	scripts/download_ossfuzz_corpus.sh
#	scripts/externalTests/common.sh
#	scripts/externalTests/download_benchmarks.py
#	scripts/externalTests/parse_eth_gas_report.py
#	scripts/install_evmone.ps1
#	scripts/release_ppa.sh
#	scripts/run_proofs.sh
#	scripts/solc-bin/bytecode_reports_for_modified_binaries.sh
#	scripts/test_antlr_grammar.sh
#	scripts/wasm-rebuild/docker-scripts/isolate_tests.py
#	scripts/wasm-rebuild/docker-scripts/rebuild_tags.sh
#	test/Common.h
#	test/buglistTests.js
#	test/cmdlineTests/standard_yul_cfg_json_export/output.json
#	test/cmdlineTests/strict_asm_yul_cfg_json_export/output
#	test/cmdlineTests/yul_cfg_json_export/output
#	test/cmdlineTests/yul_optimizer_steps_invalid_substitution_in_expression_simplifier/input.sol
#	test/cmdlineTests/~bytecode_equivalence_with_unused_contracts/test.py
#	test/cmdlineTests/~deduplicator-verbatim-bug/test.sh
#	test/cmdlineTests/~name_dependent_cse_bug/test.sh
#	test/evmc/README.md
#	test/evmc/evmc.h
#	test/externalTests/euler.sh
#	test/externalTests/gp2.sh
#	test/externalTests/prb-math.py
#	test/formal/README.md
#	test/libsolidity/SolidityEndToEndTest.cpp
#	test/libsolidity/SolidityOptimizer.cpp
#	test/libsolidity/StandardCompiler.cpp
#	test/libsolidity/semanticTests/array/copying/calldata_1d_array_into_2d_memory_array_element.sol
#	test/libsolidity/semanticTests/constants/asm_address_constant_regression.sol
#	test/libsolidity/semanticTests/structs/copy_from_storage.sol
#	test/libsolidity/syntaxTests/array/copy_from_function_type.sol
#	test/libsolidity/syntaxTests/structs/recursion/recursive_struct_nested_mapping_memory.sol
#	test/libsolutil/DisjointSet.cpp
#	test/libyul/SSAControlFlowGraphTest.cpp
#	test/libyul/YulOptimizerTestCommon.cpp
#	test/libyul/yulOptimizerTests/expressionSimplifier/invalid_match.yul
#	test/libyul/yulOptimizerTests/fullSuite/aztec.yul
#	test/libyul/yulOptimizerTests/loadResolver/keccak_crash.yul
#	test/libyul/yulSSAControlFlowGraph/complex.yul
#	test/libyul/yulSSAControlFlowGraph/complex2.yul
#	test/libyul/yulSSAControlFlowGraph/default_initialized_variable.yul
#	test/libyul/yulSSAControlFlowGraph/function.yul
#	test/libyul/yulSSAControlFlowGraph/if.yul
#	test/libyul/yulSSAControlFlowGraph/if_const.yul
#	test/libyul/yulSSAControlFlowGraph/nested_for.yul
#	test/libyul/yulSSAControlFlowGraph/nested_function.yul
#	test/libyul/yulSSAControlFlowGraph/switch.yul
#	test/libyul/yulSSAControlFlowGraph/switch_const.yul
#	test/scripts/test_externalTests_benchmark_downloader.py
#	test/tools/ossfuzz/StackReuseCodegenFuzzer.cpp
#	test/tools/ossfuzz/abiV2Proto.proto
#	test/tools/yulInterpreter/EVMInstructionInterpreter.cpp
#	test/tools/yulInterpreter/EVMInstructionInterpreter.h
#	tools/yulPhaser/README.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants