{"thread":{"id":"64009","subject":"[PATCH v2] gitk: add README with usage, build, and contributing details","startedAt":"2025-08-21T22:26:11Z","lastAt":"2025-08-22T20:28:49Z","messageCount":4,"participants":["Michael Rappazzo","Johannes Sixt","Mike Rappazzo","Junio C Hamano"],"isPatch":true,"patchVersion":2,"patchTotal":null},"messages":[{"id":"524689","messageId":"20250821222605.3993-1-rappazzo@gmail.com","threadId":"64009","inReplyTo":null,"subject":"[PATCH v2] gitk: add README with usage, build, and contributing details","fromName":"Michael Rappazzo","fromEmail":"rappazzo@gmail.com","sentAt":"2025-08-21T22:25:49Z","receivedAt":"2025-08-21T22:26:11Z","isPatch":true,"sender":{"key":"rappazzo@gmail.com","avatar":"https://avatars.githubusercontent.com/u/525287?v=4"},"body":"Signed-off-by: Michael Rappazzo <rappazzo@gmail.com>\n---\nChanges from v1:\n - Added Usage section with basic gitk command examples\n - Simplified Contributing section by removing detailed patch workflow instructions\n - Removed repository status and integration details\n\n README.md | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++\n 1 file changed, 61 insertions(+)\n create mode 100644 README.md\n\ndiff --git a/README.md b/README.md\nnew file mode 100644\nindex 0000000000..fd249bc24d\n--- /dev/null\n+++ b/README.md\n@@ -0,0 +1,61 @@\n+# gitk - The Git Repository Browser\n+\n+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.\n+\n+## Usage\n+\n+To view the history of the current repository:\n+```bash\n+gitk\n+```\n+\n+To view the history of specific files or directories:\n+```bash\n+gitk path/to/file\n+gitk path/to/directory\n+```\n+\n+To view a specific branch or range of commits:\n+```bash\n+gitk branch-name\n+gitk v1.0..v2.0\n+```\n+\n+For more usage examples and options, see the [gitk manual](https://git-scm.com/docs/gitk).\n+\n+## Building\n+\n+gitk is a Tcl/Tk application. It requires Tcl/Tk to be installed on your system.\n+\n+### Running directly\n+```bash\n+./gitk\n+```\n+\n+### Installation\n+To install system-wide, you can use either `make` or `meson`:\n+\n+```bash\n+# Using Make\n+make install\n+\n+# Using Meson\n+meson setup builddir\n+meson compile -C builddir\n+meson install -C builddir\n+```\n+\n+Both build systems will handle setting the correct Tcl/Tk interpreter path and installing translation files.\n+\n+## Contributing\n+\n+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.\n+\n+All commits must be signed off (use `git commit --signoff`) and should have commit messages prefixed with `gitk:`.\n+\n+#### Email Patches\n+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.\n+\n+## License\n+\n+gitk is distributed under the GNU General Public License, either version 2, or (at your option) any later version.\n-- \n2.51.0\n\n"},{"id":"524725","messageId":"cef6487f-aab4-421e-ba04-a5613c12e552@kdbg.org","threadId":"64009","inReplyTo":"20250821222605.3993-1-rappazzo@gmail.com","subject":"Re: [PATCH v2] gitk: add README with usage, build, and contributing details","fromName":"Johannes Sixt","fromEmail":"j6t@kdbg.org","sentAt":"2025-08-22T18:27:32Z","receivedAt":"2025-08-22T18:27:42Z","isPatch":true,"sender":{"key":"j6t@kdbg.org","avatar":"https://avatars.githubusercontent.com/u/14810926?v=4"},"body":"Am 22.08.25 um 00:25 schrieb Michael Rappazzo:\n> Signed-off-by: Michael Rappazzo <rappazzo@gmail.com>\n> ---\n> Changes from v1:\n>  - Added Usage section with basic gitk command examples\n>  - Simplified Contributing section by removing detailed patch workflow instructions\n>  - Removed repository status and integration details\n\nThank you very much, this looks a lot better!\n\n> \n>  README.md | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++\n>  1 file changed, 61 insertions(+)\n>  create mode 100644 README.md\n> \n> diff --git a/README.md b/README.md\n> new file mode 100644\n> index 0000000000..fd249bc24d\n> --- /dev/null\n> +++ b/README.md\n> @@ -0,0 +1,61 @@\n> +# gitk - The Git Repository Browser\n\nCan we please write \"Gitk\" (uppercase \"G\") when we talk about the\nsoftware, not the command?\n\nI would prefer an easy to read text file. Can we have underlined headers\nwhere possible:\n\nGitk - The Git Repository Browser\n=================================\n\nAnalogously for the subordinate headers below.\n\n> +\n> +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.\nPlease wrap the lines so that they don't exceed, say, 70 positions.\n\n> +\n> +## Usage\n> +\n> +To view the history of the current repository:\n> +```bash\n> +gitk\n> +```\n> +\n> +To view the history of specific files or directories:\n> +```bash\n> +gitk path/to/file\n> +gitk path/to/directory\n> +```\n> +\n> +To view a specific branch or range of commits:\n> +```bash\n> +gitk branch-name\n> +gitk v1.0..v2.0\n> +```\n> +\n> +For more usage examples and options, see the [gitk manual](https://git-scm.com/docs/gitk).\n> +\n> +## Building\n> +\n> +gitk is a Tcl/Tk application. It requires Tcl/Tk to be installed on your system.\n> +\n> +### Running directly\n\nAt this point we should insert:\n\n    Gitk can be run from the source directory without installation:\n\n> +```bash\n> +./gitk\n> +```\n\n    This is very convenient during development.\n\n> +\n> +### Installation\n> +To install system-wide, you can use either `make` or `meson`:\n> +\n> +```bash\n> +# Using Make\n> +make install\n\nThis doesn't install system-wide, but in $HOME/bin. I am unsure whether\nwe should encourage this. AFAIC, I would be upset if this works without\nsudo *and* clutters my $HOME. (I pull Gitk into the Git repository,\nwhich I have patched to install in /usr/local.)\n\nHow do Gitk contributors handle `make install`?\n\n> +\n> +# Using Meson\n> +meson setup builddir\n> +meson compile -C builddir\n> +meson install -C builddir\n> +```\n\nI haven't used the Meson infrastructure ever. I trust this procedure works.\n\n> +\n> +Both build systems will handle setting the correct Tcl/Tk interpreter path and installing translation files.\n> +\n> +## Contributing\n> +\n> +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.\n> +\n> +All commits must be signed off (use `git commit --signoff`) and should have commit messages prefixed with `gitk:`.\n> +\n> +#### Email Patches\n> +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.\n> +\n> +## License\n> +\n> +gitk is distributed under the GNU General Public License, either version 2, or (at your option) any later version.\n\nVery good!\n\n-- Hannes\n\n"},{"id":"524730","messageId":"CANoM8SW_3dLtQBEcK=NgQWCezj2PNbokDyeaUvVMTN1ufYav_w@mail.gmail.com","threadId":"64009","inReplyTo":"cef6487f-aab4-421e-ba04-a5613c12e552@kdbg.org","subject":"Re: [PATCH v2] gitk: add README with usage, build, and contributing details","fromName":"Mike Rappazzo","fromEmail":"rappazzo@gmail.com","sentAt":"2025-08-22T19:55:10Z","receivedAt":"2025-08-22T19:55:23Z","isPatch":true,"sender":{"key":"rappazzo@gmail.com","avatar":"https://avatars.githubusercontent.com/u/525287?v=4"},"body":"On Fri, Aug 22, 2025 at 2:27 PM Johannes Sixt <j6t@kdbg.org> wrote:\n> > +\n> > +### Installation\n> > +To install system-wide, you can use either `make` or `meson`:\n> > +\n> > +```bash\n> > +# Using Make\n> > +make install\n>\n> This doesn't install system-wide, but in $HOME/bin. I am unsure whether\n> we should encourage this. AFAIC, I would be upset if this works without\n> sudo *and* clutters my $HOME. (I pull Gitk into the Git repository,\n> which I have patched to install in /usr/local.)\n>\n> How do Gitk contributors handle `make install`?\n\nMaybe I should expand on this section and add details:\n```\n# Install to default location ($HOME/bin)\nmake install\n\n# Install to system-wide location\nsudo make install prefix=/usr/local\n\n# Install to custom location\nmake install prefix=/opt/gitk\n```\n\n\n>\n> > +\n> > +# Using Meson\n> > +meson setup builddir\n> > +meson compile -C builddir\n> > +meson install -C builddir\n> > +```\n>\n> I haven't used the Meson infrastructure ever. I trust this procedure works.\n>\n\nYes, I installed `meson` and ran these steps.  It replaced my\npreviously installed version\n\n\nI'll send a new revision in a day or two.\n\nThanks for the look,\n_Mike\n"},{"id":"524732","messageId":"xmqqect3w16o.fsf@gitster.g","threadId":"64009","inReplyTo":"cef6487f-aab4-421e-ba04-a5613c12e552@kdbg.org","subject":"Re: [PATCH v2] gitk: add README with usage, build, and contributing details","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2025-08-22T20:28:47Z","receivedAt":"2025-08-22T20:28:49Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Johannes Sixt <j6t@kdbg.org> writes:\n\n> I would prefer an easy to read text file. Can we have underlined headers\n> where possible:\n>\n> Gitk - The Git Repository Browser\n> =================================\n\nOooh.  Thanks for being brave to say what I couldn't, due to fear of\nbeing in the minority with unpopular preference ;-)\n\n"}]}