CONTRIBUTE

Copyright (C) 2024 Free Software Foundation, Inc.
See the end of the file for license conditions.

* How developers contribute to Brogw

Here is how software developers can contribute to Brogw.

** The Emacs repository

Brogw development uses Git on GitHub for its main repository.
To configure Git for Brogw development, you can run the following:

	git config --global user.name 'Your Name'
	git config --global user.email 'your.name@example.com'

The following shell commands then build and run Brogw from scratch:

	git clone git://github.com/sergeyklay/brogw.git
	cd brogw
	./autogen.sh
	./configure
	make
	src/brogw

** Getting involved with development

Bug reports and fixes, feature requests and patches/implementations
should be sent to gnu@serghei.pl, the bug/feature list.  If possible,
use issue tracker at <https://github.com/sergeyklay/brogw/issues>.  Be
prepared to receive comments and requests for changes in your patches,
following your submission.

To email a patch you can use a shell command like 'git format-patch -1'
to create a file, and then attach the file to your email.  This nicely
packages the patch's commit message and changes, and makes sure the
format and whitespace are not munged in transit by the various mail
agents.  To send just one such patch without additional remarks, it is
also possible to use a command like

  git send-email --to=gnu@serghei.pl 0001-DESCRIPTION.patch

However, I prefer the 'git format-patch' method with attachment, as
doing so delivers patches in the correct and easily-recognizable format
more reliably, and makes the job of applying the patches easier and less
error-prone.  It also allows sending patches whose author is someone
other than the email sender.


This file is part of Brogw.

Brogw is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your
option) any later version.

Brogw is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License
along with Brogw.  If not, see <https://www.gnu.org/licenses/>.

Local variables:
mode: outline
paragraph-separate: "[ 	]*$"
coding: utf-8
end: