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.

Sign up for GitHub

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

troubleshooting: clarify WSL startingDirectory entry #516

Merged
merged 3 commits into from
Mar 8, 2022
Merged

troubleshooting: clarify WSL startingDirectory entry #516

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
6dfd63f
troubleshooting: Linux paths support in 'startingDirectory' was added…
phil-blain Mar 1, 2022
d5a2d5c
troubleshooting: remove confusing 'Important' note about WSL 'startin…
phil-blain Mar 1, 2022
396c847
.gitattributes: mark '*.md' as Markdown files
phil-blain Mar 1, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion .gitattributes
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,7 @@

# Denote all files that are truly binary and should not be modified.
*.png binary
*.jpg binary
*.jpg binary

# Denote Markdown files as such
*.md diff=markdown
4 changes: 1 addition & 3 deletions TerminalDocs/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ If you click on the "settings" button in the dropdown, the Terminal will attempt

## Set your WSL distribution to start in the home `~` directory when launched

By default, the `startingDirectory` of a profile is `%USERPROFILE%` (`C:\Users\<YourUsername>`). This is a Windows path. For WSL distributions, the file systems are now directly referenced, as of Windows Terminal [version 1.12.3472.0](https://github.com/microsoft/terminal/releases). You can use `/home/<Your Ubuntu Username>` to directly refer to your home folder. For example, the following setting will launch the "Ubuntu-20.04" distribution in its home file path:
By default, the `startingDirectory` of a profile is `%USERPROFILE%` (`C:\Users\<YourUsername>`). This is a Windows path. For WSL distributions, the file systems can now be directly referenced, as of Windows Terminal [version 1.11.2921.0](https://github.com/microsoft/terminal/releases/tag/v1.11.2921.0). You can use `/home/<Your Ubuntu Username>` to directly refer to your home folder. For example, the following setting will launch the "Ubuntu-20.04" distribution in its home file path:

```json
{
Expand All @@ -40,8 +40,6 @@ If you are using an earlier version of Windows Terminal, WSL may require using t
}
```

> [!IMPORTANT]
> On newer versions of Windows, `startingDirectory` can accept Linux-style paths.

## Setting the tab title

Expand Down