Documentation

gitHub

Questions & Answers

How to work with Git submodules?

Git submodules allow you to keep a Git repository as a subdirectory of another Git repository. This lets you clone another repository into your project while keeping your commits separate.

 

The presence of Git submodules in a repository will not prevent you from using Hackolade Studio. But there is no handling of Git submodules currently in Hackolade Studio.

 

In case Git submodules are important for the handling of your data models, please submit a feature request.

 

How to deal with non-ASCII symbols in file names?

By default, Git replaces non-ASCII symbols in file names with octal notation. For example, a file named "TrainScheduleф.json" will be treated by Git as "TrainSchedule\321\204.json".

 

If you need to deal with non-ASCII symbols in file names, then open a terminal and run the command below in order to modify the default behavior of your local Git client (omit the $ sign in Windows).

 

$ git config core.quotepath off

 

See the official documentation about the Git configuration parameter core.quotepath for more details.

 

Where is my .gitconfig file?

From time to time, you may have to adjust Git configuration parameters.  The problem might be to find the location of the .config file first... You can view all of your settings and where they are coming from using to following command (omit the $ sign in Windows):

$ git config --list --show-origin

 

In Task Manager, I see many orphan background processes for Git for Windows

The issue is not specific to Hackolade and is linked to an experimental feature introduced in Git version 2.31.0.  If selected, Git will use a built-in file-system monitor, without the need to install Watchman.  However, this feature is not yet stable so it is strongly advised to run the following command:

 

For Git versions up to 2.35.x:

$ git config --global core.useBuiltinFSMonitor false

 

 

For Git version 2.36.0 and above:

$ git config --global core.fsmonitor false

 

I'm getting an error core.useBuiltinFSMonitor=true is deprecated

Starting with version 2.36.0, the congif keyword useBuiltinFSMonitor has been deprecated, and replaced by fsmonitor. When opening a repository, if you get the error:

Image

 

The hint is accurate.  You should run the following command at a command prompt (omit the $ sign in Windows):

$ git config --global core.fsmonitor false

 

 

I have GitHub Desktop installed on my machine.  Is it not a Git client?

Be careful that GitHub Desktop, SourceTree and other visual applications are NOT the Git client the we're looking for here.  They are GUI applications also leveraging the system Git executable.  If you specify a custom path, it must be to the Git executable.

 

Workgroup tools options repository

 

With GitHub Desktop, it is possible that the installation did not declare the location of the Git executable in the system PATH.  This is a well documented situation...  Possible locations for the Git executable are:

C:\Program Files\Git\bin\git.exe

C:\Users\%username%\AppData\Local\GitHub\PortableGit_<guid>\cmd\git.exe (GitHub for Windows prior to version 1.1)

C:\Users\%username%\AppData\Local\GitHubDesktop\app-3.0.0\resources\app\git\cmd\git.exe (GitHub Desktop version 1.1 and above)

 

See more info in the pre-requisites page.