You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
gh-35843: Add a WSL prerequisites section
<!-- Please provide a concise, informative and self-explanatory title.
-->
<!-- Don't put issue numbers in the title. Put it in the Description
below. -->
<!-- For example, instead of "Fixes#12345", use "Add a new method to
multiply two integers" -->
### 📚 Description
<!-- Describe your changes here in detail. -->
This PR adds a new section named **WSL prerequesites**, moving the WSL-
Ubuntu-specific section to as subsection and adding the WSL error under
it under its own subsection.
<!-- Why is this change required? What problem does it solve? -->
This change was made because originally the build error and solutions
appeared only under the WSL-Ubuntu-specific section but in reality this
impacts all flavours of WSL, not just Ubuntu.
<!-- If this PR resolves an open issue, please link to it here. For
example "Fixes#12345". -->
Fixes#35840
<!-- If your change requires a documentation PR, please link it
appropriately. -->
This is what the documentation looks like with this change:

which can be checked here: https://deploy-preview-35843--sagemath-
tobias.netlify.app/installation/source.html#wsl-prerequisites
### 📝 Checklist
<!-- Put an `x` in all the boxes that apply. It should be `[x]` not `[x
]`. -->
- [x] The title is concise, informative, and self-explanatory.
- [x] The description explains in detail what this PR is about.
- [x] I have linked a relevant issue or discussion.
- [x] ~I have created tests covering the changes.~ Not needed
- [x] I have updated the documentation accordingly.
### ⌛ Dependencies
<!-- List all open PRs that this PR logically depends on
- #12345: short description why this is a dependency
- #34567: ...
-->
<!-- If you're unsure about any of these, don't hesitate to ask. We're
here to help! -->
None
URL: #35843
Reported by: Daniel-Khodabakhsh
Reviewer(s): Dima Pasechnik
Sage can be installed onto Linux running on Windows Subsystem for Linux (WSL). These instructions describe a fresh install of Ubuntu 20.10, but other distributions or installation methods should work too, though have not been tested.
265
267
@@ -283,11 +285,17 @@ Sage can be installed onto Linux running on Windows Subsystem for Linux (WSL). T
283
285
From this point on, follow the instructions in the :ref:`sec-installation-from-sources-linux-recommended-installation` section.
284
286
It is strongly recommended to put the Sage source files in the Linux file system, for example, in the ``/home/username/sage`` directory, and not in the Windows file system (e.g. ``/mnt/c/...``).
285
287
288
+
WSL permission denied error when building `packaging` package.
You may encounter permission errors of the kind ``"[Errno 13] Permission denied: 'build/bdist.linux-x86_64/wheel/<package>.dist-info'"`` during ``make``.
287
292
This usually comes from a permission conflict between the Windows and Linux file system.
288
293
To fix it create a temporary build folder in the Linux file system using ``mkdir -p ~/tmp/sage`` and use it for building by ``eval SAGE_BUILD_DIR="~/tmp/sage" make``.
289
294
Also see the `related Github issue <https://github.com/pypa/packaging-problems/issues/258>`_ for other workarounds.
290
295
296
+
WSL post-installation notes
297
+
~~~~~~~~~~~~~~~~~~~~~~~~~~~
298
+
291
299
When the installation is complete, you may be interested in :ref:`sec-launching-wsl-post-installation`.
0 commit comments