From: Junio C Hamano Date: Wed, 10 Sep 2025 21:27:52 +0000 (-0700) Subject: Merge branch 'master' of https://github.com/j6t/gitk X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=f2457a6f4ba4ae8078fa7559f6292786a287f696;p=thirdparty%2Fgit.git Merge branch 'master' of https://github.com/j6t/gitk * 'master' of https://github.com/j6t/gitk: gitk: add README with usage, build, and contribution details gitk: fix trackpad scrolling for Tcl/Tk 8.7+ gitk: use for ctx menus on macOS with Tcl 8.7+ --- f2457a6f4ba4ae8078fa7559f6292786a287f696 diff --cc gitk-git/README.md index 0000000000,0000000000..2e307463c6 new file mode 100644 --- /dev/null +++ b/gitk-git/README.md @@@ -1,0 -1,0 +1,93 @@@ ++Gitk - The Git Repository Browser ++================================= ++ ++Gitk is a graphical Git repository browser. It displays the commit ++history of a Git repository as a graph, showing the relationships ++between commits, branches, and tags. ++ ++Usage ++===== ++ ++To view the history of the current repository: ++```bash ++gitk ++``` ++ ++To view the history of specific files or directories: ++```bash ++gitk path/to/file ++gitk path/to/directory ++``` ++ ++To view a specific branch or range of commits: ++```bash ++gitk branch-name ++gitk v1.0..v2.0 ++``` ++ ++For more usage examples and options, see the [gitk manual](https://git-scm.com/docs/gitk). ++ ++Building ++======== ++ ++Gitk is a Tcl/Tk application. It requires Tcl/Tk to be installed on ++your system. ++ ++Running directly ++---------------- ++ ++Gitk can be run from the source directory without installation: ++ ++```bash ++./gitk ++``` ++ ++This allows for quick testing of changes. ++ ++Installation ++------------ ++ ++To install system-wide, you can use either `make` or `meson`: ++ ++```bash ++# Install to default location ($HOME/bin) ++make install ++ ++# Install to system-wide location ++sudo make install prefix=/usr/local ++ ++# Install to custom location ++make install prefix=/opt/gitk ++ ++# Using Meson ++meson setup builddir ++meson compile -C builddir ++meson install -C builddir ++``` ++ ++Both build systems will handle setting the correct Tcl/Tk interpreter ++path and installing translation files. ++ ++Contributing ++============ ++ ++Contributions are welcome! The preferred method for submitting patches ++is via email to the Git mailing list, as this allows for more thorough ++review and broader community feedback. However, GitHub pull requests ++are also accepted. ++ ++All commits must be signed off (use `git commit --signoff`) and should ++have commit messages prefixed with `gitk:`. ++ ++Email Patches ++------------- ++ ++Send patches to git@vger.kernel.org and CC j6t@kdbg.org. See the Git ++project's [patch submission guidelines](https://git-scm.com/docs/SubmittingPatches) ++for detailed instructions on creating and sending patches. ++ ++License ++======= ++ ++Gitk is distributed under the GNU General Public License, either ++version 2, or (at your option) any later version.