Documentation

No results
    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.  Even the GitHub Desktop application does not have any special support for submodules...

     

    This article even suggests that a better alternative to Git submodules is to use Git subtrees.

     

    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...  Hackolade Studio has been enhanced to auto-detect the Git executable installed by GitHub Desktop, if in one of its standard locations:  

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

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

     

    If installed elsewhere, like 

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

    you may have to declare the custom path manually.

     

    See more info in the pre-requisites page.