e66f0dcdd6Fetching third-party files inside a make rule is convenient and less error prone since 'make' has access to '$srcdir'. * build-aux/gnu-fetch: Delete. * maint.mk (WGET, git_sv_host, sv_git_am, sv_git_gl) (fetchfiles): New macros. (fetch): New target. * HACKING <Updating auxilary scripts>: Update instructions.
90 lines
2.7 KiB
Text
90 lines
2.7 KiB
Text
These notes intend to help people working on the checked-out sources.
|
|
These requirements do not apply when building from a distribution tarball.
|
|
|
|
* First Git checkout
|
|
|
|
You can get a copy of the source repository like this:
|
|
|
|
$ git clone git://git.sv.gnu.org/mcron
|
|
$ cd mcron
|
|
|
|
The next step is to get and check other files needed to build, which are
|
|
extracted from other source packages:
|
|
|
|
$ ./bootstrap
|
|
|
|
And there you are! Just
|
|
|
|
$ ./configure
|
|
$ make
|
|
|
|
At this point, there should be no difference between your local copy, and the
|
|
Git master copy:
|
|
|
|
$ git diff
|
|
|
|
should output no difference.
|
|
|
|
Enjoy!
|
|
|
|
* Submitting patches
|
|
|
|
If you develop a fix or a new feature, please send it to the appropriate
|
|
bug-reporting address as reported by the --help option of each program. One
|
|
way to do this is to use vc-dwim <http://www.gnu.org/software/vc-dwim/>), as
|
|
follows.
|
|
|
|
Run the command "vc-dwim --help", copy its definition of the
|
|
"git-changelog-symlink-init" function into your shell, and then run this
|
|
function at the top-level directory of the package.
|
|
|
|
Edit the (empty) ChangeLog file that this command creates, creating a
|
|
properly-formatted entry according to the GNU coding standards
|
|
<http://www.gnu.org/prep/standards/html_node/Change-Logs.html>.
|
|
|
|
Make your changes.
|
|
|
|
Run the command "vc-dwim" and make sure its output (the diff of all your
|
|
changes) looks good.
|
|
|
|
Run "vc-dwim --commit".
|
|
|
|
Run the command "git format-patch --stdout -1", and email its output in,
|
|
using the output's subject line.
|
|
|
|
* Updating auxilary scripts
|
|
|
|
Fetch new versions of the files that are maintained in other GNU
|
|
repositories by running "make fetch". In case any file in the
|
|
Mcron repository has been updated, commit and re-run the testsuite.
|
|
|
|
* Code coverage
|
|
|
|
Assuming 'lcov' is installed, it is possible to check the actual code
|
|
coverage achieved by the test suite by running the following commands:
|
|
|
|
$ make check SCM_LOG_DRIVER_FLAGS="--coverage=yes"
|
|
$ genhtml tests/*.info --output-directory out
|
|
|
|
-----
|
|
|
|
Copyright © 2002-2017 Free Software Foundation, Inc.
|
|
Copyright © 2017, 2018 Mathieu Lirzin <mthl@gnu.org>
|
|
|
|
This program 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.
|
|
|
|
This program 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 this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
Local Variables:
|
|
mode: outline
|
|
fill-column: 78
|
|
End:
|