From 1f5f48c10961240b03676b728ff947376425fa1a Mon Sep 17 00:00:00 2001 From: Galen Elias Date: Sun, 23 Jun 2019 16:20:56 -0700 Subject: [PATCH] Augment README, finish more branding changes. --- GoToFile/GoToFileVSIX/GoToFileVSIX.csproj | 2 +- GoToFileUi/PackageCommands.vsct | 4 +- README.md | 60 +++++++++++++++++++++-- 3 files changed, 60 insertions(+), 6 deletions(-) diff --git a/GoToFile/GoToFileVSIX/GoToFileVSIX.csproj b/GoToFile/GoToFileVSIX/GoToFileVSIX.csproj index df16f85..cc1b224 100644 --- a/GoToFile/GoToFileVSIX/GoToFileVSIX.csproj +++ b/GoToFile/GoToFileVSIX/GoToFileVSIX.csproj @@ -13,7 +13,7 @@ {82b43b9b-a64c-4715-b499-d71e9ca2bd60};{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC} Library VSIXProject - GoToFile + FastGoToFile v4.5 512 false diff --git a/GoToFileUi/PackageCommands.vsct b/GoToFileUi/PackageCommands.vsct index 677e61c..ea753fc 100644 --- a/GoToFileUi/PackageCommands.vsct +++ b/GoToFileUi/PackageCommands.vsct @@ -74,14 +74,14 @@ diff --git a/README.md b/README.md index 4fa1eef..bb8d3fd 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,67 @@ -# GoToFile +# FastGoToFile Visual Studio extension for quickly jumping to a file in the solution -This is a fork of the [Open Now!](http://nemesis.thewavelength.net/index.php?p=56) Visual Studio extension by Ryan Gregg ([Visual Studio Marketplace link](https://marketplace.visualstudio.com/items?itemName=Nem.OpenNow)). Open Now! stopped working with Visual Studio 2019, and isn't very actively maintained, so I decided to make my own copy so I could tweak it to my heart's content. +This is a fork of the [Open Now!](https://marketplace.visualstudio.com/items?itemName=Nem.OpenNow) Visual Studio extension by Ryan Gregg. Open Now! stopped working with Visual Studio 2019, and isn't very actively maintained, so I decided to make my own copy so I could start making tweaks and improvements. -Features: +So far, the changes from Open Now! are: +* Works with Visual Studio 2019 +* Fixed many significant memory leaks +* Made numerous performance fixes + +## Extension Features: * Open files in Visual Studio or view them in Windows Explorer. +* Open files from an optional user selectable directory. * Force open files in code view (instead of designer view which some file types default to). * Filter and sort by file name, file path, project name and project path. * Filter using wildcards. * Retain settings between uses. * Fast responsive interface. +* Open complementary file for cycling between header/source, and other related files (this command is hidden by default). * Open source. + +## Special Characters: + +There are a number of special characters that can prefix search terms. You can string several special characters together to create more advanced terms. The actual search string starts after the first invalid special character or opening quote. These special characters are: + +The ampersand (&) specifies that the search string should be combined with a logical "and". (Note, this is the default implicit behavior - you probably wont even need to type an ampersand). +The vertical bar (|) specifies that the search string should be combined with a logical "or". +The hyphon (-) and apostrophe (!) specify that the search string should be negated. +The backward slash (\) or forward slash (/) specify that the whole file or project path should be searched, not just the file or project name. +The colon (:) specifies that the project or project path should be searched and not the file name or file path. +The double quote (") can be used to surround the above special characters (or spaces) to effectively "escape" them. +The asterisk (*) can be used as a multi character wildcard. +The question mark (?) can be used as a single character wildcard. + +### Special Character Examples: + +| Example | Description | +| ------- | ----------- | +| substring .h | Find all files containing substring in all .h files. +| substring |.cpp |.h | Find all files containing substring in all .cpp and .h files. +| substring -.h | Find all files containing substring in all files except .h files. +| substring -.cpp -.h | Find all files containing substring in all files except .cpp and .h files. +| substring \\\\include\\ | Find all files containing substring in any folder called include. +| substring :\"header files" | Find all files containing substring in any filter containing header files. +| :substring | Find all files in any project containing substring. +| substring *.h | Find all files containing substring in all files ending in .h. + + +## FAQ + +#### I've installed FastGoToFile, where can I find it? +By default, FastGoToFile will create a command called "Fast Go To File..." under your "Tools" menu. The default shortcut is Ctrl+Shift+Alt+O. + +#### How can I change the shortcut to FastGoToFile? + +To change the shortcut to FastGoToFile: + +1. Open Visual Studio. +2. Select "Tools" then "Options...". +3. Select "Environment" -> "Keyboard". +4. Type "FastGoTo" under "Show commands containing:". +5. Select "Tools.FastGoToFile". +6. Press "Remove" to remove the old shortcut (commands can have multiple shortcuts). +7. Type your new shortcut under "Press shortcut keys:". + a. Recommended shortcut is "Ctrl+Shift+Alt+O", which by default is bound to 'File.OpenFolder' +8. Press "Assign" to add the new shortcut. +9. Press "OK" then "Close".