Signed-off-by: Michael Rappazzo <rappazzo@xxxxxxxxx> --- README.md | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000000..adf7a0ba85 --- /dev/null +++ b/README.md @@ -0,0 +1,63 @@ +# gitk - The Git Repository Browser + +This is the official repository for gitk, a graphical Git repository browser. + +## Repository Status + +- **Official Repository**: https://github.com/j6t/gitk +- **Integration**: This repository is regularly merged into the main Git repository (git.git) via subtree merges into the `gitk-git/` subdirectory + +## 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`). + +### Email Patches +- Create patches from this repository (github.com/j6t/gitk), not from the `gitk-git/` subdirectory in git.git +- Send patches to the Git mailing list: git@xxxxxxxxxxxxxxx and CC the maintainer: j6t@xxxxxxxx +- Follow the Git project's patch submission guidelines +- Include `[PATCH gitk]` in the subject line + +#### Creating and Sending Patches +After committing your changes: +```bash +git format-patch -1 --subject-prefix="PATCH gitk" +git send-email --to=git@xxxxxxxxxxxxxxx --cc=j6t@xxxxxxxx *.patch +``` + +For `git send-email` configuration, see the [documentation](https://git-scm.com/docs/git-send-email) (search for "Examples of SMTP Servers"). + +For information about subscribing to the Git mailing list, see [subscription info](https://git.wiki.kernel.org/index.php/GitCommunity). Note that subscription is not required to participate in patch discussions. + +### GitHub Pull Requests +- Fork this repository and create a feature branch +- Submit a pull request with a clear description of your changes + +## Building + +gitk is a Tcl/Tk application. It requires Tcl/Tk to be installed on your system. + +### Running directly +```bash +./gitk +``` + +### Installation +To install system-wide, you can use either `make` or `meson`: + +```bash +# Using Make +make install + +# 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. + +## License + +gitk is distributed under the GNU General Public License, either version 2, or (at your option) any later version. \ No newline at end of file -- 2.51.0
