From 2fab61013b6ddeb8173f96e677c97df000684515 Mon Sep 17 00:00:00 2001 From: Greg Van Liew Date: Fri, 13 Apr 2018 13:48:01 -0700 Subject: [PATCH] Consistency for macOS Fixes #1561 --- CONTRIBUTING.md | 2 +- README.md | 2 +- docs/editor/accessibility.md | 2 +- docs/editor/codebasics.md | 2 +- docs/editor/debugging.md | 2 +- docs/editor/extension-gallery.md | 2 +- docs/editor/integrated-terminal.md | 4 ++-- docs/editor/tasks-appendix.md | 2 +- docs/editor/tasks-v1-appendix.md | 2 +- docs/editor/tasks-v1.md | 2 +- docs/editor/tasks.md | 2 +- docs/editor/versioncontrol.md | 4 ++-- docs/editor/whyvscode.md | 2 +- docs/extensionAPI/extension-points.md | 4 ++-- docs/extensionAPI/patterns-and-principles.md | 9 +++------ docs/extensions/developing-extensions.md | 2 +- docs/extensions/example-hello-world.md | 2 +- docs/extensions/example-word-count.md | 2 +- docs/extensions/testing-extensions.md | 3 +-- docs/extensions/themes-snippets-colorizers.md | 2 +- docs/extensions/yocode.md | 2 +- docs/getstarted/keybindings.md | 4 ++-- docs/getstarted/settings.md | 4 ++-- docs/getstarted/themes.md | 4 ++-- docs/getstarted/userinterface.md | 14 +++++++------- docs/languages/java.md | 2 +- docs/languages/tsql.md | 2 +- docs/other/dotnet.md | 2 +- docs/python/editing.md | 2 +- docs/python/environments.md | 7 +++++-- docs/python/linting.md | 2 +- docs/setup/mac.md | 16 ++++++++-------- docs/setup/setup-overview.md | 6 +++--- docs/supporting/faq.md | 4 ++-- release-notes/v0_8_0.md | 2 +- release-notes/v1_19.md | 2 +- release-notes/v1_6.md | 2 +- 37 files changed, 65 insertions(+), 66 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index cc1fe9503a..cb95cbf330 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -135,7 +135,7 @@ When you link to an image, the path and filename are case-sensitive. The conven ### Key bindings -The VS Code portal is able to show the correct key bindings depending on the reader's operating system (Mac, Windows or Linux). +The VS Code portal is able to show the correct key bindings depending on the reader's operating system (macOS, Windows or Linux). To enable this for keyboard shortcuts, use the format `kb(workbench.action.files.openFile)` where the command name is included in parentheses. diff --git a/README.md b/README.md index 507e597d3e..ef27ef1b40 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ If you are looking for the VS Code product GitHub repository, you can find it [h ## Visual Studio Code -[VS Code](https://code.visualstudio.com/) is a lightweight but powerful development environment for building and debugging modern web and cloud applications. It is free and available on your favorite platform - Linux, Mac and Windows. +[VS Code](https://code.visualstudio.com/) is a lightweight but powerful development environment for building and debugging modern web and cloud applications. It is free and available on your favorite platform - Linux, macOS and Windows. If you landed here looking for other information about VS Code, head over to [our website](https://code.visualstudio.com) for additional information. diff --git a/docs/editor/accessibility.md b/docs/editor/accessibility.md index f8ac812693..224f21ccc7 100644 --- a/docs/editor/accessibility.md +++ b/docs/editor/accessibility.md @@ -93,7 +93,7 @@ VS Code has some known accessibility issues depending on the platform. You can not use the keyboard (right, left arrow keys) to move between top-level menu items (**File**, **Edit**, **View**, etc). This is due to Electron issue [#2504](https://github.com/atom/electron/issues/2504). -### Mac +### macOS There is limited screen reader support for the editor with VoiceOver. diff --git a/docs/editor/codebasics.md b/docs/editor/codebasics.md index 297d18ea98..15129e84d5 100644 --- a/docs/editor/codebasics.md +++ b/docs/editor/codebasics.md @@ -63,7 +63,7 @@ Place the cursor in one corner and then hold `kbstyle(Shift+Alt)` while dragging Note: This changes to `kbstyle(Shift+Ctrl/Cmd)` when using `kbstyle(Ctrl/Cmd)` as [multi-cursor modifier](#multi-cursor-modifier). -There are also default key bindings for column selection on Mac and Windows, but not on Linux. +There are also default key bindings for column selection on macOS and Windows, but not on Linux. Key|Command|Command id ---|-------|---------- diff --git a/docs/editor/debugging.md b/docs/editor/debugging.md index f901671729..cb0a6efd0b 100644 --- a/docs/editor/debugging.md +++ b/docs/editor/debugging.md @@ -384,7 +384,7 @@ To write your own debugger extension, visit: **Q: What are the supported debugging scenarios?** -**A:** Debugging of Node.js based applications is supported on Linux, Mac, and Windows out of the box with VS Code. Many other scenarios are supported by [VS Code extensions](https://marketplace.visualstudio.com/vscode/Debuggers?sortBy=Downloads) available on the Marketplace. +**A:** Debugging of Node.js based applications is supported on Linux, macOS, and Windows out of the box with VS Code. Many other scenarios are supported by [VS Code extensions](https://marketplace.visualstudio.com/vscode/Debuggers?sortBy=Downloads) available on the Marketplace. **Q: I do not see any launch configurations in the debug view drop down, what is wrong?** diff --git a/docs/editor/extension-gallery.md b/docs/editor/extension-gallery.md index c3f07d4664..3c8b2b9a86 100644 --- a/docs/editor/extension-gallery.md +++ b/docs/editor/extension-gallery.md @@ -183,7 +183,7 @@ Once you've downloaded an extension, you can side load it by renaming the `.zip` **A**: Extensions are installed in your extensions folders. Depending on your platform, the global location is in the following folders: * **Windows** `%USERPROFILE%\.vscode\extensions` -* **Mac** `~/.vscode/extensions` +* **macOS** `~/.vscode/extensions` * **Linux** `~/.vscode/extensions` **Q: Can VS Code read TextMate bundles directly?** diff --git a/docs/editor/integrated-terminal.md b/docs/editor/integrated-terminal.md index 390e6cad9a..825756d786 100644 --- a/docs/editor/integrated-terminal.md +++ b/docs/editor/integrated-terminal.md @@ -158,13 +158,13 @@ This can be configured using the `terminal.integrated.rightClickBehavior` settin The Integrated Terminal has basic find functionality which can be triggered with `kb(workbench.action.terminal.focusFindWidget)`. -If you want `Ctrl+F` to go to the shell instead of launching the Find widget on Linux and Windows, you will need to remove the keybinding like so: +If you want `kbstyle(Ctrl+F)` to go to the shell instead of launching the Find widget on Linux and Windows, you will need to remove the keybinding like so: ```js // Windows/Linux { "key": "ctrl+f", "command": "-workbench.action.terminal.focusFindWidget", "when": "terminalFocus" }, -// Mac +// macOS { "key": "cmd+f", "command": "-workbench.action.terminal.focusFindWidget", "when": "terminalFocus" }, ``` diff --git a/docs/editor/tasks-appendix.md b/docs/editor/tasks-appendix.md index fcb1ca18d7..fa61da1bcf 100644 --- a/docs/editor/tasks-appendix.md +++ b/docs/editor/tasks-appendix.md @@ -28,7 +28,7 @@ interface TaskConfiguration extends BaseTaskConfiguration { windows?: BaseTaskConfiguration; /** - * Mac specific task configuration + * macOS specific task configuration */ osx?: BaseTaskConfiguration; diff --git a/docs/editor/tasks-v1-appendix.md b/docs/editor/tasks-v1-appendix.md index 75e9a370a4..a4c711eb57 100644 --- a/docs/editor/tasks-v1-appendix.md +++ b/docs/editor/tasks-v1-appendix.md @@ -28,7 +28,7 @@ interface TaskConfiguration extends BaseTaskConfiguration { windows?: BaseTaskConfiguration; /** - * Mac specific task configuration + * macOS specific task configuration */ osx?: BaseTaskConfiguration; diff --git a/docs/editor/tasks-v1.md b/docs/editor/tasks-v1.md index 05d69a0add..f63f6f84f0 100644 --- a/docs/editor/tasks-v1.md +++ b/docs/editor/tasks-v1.md @@ -191,7 +191,7 @@ Below is an example that uses the Node.js executable as a command and is treated } ``` -Valid operating properties are `windows` for Windows, `linux` for Linux and `osx` for Mac. Properties defined in an operating system specific scope override properties defined in the global scope. +Valid operating properties are `windows` for Windows, `linux` for Linux and `osx` for macOS. Properties defined in an operating system specific scope override properties defined in the global scope. In the example below: diff --git a/docs/editor/tasks.md b/docs/editor/tasks.md index 7f69e01c5e..b5f190e8ee 100644 --- a/docs/editor/tasks.md +++ b/docs/editor/tasks.md @@ -489,7 +489,7 @@ If you only need to tweak it for a specific task then add the OS specific comman } ``` -If the task is execute in `PowerShell` the command needs to read like this `chcp 866; more russian.txt`. Under Linux and Mac the `locale` command can be used to inspect the locale and tweak the necessary environment variables. +If the task is execute in `PowerShell`, the command needs to read like this `chcp 866; more russian.txt`. On Linux and macOS, the `locale` command can be used to inspect the locale and tweak the necessary environment variables. ## Examples of tasks in action diff --git a/docs/editor/versioncontrol.md b/docs/editor/versioncontrol.md index 986d868f05..3ec32034b3 100644 --- a/docs/editor/versioncontrol.md +++ b/docs/editor/versioncontrol.md @@ -59,7 +59,7 @@ If there is no upstream branch configured and the Git repository has remotes set **Staging** and **unstaging** can be done via contextual actions in the files or by drag-and-drop. -You can type a commit message above the changes and press `kbstyle(Ctrl+Enter)` (Mac: `kbstyle(⌘+Enter)`) to commit them. If there are any staged changes, only those will be committed, otherwise all changes will be committed. +You can type a commit message above the changes and press `kbstyle(Ctrl+Enter)` (macOS: `kbstyle(⌘+Enter)`) to commit them. If there are any staged changes, only those will be committed, otherwise all changes will be committed. We've found this to be a great workflow. For example, in the previous screenshot, only the `config.js` file will be included in the commit. A consecutive commit action would commit both `vinyl-zip.js` and `tests.js` in a separate commit. @@ -141,7 +141,7 @@ Here are the steps to do so: 1. Make sure you can run `code --help` from the command line and you get help. * if you do not see help, please follow these steps: - * Mac: Select **Shell Command: Install 'Code' command in path** from the **Command Palette**. + * macOS: Select **Shell Command: Install 'Code' command in path** from the **Command Palette**. * Windows: Make sure you selected **Add to PATH** during the installation. * Linux: Make sure you installed Code via our new .deb or .rpm packages. 2. From the command line, run `git config --global core.editor "code --wait"` diff --git a/docs/editor/whyvscode.md b/docs/editor/whyvscode.md index 6cf15dcf7e..f72e7070e1 100644 --- a/docs/editor/whyvscode.md +++ b/docs/editor/whyvscode.md @@ -17,7 +17,7 @@ First and foremost, it is an editor that gets out of your way. The delightfully Visual Studio Code supports macOS, Linux, and Windows - so you can hit the ground running, no matter the platform. -![Visual Studio Code runs on Mac, Linux and Windows](images/whyvscode/macwinlinux2.png) +![Visual Studio Code runs on macOS, Linux and Windows](images/whyvscode/macwinlinux2.png) ## Edit, build, and debug with ease diff --git a/docs/extensionAPI/extension-points.md b/docs/extensionAPI/extension-points.md index 8ea198848c..8f3ffcf7f6 100644 --- a/docs/extensionAPI/extension-points.md +++ b/docs/extensionAPI/extension-points.md @@ -215,13 +215,13 @@ Contribute a key binding rule defining what command should be invoked when the u Contributing a key binding will cause the Default Keyboard Shortcuts to display your rule, and every UI representation of the command will now show the key binding you have added. And, of course, when the user presses the key combination the command will be invoked. ->**Note:** Because VS Code runs on Windows, Mac and Linux, where modifiers differ, you can use "key" to set the default key combination and overwrite it with a specific platform. +>**Note:** Because VS Code runs on Windows, macOS and Linux, where modifiers differ, you can use "key" to set the default key combination and overwrite it with a specific platform. >**Note:** When a command is invoked (from a key binding or from the Command Palette), VS Code will emit an activationEvent `onCommand:${command}`. ### Example -Defining that `kbstyle(Ctrl+F1)` under Windows and Linux and `kbstyle(Cmd+F1)` under Mac trigger the `"extension.sayHello"` command: +Defining that `kbstyle(Ctrl+F1)` under Windows and Linux and `kbstyle(Cmd+F1)` under macOS trigger the `"extension.sayHello"` command: ```json "contributes": { diff --git a/docs/extensionAPI/patterns-and-principles.md b/docs/extensionAPI/patterns-and-principles.md index b4c6b8761c..a8d7530d78 100644 --- a/docs/extensionAPI/patterns-and-principles.md +++ b/docs/extensionAPI/patterns-and-principles.md @@ -83,7 +83,7 @@ Events in the VS Code API are exposed as functions which you call with a listene ```javascript var listener = function(event) { - console.log("It happened", event); + console.log("It happened", event); }; // start listening @@ -124,11 +124,8 @@ You can create a `.vscodeignore` file to exclude some files from being included **Q: Can I use native Node.js modules with my extension?** -**A:** A Visual Studio Code extension package contains all of its dependencies. This means that if you develop your extension on Windows and depend on a native Node.js module when you publish that extension, the Windows compiled native dependency will be contained in your extension. Users on Mac or Linux won't be able to use the extension. +**A:** A Visual Studio Code extension package contains all of its dependencies. This means that if you develop your extension on Windows and depend on a native Node.js module when you publish that extension, the Windows compiled native dependency will be contained in your extension. Users on macOS or Linux won't be able to use the extension. -The only way to make this work for now is to include binaries for all four platforms of VS Code (Windows x86 and x64, Linux, Mac) in your extension and have code that dynamically loads the right one. +The only way to make this work for now is to include binaries for all four platforms of VS Code (Windows x86 and x64, Linux, macOS) in your extension and have code that dynamically loads the right one. We don't recommend extensions use native `npm` modules as native modules bundled with an extension must be recompiled with every new version of VS Code against the same Node.js version that VS Code ships with. You can find the Node.js and module versions by running `process.versions` from the developer tools console (**Help** > **Toggle Developer Tools**). - - - diff --git a/docs/extensions/developing-extensions.md b/docs/extensions/developing-extensions.md index 57ce344756..e67426b45a 100644 --- a/docs/extensions/developing-extensions.md +++ b/docs/extensions/developing-extensions.md @@ -80,7 +80,7 @@ compilation. When the compilation is complete with no errors, you must reload th your changes. You have two options to do this: * Click on the Debug view **Restart** action to relaunch the **Extension Development Host** window. -* Press `kbstyle(Ctrl+R)` (Mac: `kbstyle(Cmd+R)`) in the Extension Development Host window. +* Press `kbstyle(Ctrl+R)` (macOS: `kbstyle(Cmd+R)`) in the Extension Development Host window. ## Profiling your extension diff --git a/docs/extensions/example-hello-world.md b/docs/extensions/example-hello-world.md index 4b03d8e2d3..867ab31fe4 100644 --- a/docs/extensions/example-hello-world.md +++ b/docs/extensions/example-hello-world.md @@ -247,7 +247,7 @@ Create a file (**File** > **New File**), type some text and select it. When you So far, the extension you have written only runs in a special instance of VS Code, the Extension Development instance. To get your extension running in all instances of VS Code, you need to copy it to a new folder under your local extensions folder: * Windows: `%USERPROFILE%\.vscode\extensions` -* Mac/Linux: `$HOME/.vscode/extensions` +* macOS/Linux: `$HOME/.vscode/extensions` ## Publishing your extension diff --git a/docs/extensions/example-word-count.md b/docs/extensions/example-word-count.md index 2bd560f0ea..44b874625c 100644 --- a/docs/extensions/example-word-count.md +++ b/docs/extensions/example-word-count.md @@ -49,7 +49,7 @@ code . Before we go on, we can run the extension to make sure everything works as expected by pressing `kb(workbench.action.debug.start)`. As you saw in the previous "Hello World" walkthrough, VS Code opens another window (the **[Extension Development Host]** window) in which your extension will be loaded. You should find the "Hello World" command in the Command Palette (press `kb(workbench.action.showCommands)`) and when you select it, you will see an information box at the top of the window saying "Hello World". -Now that you have confirmed that the extension is running properly, you can keep the extension development window open if you like. To test out any changes that you make to your extension, you can either press `kb(workbench.action.debug.continue)` again in the development window or reload the extension development window by pressing `kbstyle(Ctrl+R)` (Mac: `kbstyle(Cmd+R)`). +Now that you have confirmed that the extension is running properly, you can keep the extension development window open if you like. To test out any changes that you make to your extension, you can either press `kb(workbench.action.debug.continue)` again in the development window or reload the extension development window by pressing `kbstyle(Ctrl+R)` (macOS: `kbstyle(Cmd+R)`). ## Update the Status Bar diff --git a/docs/extensions/testing-extensions.md b/docs/extensions/testing-extensions.md index 0bdbdf97a6..993036045c 100644 --- a/docs/extensions/testing-extensions.md +++ b/docs/extensions/testing-extensions.md @@ -120,8 +120,7 @@ script: - npm test --silent ``` -The script above will run the tests on both Linux and Mac. Note that in order to run the tests on Linux, you need to have -a `before_install` configuration as above to enable Linux to start VS Code from the build. +The script above will run the tests on both Linux and macOS. Note that in order to run the tests on Linux, you need to have a `before_install` configuration as above to enable Linux to start VS Code from the build. There are some optional environment variables to configure the test runner: diff --git a/docs/extensions/themes-snippets-colorizers.md b/docs/extensions/themes-snippets-colorizers.md index fe4e3ec3d2..d976c36636 100644 --- a/docs/extensions/themes-snippets-colorizers.md +++ b/docs/extensions/themes-snippets-colorizers.md @@ -313,7 +313,7 @@ If you want to share user snippets, you'll need to package your snippet json fil Depending on your platform, your user snippets file is located here: - **Windows** `%APPDATA%\Code\User\snippets\(language).json` -- **Mac** `$HOME/Library/Application Support/Code/User/snippets/(language).json` +- **macOS** `$HOME/Library/Application Support/Code/User/snippets/(language).json` - **Linux** `$HOME/.config/Code/User/snippets/(language).json` where `(language).json` depends on the targeted language of the snippets (e.g. `markdown.json` for Markdown snippets). Create a new folder for your extension and copy your snippet file to a `snippets` subdirectory. diff --git a/docs/extensions/yocode.md b/docs/extensions/yocode.md index ac9880ab09..faf65990a8 100644 --- a/docs/extensions/yocode.md +++ b/docs/extensions/yocode.md @@ -105,7 +105,7 @@ Once created, open VS Code on the created folder and run the extension to test t To load an extension, you need to copy the files to your VS Code extensions folder `.vscode/extensions`. Depending on your platform, it is located in the following folders: * **Windows** `%USERPROFILE%\.vscode\extensions` -* **Mac** `~/.vscode/extensions` +* **macOS** `~/.vscode/extensions` * **Linux** `~/.vscode/extensions` If you want to load your extension each time VS Code runs, copy your project ('side loading') to a new folder under `.vscode/extensions`. For example: `~/.vscode/extensions/myextension`. diff --git a/docs/getstarted/keybindings.md b/docs/getstarted/keybindings.md index f4b59d1e76..5b5f2e0d2a 100644 --- a/docs/getstarted/keybindings.md +++ b/docs/getstarted/keybindings.md @@ -16,7 +16,7 @@ Visual Studio Code lets you perform most tasks directly from the keyboard. This ## Keyboard Shortcuts Editor -Visual Studio Code provides a rich and easy keyboard shortcuts editing experience using **Keyboard Shortcuts** editor. It lists all available commands with and without keybindings and you can easily change / remove / reset their keybindings using the available actions. It also has a search box on the top that helps you in finding commands or keybindings. You can open this editor by going to the menu under **File** > **Preferences** > **Keyboard Shortcuts**. (**Code** > **Preferences** > **Keyboard Shortcuts** on Mac) +Visual Studio Code provides a rich and easy keyboard shortcuts editing experience using **Keyboard Shortcuts** editor. It lists all available commands with and without keybindings and you can easily change / remove / reset their keybindings using the available actions. It also has a search box on the top that helps you in finding commands or keybindings. You can open this editor by going to the menu under **File** > **Preferences** > **Keyboard Shortcuts**. (**Code** > **Preferences** > **Keyboard Shortcuts** on macOS) ![Keyboard Shortcuts](images/keybinding/keyboard-shortcuts.gif) @@ -110,7 +110,7 @@ The following modifiers are accepted: Platform|Modifiers --|--------- -Mac|`kbstyle(ctrl+)`, `kbstyle(shift+)`, `kbstyle(alt+)`, `kbstyle(cmd+)` +macOS|`kbstyle(ctrl+)`, `kbstyle(shift+)`, `kbstyle(alt+)`, `kbstyle(cmd+)` Windows|`kbstyle(ctrl+)`, `kbstyle(shift+)`, `kbstyle(alt+)`, `kbstyle(win+)` Linux|`kbstyle(ctrl+)`, `kbstyle(shift+)`, `kbstyle(alt+)`, `kbstyle(meta+)` diff --git a/docs/getstarted/settings.md b/docs/getstarted/settings.md index c862daab3a..f5ccda9f01 100644 --- a/docs/getstarted/settings.md +++ b/docs/getstarted/settings.md @@ -66,7 +66,7 @@ Below is a [copy of the default settings](/docs/getstarted/settings.md#default-s Depending on your platform, the user settings file is located here: * **Windows** `%APPDATA%\Code\User\settings.json` -* **Mac** `$HOME/Library/Application Support/Code/User/settings.json` +* **macOS** `$HOME/Library/Application Support/Code/User/settings.json` * **Linux** `$HOME/.config/Code/User/settings.json` The workspace setting file is located under the `.vscode` folder in your root folder. @@ -1558,7 +1558,7 @@ Below are the Visual Studio Code default settings and their values. You can also **Q: VS Code says "Unable to write settings."** -**A:** If you try to change a setting (for example turning on Auto Save or selecting a new Color Theme) and you see "Unable to write settings. Please open User Settings to correct errors/warnings in the file and try again.", it means your `settings.json` file is ill-formed or has errors. The errors can be as simple as a missing comma or setting value. Open the Settings editor **File** > **Preferences** > **Settings** (**Code** > **Preferences** > **Settings** on Mac) (`kb(workbench.action.openGlobalSettings)`) and you should see the error highlighted with red squiggles. +**A:** If you try to change a setting (for example turning on Auto Save or selecting a new Color Theme) and you see "Unable to write settings. Please open User Settings to correct errors/warnings in the file and try again.", it means your `settings.json` file is ill-formed or has errors. The errors can be as simple as a missing comma or setting value. Open the Settings editor **File** > **Preferences** > **Settings** (**Code** > **Preferences** > **Settings** on macOS) (`kb(workbench.action.openGlobalSettings)`) and you should see the error highlighted with red squiggles. **Q: When does it make sense to use workspace settings?** diff --git a/docs/getstarted/themes.md b/docs/getstarted/themes.md index 6472dd3864..5ee404ef5b 100644 --- a/docs/getstarted/themes.md +++ b/docs/getstarted/themes.md @@ -25,7 +25,7 @@ The current color theme is configured in the [settings](/docs/getstarted/setting However, there is no need to edit the settings directly. It's easier to use the Color Theme Picker to preview and select a theme. -1. Open the Color Theme picker with **File** > **Preferences** > **Color Theme**. (**Code** > **Preferences** > **Color Theme** on Mac) +1. Open the Color Theme picker with **File** > **Preferences** > **Color Theme**. (**Code** > **Preferences** > **Color Theme** on macOS) 2. Use the cursor keys to preview the colors of the theme. 3. Select the theme you want and hit `kbstyle(Enter)`. @@ -108,7 +108,7 @@ The current File Icon theme is persisted in your user [settings](/docs/getstarte There is no need to edit the `settings.json` file directly. It is better to use the File Icon Theme picker to preview and select a theme. -1. Open the Icon Theme picker with **File** > **Preferences** > **File Icon Theme**. (**Code** > **Preferences** > **File Icon Theme** on Mac) +1. Open the Icon Theme picker with **File** > **Preferences** > **File Icon Theme**. (**Code** > **Preferences** > **File Icon Theme** on macOS) 2. Use the cursor keys to preview the icons of the theme. 3. Select the theme you want and hit `kbstyle(Enter)`. diff --git a/docs/getstarted/userinterface.md b/docs/getstarted/userinterface.md index 03d0764016..745b1baa49 100644 --- a/docs/getstarted/userinterface.md +++ b/docs/getstarted/userinterface.md @@ -33,18 +33,18 @@ Open files in each editor are displayed with tabbed headers (Tabs) at the top of You can have up to three editors open side by side. If you already have one editor open, there are multiple ways of opening another editor to the side of the existing one: -* `kbstyle(Ctrl)` (Mac: `kbstyle(Cmd)`) click on a file in the Explorer. +* `kbstyle(Ctrl)` (macOS: `kbstyle(Cmd)`) click on a file in the Explorer. * `kb(workbench.action.splitEditor)` to split the active editor into two. * **Open to the Side** from the Explorer context menu on a file. * Click the **Split Editor** button in the upper right of an editor. * Drag and drop a file to the either side of the editor region. -* `kbstyle(Ctrl+Enter)` (Mac: `kbstyle(Cmd+Enter)`) in the **Quick Open** (`kb(workbench.action.quickOpen)`) file list. +* `kbstyle(Ctrl+Enter)` (macOS: `kbstyle(Cmd+Enter)`) in the **Quick Open** (`kb(workbench.action.quickOpen)`) file list. ![Side by Side editing](images/userinterface/sidebyside.png) Whenever you open another file, the editor that is active will display the content of that file. So if you have two editors side by side and you want to open file 'foo.cs' into the right hand editor, make sure that editor is active (by clicking inside it) before opening file 'foo.cs'. -When you have more than one editor open you can switch between them quickly by holding the `kbstyle(Ctrl)` (Mac: `kbstyle('Cmd')`) key and pressing `kbstyle(1)`, `kbstyle(2)`, or `kbstyle(3)`. +When you have more than one editor open you can switch between them quickly by holding the `kbstyle(Ctrl)` (macOS: `kbstyle('Cmd')`) key and pressing `kbstyle(1)`, `kbstyle(2)`, or `kbstyle(3)`. >**Tip:** You can resize editors and reorder them. Drag and drop the editor title area to reposition or resize the editor. @@ -74,9 +74,9 @@ After opening a folder in VS Code, the contents of the folder are shown in the E ![Explorer Menu](images/userinterface/explorer_menu.png) -VS Code works very well with other tools that you might use, especially command-line tools. If you want to run a command-line tool in the context of the folder you currently have open in VS Code, right-click the folder and select **Open in Command Prompt** (or **Open in Terminal** on Mac or Linux). +VS Code works very well with other tools that you might use, especially command-line tools. If you want to run a command-line tool in the context of the folder you currently have open in VS Code, right-click the folder and select **Open in Command Prompt** (or **Open in Terminal** on macOS or Linux). -You can also navigate to the location of a file or folder in the native Explorer by right-clicking on a file or folder and selecting **Reveal in Explorer** (or **Reveal in Finder** on the Mac or **Open Containing Folder** on Linux). +You can also navigate to the location of a file or folder in the native Explorer by right-clicking on a file or folder and selecting **Reveal in Explorer** (or **Reveal in Finder** on the macOS or **Open Containing Folder** on Linux). >**Tip:** Type `kb(workbench.action.quickOpen)` (**Quick Open**) to quickly search and open a file by its name. @@ -164,7 +164,7 @@ Most editor configurations are kept in settings which can be modified directly. * Select **File** > **Preferences** > **Settings** (or press `kb(workbench.action.openGlobalSettings)`) to edit the user `settings.json` file. * To edit workspace settings, select the **WORKSPACE SETTINGS** tab to edit the workspace `settings.json` file. ->**Note for Mac users:** The **Preferences** menu is under **Code** not **File**. For example, **Code** > **Preferences** > **Settings**. +>**Note for macOS users:** The **Preferences** menu is under **Code** not **File**. For example, **Code** > **Preferences** > **Settings**. ![workspace settings](images/userinterface/workspace-settings.png) @@ -286,7 +286,7 @@ Edit your [keybindings](/docs/getstarted/keybindings.md) and add the following: If you liked the behavior of VS Code closing an entire group when closing one editor, you can bind the following in your [keybindings](/docs/getstarted/keybindings.md). -Mac: +macOS: ```json { "key": "cmd+w", "command": "workbench.action.closeEditorsInGroup" } diff --git a/docs/languages/java.md b/docs/languages/java.md index 0853090daf..137c7dc7d6 100644 --- a/docs/languages/java.md +++ b/docs/languages/java.md @@ -11,7 +11,7 @@ MetaDescription: Learn about Visual Studio Code editor features (code completion The Java support in VS Code is provided through [extensions](/docs/editor/extension-gallery.md) and optimized for lightweight Java projects with a simple, modern workflow. Popular extensions in the [Marketplace](https://marketplace.visualstudio.com) provide essential language features such as project support, code completion, linting, debugging, testing, code formatting, snippets, as well as tooling integration including Maven and Tomcat. -> [Download VS Code](/download) - If you haven't downloaded VS Code yet, quickly install for your platform (Windows, Mac, Linux). +> [Download VS Code](/download) - If you haven't downloaded VS Code yet, quickly install for your platform (Windows, macOS, Linux). ## Install Java Extensions diff --git a/docs/languages/tsql.md b/docs/languages/tsql.md index 5a30505080..bcb9e59afa 100755 --- a/docs/languages/tsql.md +++ b/docs/languages/tsql.md @@ -13,7 +13,7 @@ Turn Visual Studio Code into a powerful editor for [Transact-SQL] (T-SQL) devel Connect to SQL databases, type T-SQL code, execute T-SQL code, view results, and save results as JSON or CSV files. While typing T-SQL code, you get rich T-SQL language features like T-SQL IntelliSense (code completion), syntax highlighting, linting, code navigation and code snippets. -> [Download VS Code] - If you haven't downloaded VS Code yet, quickly install for your platform (Linux, Mac or Windows). +> [Download VS Code] - If you haven't downloaded VS Code yet, quickly install for your platform (Linux, macOS or Windows). ## Install T-SQL support diff --git a/docs/other/dotnet.md b/docs/other/dotnet.md index 13cb0c4642..f4ef35cc17 100644 --- a/docs/other/dotnet.md +++ b/docs/other/dotnet.md @@ -13,7 +13,7 @@ MetaTags: --- # Using .NET Core in Visual Studio Code -[.NET Core](https://docs.microsoft.com/en-us/dotnet/articles/welcome) gives you a blazing fast and modular platform for creating server applications that run on Windows, Linux and Mac. Use Visual Studio Code with the C# extension to get a powerful editing experience with full support for C# IntelliSense (smart code completion) and debugging. +[.NET Core](https://docs.microsoft.com/en-us/dotnet/articles/welcome) gives you a blazing fast and modular platform for creating server applications that run on Windows, Linux and macOS. Use Visual Studio Code with the C# extension to get a powerful editing experience with full support for C# IntelliSense (smart code completion) and debugging. ## Getting Started diff --git a/docs/python/editing.md b/docs/python/editing.md index 8f9944e99e..adacb4e862 100644 --- a/docs/python/editing.md +++ b/docs/python/editing.md @@ -34,7 +34,7 @@ To enable IntelliSense for packages that are installed in other, non-standard lo "C:/Program Files (x86)/Google/google_appengine/lib" ] ``` -**Mac/Linux:** +**macOS/Linux:** ```json "python.autoComplete.extraPaths": [ diff --git a/docs/python/environments.md b/docs/python/environments.md index 69b0da48be..6da3194e43 100644 --- a/docs/python/environments.md +++ b/docs/python/environments.md @@ -89,10 +89,13 @@ If Visual Studio Code does not automatically locate an interpreter you want to u For example: - Windows: + ```json "python.pythonPath": "c:/python36/python.exe" ``` -- Mac/Linux: + +- macOS/Linux: + ```json "python.pythonPath": "/home/python36/python" ``` @@ -120,7 +123,7 @@ To use a Python interpreter that's installed in a virtual environment: } ``` - Mac/Linux: + macOS/Linux: ```json { "python.pythonPath": "/home/xxx/dev/ala/venv/bin/python" diff --git a/docs/python/linting.md b/docs/python/linting.md index be49f300c2..3d356e0886 100644 --- a/docs/python/linting.md +++ b/docs/python/linting.md @@ -134,7 +134,7 @@ The Python extension maps pep8 message categories to VS Code categories through ### Command-line arguments and configuration files -Flake8 user options are read from the `.flake8` (Windows) or `~/.config/flake8` (Mac/Linux) file. +Flake8 user options are read from the `.flake8` (Windows) or `~/.config/flake8` (macOS/Linux) file. At the project level, options are read from the `[flake8]` section of a `tox.ini` or `setup.cfg` file. Only the first file is considered. For details, see [flake8 Configuration](http://flake8.pycqa.org/en/latest/user/configuration.html). diff --git a/docs/setup/mac.md b/docs/setup/mac.md index 5836f5c205..ef78b7d195 100644 --- a/docs/setup/mac.md +++ b/docs/setup/mac.md @@ -1,17 +1,17 @@ --- Order: 3 Area: setup -TOCTitle: Mac +TOCTitle: macOS ContentId: EEADB50A-F5E3-41E9-89DA-35F165196691 -PageTitle: Running Visual Studio Code on Mac +PageTitle: Running Visual Studio Code on macOS DateApproved: 4/5/2018 -MetaDescription: Get Visual Studio Code up and running on Mac. +MetaDescription: Get Visual Studio Code up and running on Mac (macOS). --- -# Running VS Code on Mac +# Running VS Code on macOS ## Installation -1. [Download Visual Studio Code](https://go.microsoft.com/fwlink/?LinkID=534106) for Mac. +1. [Download Visual Studio Code](https://go.microsoft.com/fwlink/?LinkID=534106) for macOS. 2. Double-click on the downloaded archive to expand the contents. 3. Drag `Visual Studio Code.app` to the `Applications` folder, making it available in the `Launchpad`. 4. Add VS Code to your Dock by right-clicking on the icon and choosing `Options`, `Keep in Dock`. @@ -23,7 +23,7 @@ You can also run VS Code from the terminal by typing 'code' after adding it to t - Launch VS Code. - Open the **Command Palette** (`kb(workbench.action.showCommands)`) and type 'shell command' to find the **Shell Command: Install 'code' command in PATH** command. -![Mac shell commands](images/mac/shell-command.png) +![macOS shell commands](images/mac/shell-command.png) - Restart the terminal for the new `$PATH` value to take effect. You'll be able to type 'code .' in any folder to start editing files in that folder. @@ -42,7 +42,7 @@ EOF Out of the box VS Code adds actions to navigate in editor history as well as the full Debug tool bar to control the debugger on your Touch Bar: -![Mac Touch Bar](images/mac/touchbar.gif) +![macOS Touch Bar](images/mac/touchbar.gif) ## Updates @@ -50,7 +50,7 @@ VS Code ships monthly [releases](/updates) and supports auto-update when a new r ## Preferences Menu -You can configure VS Code through [settings](/docs/getstarted/settings.md), [color themes](/docs/getstarted/themes.md) and [custom keybindings](/docs/getstarted/keybindings.md) and you will often see mention in our documentation of the **File** > **Preferences** menu group. On a Mac, the **Preferences** menu group is under **Code**, not **File**. +You can configure VS Code through [settings](/docs/getstarted/settings.md), [color themes](/docs/getstarted/themes.md) and [custom keybindings](/docs/getstarted/keybindings.md) and you will often see mention in our documentation of the **File** > **Preferences** menu group. On a macOS, the **Preferences** menu group is under **Code**, not **File**. ## Next Steps diff --git a/docs/setup/setup-overview.md b/docs/setup/setup-overview.md index d6a3ec63c1..a299840e62 100644 --- a/docs/setup/setup-overview.md +++ b/docs/setup/setup-overview.md @@ -14,11 +14,11 @@ Getting up and running with Visual Studio Code is quick and easy. It is a small ## Cross platform -VS Code is a free code editor which runs on the Mac, Linux and Windows operating systems. +VS Code is a free code editor which runs on the macOS, Linux and Windows operating systems. Follow the platform specific guides below: -* [Mac](/docs/setup/mac.md) +* [macOS](/docs/setup/mac.md) * [Linux](/docs/setup/linux.md) * [Windows](/docs/setup/windows.md) @@ -78,7 +78,7 @@ If you'd like to get something running quickly, try the [Node.js tutorial](/docs **Q: How do I know which version I'm running?** -**A:** On Linux and Windows, choose **Help** > **About**. On Mac, use **Code** > **About Visual Studio Code**. +**A:** On Linux and Windows, choose **Help** > **About**. On macOS, use **Code** > **About Visual Studio Code**. **Q: Why is VS Code saying my installation is corrupt?** diff --git a/docs/supporting/faq.md b/docs/supporting/faq.md index 03d0bbfd8c..71a436f477 100644 --- a/docs/supporting/faq.md +++ b/docs/supporting/faq.md @@ -31,7 +31,7 @@ For bugs, feature requests or to contact an extension author, you should use the You can find the VS Code version information in the About dialog box. -On a Mac, go to **Code** > **About Visual Studio Code**. +On macOS, go to **Code** > **About Visual Studio Code**. On Windows and Linux, go to **Help** > **About**. @@ -39,7 +39,7 @@ The VS Code version is the first **Version** number listed and has the version f ## How do I opt out of VS Code auto-updates? -By default, VS Code is set up to auto-update for Mac and Windows users when we release new updates. If you do not want to get automatic updates, you can set the `update.channel` setting from `default` to `none`. +By default, VS Code is set up to auto-update for macOS and Windows users when we release new updates. If you do not want to get automatic updates, you can set the `update.channel` setting from `default` to `none`. To modify the update channel, go to **File** > **Preferences** > **Settings** and add the `update.channel` setting with the value `"none"`. diff --git a/release-notes/v0_8_0.md b/release-notes/v0_8_0.md index c2188d3c17..0461646c7c 100644 --- a/release-notes/v0_8_0.md +++ b/release-notes/v0_8_0.md @@ -37,7 +37,7 @@ Open the Color Theme picker with `File | Preferences | Color Theme` and use the ## Debugging - No Mono Dependency for Node -We have ported the implementation of the Node.js debugging support from C#/Mono to TypeScript/Node.js, eliminating our Mono dependency for debugging Node.js applications on OSX and Linux. +We have ported the implementation of the Node.js debugging support from C#/Mono to TypeScript/Node.js, eliminating our Mono dependency for debugging Node.js applications on macOS and Linux. ## Debugging - Debug Console diff --git a/release-notes/v1_19.md b/release-notes/v1_19.md index b7c61431df..9840f3262a 100644 --- a/release-notes/v1_19.md +++ b/release-notes/v1_19.md @@ -426,7 +426,7 @@ Last but certainly not least, a big *__Thank You!__* to the following folks that * Displaying Repository URL (Git Link) on Extensions Page. [PR #31487](https://github.com/Microsoft/vscode/pull/31487) * [Fabio Spampinato (@fabiospampinato)](https://github.com/fabiospampinato): Uninstall extensions given paths to their .vsix files [PR #34042](https://github.com/Microsoft/vscode/pull/34042) * [Felix Becker (@felixfbecker)](https://github.com/felixfbecker) - * Fix OSX builds [PR #37564](https://github.com/Microsoft/vscode/pull/37564) + * Fix macOS builds [PR #37564](https://github.com/Microsoft/vscode/pull/37564) * Make npm logs less verbose in CI [PR #37566](https://github.com/Microsoft/vscode/pull/37566) * [Joel Kuntz (@Frozenfire92)](https://github.com/Frozenfire92): Fix #39867 fix git popStash type check [PR #39868](https://github.com/Microsoft/vscode/pull/39868) * [Sanders Lauture (@golf1052)](https://github.com/golf1052): Show preview tag on extension page if extension is in preview [PR #36261](https://github.com/Microsoft/vscode/pull/36261) diff --git a/release-notes/v1_6.md b/release-notes/v1_6.md index 90a12e5cad..dc7fbe0f48 100644 --- a/release-notes/v1_6.md +++ b/release-notes/v1_6.md @@ -562,7 +562,7 @@ Last but certainly not least, a big *__Thank You!__* to the following folks that * [Nic Holthaus (@nholthaus)](https://github.com/nholthaus): Add `konsole` as default terminal for KDE-plasma [PR #11452](https://github.com/Microsoft/vscode/pull/11452) * [Paul Oppenheim (@pauloppenheim)](https://github.com/pauloppenheim): vscode-linux-*-build-deb - expected permission bits [PR #11558](https://github.com/Microsoft/vscode/pull/11558) * [@Romanito](https://github.com/Romanito): Enable "Open with Code" on drive roots in Windows Explorer [PR #11870](https://github.com/Microsoft/vscode/pull/11870) -* [@sprinkle131313](https://github.com/sprinkle131313): Fixes debugger config launch for Linux and OSX. [PR #11092](https://github.com/Microsoft/vscode/pull/11092) +* [@sprinkle131313](https://github.com/sprinkle131313): Fixes debugger config launch for Linux and macOS. [PR #11092](https://github.com/Microsoft/vscode/pull/11092) * [@ted-piotrowski](https://github.com/ted-piotrowski): Fix gulp methods for targeting arm systems [PR #12486](https://github.com/Microsoft/vscode/pull/12486) * [Vincenzo Chianese (@XVincentX)](https://github.com/XVincentX) * Provide a changelog tab when this file is bundled in the package [PR #12035](https://github.com/Microsoft/vscode/pull/12035)