diff --git a/faq.md b/faq.md index 075ae61..4ddf057 100644 --- a/faq.md +++ b/faq.md @@ -1,36 +1,53 @@ # Frequently Asked Questions (FAQ) -#### How to compare two branches (or commits)? -Just select them (hold Ctrl/Cmd for multiselection) - -#### I accidentally lost some commits -Use reflog to see lost commits +## General questions #### Do you plan to support Linux No, we don’t plan to support Linux until a decent UI library (comparable to WPF or Cocoa) appears on this platform. -#### How can I commit and push? -Hold Ctrl/Alt when commit +#### Where does Fork save user settings? +Fork's settings are kept in three files: `settings.json`, `accounts.json`, and `custom-commands.json`. Under Windows, those are kept in `%localappdata%\Fork`. + +## Troubleshooting + +### Files #### Git doesn’t recognize my file as a text and Fork doesn’t show the diff This may happen when a file is relatively small or in UTF-16 LE encoding. You can fix this by creating a rule (e.g. `*.sql text`) in `.gitattributes` file. (https://www.git-scm.com/docs/gitattributes) +### Commits and branches + +#### How to compare two branches (or commits)? +Just select them (hold Ctrl/Cmd for multiselection) + +#### How can I commit and push? +Hold Ctrl/Alt when commit + #### How can I push multiple branches at once Select them on the sidebar and call 'Push' from the context menu +#### I have a large repo and Fork shows only 50000 commits +You can configure the limit. +On Mac run `$ defaults write com.danpristupov.fork maxCommitCount 150000` in Terminal. +On Windows edit the `MaxCommitCount` field in the `%localappdata%\Fork\settings.json` file. + +#### I accidentally lost some commits +Use reflog to see lost commits + +### Git-Flow + +#### I can't initialize Git-Flow (Mac) +Probably you removed SourceTree recently and it broke your environment. https://github.com/fork-dev/Tracker/issues/418#issuecomment-425818588 + +### GitHub & GitLab + #### Permission denied when accessing repos in my organization on GitHub Ensure that Fork has access to your organization: https://github.com/settings/connections/applications/166b00df5e7ea4f78d4b #### Receiving a "request requires higher privileges" error when trying to connect to GitLab with personal access token Ensure the token provides access to the following scopes: `read_api`, and `user_api` +### Other + #### The main window is blank (Windows) Most likely you are using VMWare which has a problem with hardware acceleration. You can disable it in Fork config: https://github.com/ForkIssues/TrackerWin/issues/491#issuecomment-546605221 - -#### I can't initialize Git-Flow (Mac) -Probably you removed SourceTree recently and it broke your environment. https://github.com/fork-dev/Tracker/issues/418#issuecomment-425818588 - -#### I have a large repo and Fork shows only 50000 commits -You can configure the limit. -On Mac run `$ defaults write com.danpristupov.fork maxCommitCount 150000` in Terminal. -On Windows edit the `MaxCommitCount` field in the `%localappdata%\fork\settings.json` file.