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.

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

Add setting location and categorize issues #4

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
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
47 changes: 32 additions & 15 deletions faq.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,53 @@
# Frequently Asked Questions (FAQ)

#### How to compare two branches (or commits)?
Just select them (hold <kbd>Ctrl</kbd>/<kbd>Cmd</kbd> 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 <kbd>Ctrl</kbd>/<kbd>Alt</kbd> 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 <kbd>Ctrl</kbd>/<kbd>Cmd</kbd> for multiselection)

#### How can I commit and push?
Hold <kbd>Ctrl</kbd>/<kbd>Alt</kbd> 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.