From 8a535f3e26ec5835c12d61adf68d45d61d37e8ac Mon Sep 17 00:00:00 2001 From: anaxceron Date: Mon, 2 Oct 2023 14:45:48 -0400 Subject: [PATCH] documenting how to associate languages, file extensions Signed-off-by: anaxceron --- docs/getting-started/zowe_faq.md | 10 ++++++++++ docs/user-guide/ze-usage.md | 28 ++++++++++++++++++++-------- 2 files changed, 30 insertions(+), 8 deletions(-) diff --git a/docs/getting-started/zowe_faq.md b/docs/getting-started/zowe_faq.md index ed91b5804e..986cd29986 100644 --- a/docs/getting-started/zowe_faq.md +++ b/docs/getting-started/zowe_faq.md @@ -423,6 +423,16 @@ Zowe Explorer V2 supports using Service Profiles, Base Profiles, and Team Profil +### Is it possible to change the detected language of a file or data set opened in Zowe Explorer? + +
+ + + +Yes, you can configure Visual Studio Code to use a specific language for a particular file extension. To set file associations, see [Add a file extension to a language](https://code.visualstudio.com/docs/languages/overview#_add-a-file-extension-to-a-language). + +
+ ### How can I use FTP as my back-end service for Zowe Explorer?
diff --git a/docs/user-guide/ze-usage.md b/docs/user-guide/ze-usage.md index 1f1233ba77..06ab352a78 100644 --- a/docs/user-guide/ze-usage.md +++ b/docs/user-guide/ze-usage.md @@ -25,21 +25,33 @@ Review this section to familiarize yourself with Zowe Explorer and make the best ## Usage Tips -Make the best use of the extension with the following tips: +Make the best use of Zowe Explorer with the following tips: -- **Data sets, USS, and jobs persistence settings:** You can store any data sets, USS files, or jobs permanently in the **Favorites** tab. Right-click on a data set, USS file, or job and click **Add Favorite**. +### Data sets, USS, and jobs persistence settings +You can store any data sets, USS files, or jobs permanently in the **Favorites** tab. Right-click on a data set, USS file, or job and click **Add Favorite**. -- **Identify syntax errors with a syntax highlighter:** Zowe Explorer supports a syntax hightlighter for data sets. To enhance the experience of using the extension, you can download an extension that highlights syntax. +### Identify syntax errors with a syntax highlighter +Zowe Explorer supports a syntax hightlighter for data sets. To enhance the experience of using the extension, you can download an extension that highlights syntax. -- **Edit a profile**: You can edit existing profiles listed in the **Side Bar** by clicking the profile's **Edit** icon (next to the **Search** icon). The feature lets you modify the information inside your profile. +### Change the detected language of a file or data set -- **Delete a profile**: In Zowe V1, you can permanently delete profiles by right-clicking the profile and selecting the **Delete Profile** option. The feature deletes the profile from your `.zowe` folder. In Zowe V2, right-click the profile, and select **Delete Profile** to open the configuration file and manually delete the profile. +If the language for a file or data set opened in Zowe Explorer is not detected correctly, configure Visual Studio Code to use a specific language for a particular file extension. To set file associations, see [Add a file extension to a language](https://code.visualstudio.com/docs/languages/overview#_add-a-file-extension-to-a-language). - **Tip:** Alternatively, you can delete a profile by using the VS Code **Command Palette**. Press `F1` on your keyboard, then select the **Zowe Explorer: Delete a Profile Permanently** option. In Zowe V1, you select the profile to delete. In Zowe V2, the configuration file opens for you to delete the profile manually. +### Edit a profile +You can edit existing profiles listed in the **Side Bar** by clicking the profile's **Edit** icon (next to the **Search** icon). The feature lets you modify the information inside your profile. -- **Hide a profile**: You can hide a profile from the **Side Bar** by right-clicking the profile and selecting the **Hide Profile** option. If necessary, add the profile back by clicking the **+** icon on the **DATA SETS**, **UNIX SYSTEM SERVICES (USS)**, or **JOBS** bar. +### Delete a profile +In Zowe V1, you can permanently delete profiles by right-clicking the profile and selecting the **Delete Profile** option. The feature deletes the profile from your `.zowe` folder. In Zowe V2, right-click the profile, and select **Delete Profile** to open the configuration file and manually delete the profile. -- **Open recent members**: Zowe Explorer lets you open a list of members you have previously worked on. You can access the list by pressing `Ctrl`+`Alt`+`R` or `Command`+`Alt`+`R`. +:::tip +Alternatively, you can delete a profile by using the VS Code **Command Palette**. Press `F1` on your keyboard, then select the **Zowe Explorer: Delete a Profile Permanently** option. In Zowe V1, you select the profile to delete. In Zowe V2, the configuration file opens for you to delete the profile manually. +::: + +### Hide a profile +You can hide a profile from the **Side Bar** by right-clicking the profile and selecting the **Hide Profile** option. If necessary, add the profile back by clicking the **+** icon on the **DATA SETS**, **UNIX SYSTEM SERVICES (USS)**, or **JOBS** bar. + +### Open recent members +Zowe Explorer lets you open a list of members you have previously worked on. You can access the list by pressing `Ctrl`+`Alt`+`R` or `Command`+`Alt`+`R`. ## Using a specific version of Zowe Explorer