Name Date Size

..29-Nov-20194 KiB

.gitignoreH A D19-Jul-20191.4 KiB

.gitmodulesH A D13-Aug-201775

.prev-versionH A D01-Jan-20194

AUTHORSH A D01-Jan-20201.6 KiB

bootstrapH A D01-Jan-202032.8 KiB

bootstrap.confH A D01-Jan-20203.9 KiB

cfg.mkH A D01-Jan-20202.6 KiB

ChangeLog-2008H A D01-Jan-2020157.9 KiB

configure.acH A D01-Jan-20205 KiB

COPYINGH A D13-Aug-201734.3 KiB

dist-check.mkH A D13-Aug-20175.7 KiB

doc/H19-Jan-20204 KiB

exgettextH A D01-Jan-20203 KiB

gl/lib/H13-Aug-20174 KiB

gnulib/H13-Aug-20174 KiB

gnulib-tests/H13-Aug-20174 KiB

HACKINGH A D01-Jan-202022 KiB

init.cfgH A D01-Jan-20202.1 KiB

lib/H01-Jan-20204 KiB

Makefile.amH A D01-Jan-20202 KiB

man/H12-Jan-20204 KiB

NEWSH A D01-Jan-202016.9 KiB

po/H01-Jan-20204 KiB

READMEH A D01-Jan-20202.8 KiB

README-hackingH A D01-Jan-20204 KiB

scripts/git-hooks/H13-Aug-20174 KiB

src/H01-Jan-20204 KiB

tests/H01-Jan-20204 KiB

THANKSH A D13-Aug-2017771

TODOH A D13-Aug-2017306

README

1README for GNU DIFF
2
3This directory contains the GNU diff, diff3, sdiff, and cmp utilities.
4Their features are a superset of the Unix features and they are
5significantly faster.
6
7Please see the file COPYING for copying conditions.
8
9Please see the file doc/version.texi for version information.
10
11Please see the file doc/diffutils.texi (or doc/diffutils.info) for
12documentation that can be printed with TeX, or read with the 'info'
13program or with Emacs's 'M-x info'.  Brief man pages are in man/*,
14but they are no substitute for the documentation.
15
16Please see the file ABOUT-NLS for notes about translations.
17
18Please see the file INSTALL for generic compilation and installation
19instructions.  Briefly, you can run "./configure; make install".  The
20command "./configure --help" lists the supported --enable and --with
21options.
22
23If you have a problem with internationalization, you might be able to
24work around it as described in ABOUT-NLS by invoking './configure
25--disable-nls'.  Many of the problems arise from dynamic linking
26issues on non-GNU platforms (e.g. with the iconv library).  Such
27problems tend to be shared by other GNU applications on these
28platforms, and can usually be fixed by carefully tweaking your non-GNU
29installation.  If you have an older version of libiconv, please
30upgrade to the latest one; see <ftp://ftp.gnu.org/gnu/libiconv/>.  If
31the problem seems isolated to diffutils, though, please report a bug.
32
33This program requires a Standard C compiler (C89 or later).  If you
34have a nonstandard compiler, please install GCC first.
35
36If you make changes to the source code, you may need appropriate
37versions of GNU build tools to regenerate the intermediate files.  The
38following versions were used to generate the intermediate files in
39this distribution:
40
41* Autoconf 2.59   <ftp://ftp.gnu.org/gnu/autoconf/autoconf-2.59.tar.gz>
42* Automake 1.8.3  <ftp://ftp.gnu.org/gnu/automake/automake-1.8.3.tar.gz>
43* gettext 0.14.1  <ftp://ftp.gnu.org/gnu/gettext/gettext-0.14.1.tar.gz>
44* help2man 1.33   <ftp://ftp.gnu.org/gnu/help2man/help2man-1.33.1.tar.gz>
45* Texinfo 4.7     <ftp://ftp.gnu.org/gnu/texinfo/texinfo-4.7.tar.gz>
46
47For any copyright year range specified as YYYY-ZZZZ in this package
48note that the range specifies every single year in that closed interval.
49
50Please report bugs to <bug-diffutils@gnu.org>.
51
52-----
53
54Copyright (C) 1992, 1998, 2001-2002, 2004, 2009-2013, 2015-2020 Free Software
55Foundation, Inc.
56
57This file is part of GNU Diffutils.
58
59Permission is granted to copy, distribute and/or modify this document
60under the terms of the GNU Free Documentation License, Version 1.3 or
61any later version published by the Free Software Foundation; with no
62Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
63Texts.  A copy of the license is included in the "GNU Free
64Documentation License" file as part of this distribution.
65

README-hacking

1-*- outline -*-
2
3These notes intend to help people working on the checked-out sources.
4These requirements do not apply when building from a distribution tarball.
5See also HACKING for more detailed contribution guidelines.
6
7* Requirements
8
9We've opted to keep only the highest-level sources in the GIT repository.
10This eases our maintenance burden, (fewer merges etc.), but imposes more
11requirements on anyone wishing to build from the just-checked-out sources.
12Note the requirements to build the released archive are much less and
13are just the requirements of the standard ./configure && make procedure.
14Specific development tools and versions will be checked for and listed by
15the bootstrap script.  See README-prereq for specific notes on obtaining
16these prerequisite tools.
17
18Valgrind <http://valgrind.org/> is also highly recommended, if
19Valgrind supports your architecture.
20
21While building from a just-cloned source tree may require installing a
22few prerequisites, later, a plain 'git pull && make' should be sufficient.
23
24* First GIT checkout
25
26You can get a copy of the source repository like this:
27
28        $ git clone git://git.sv.gnu.org/diffutils
29        $ cd diffutils
30
31As an optional step, if you already have a copy of the gnulib git
32repository on your hard drive, then you can use it as a reference to
33reduce download time and disk space requirements:
34
35        $ export GNULIB_SRCDIR=/path/to/gnulib
36
37The next step is to get and check other files needed to build,
38which are extracted from other source packages:
39
40        $ ./bootstrap
41
42To use the most-recent gnulib (as opposed to the gnulib version that
43the package last synchronized to), do this next:
44
45        $ git submodule foreach git pull origin master
46        $ git commit -m 'build: update gnulib submodule to latest' gnulib
47
48And there you are!  Just
49
50        $ ./configure --quiet #[--enable-gcc-warnings] [*]
51        $ make
52        $ make check
53
54At this point, there should be no difference between your local copy,
55and the GIT master copy:
56
57        $ git diff
58
59should output no difference.
60
61Enjoy!
62
63[*] The --enable-gcc-warnings option is useful only with glibc
64and with a very recent version of gcc.  You'll probably also have
65to use recent system headers.  If you configure with this option,
66and spot a problem, please be sure to send the report to the bug
67reporting address of this package, and not to that of gnulib, even
68if the problem seems to originate in a gnulib-provided file.
69
70* Submitting patches
71
72If you develop a fix or a new feature, please send it to the
73appropriate bug-reporting address as reported by the --help option of
74each program.  One way to do this is to use vc-dwim
75<http://www.gnu.org/software/vc-dwim/>), as follows.
76
77  Run the command "vc-dwim --help", copy its definition of the
78  "git-changelog-symlink-init" function into your shell, and then run
79  this function at the top-level directory of the package.
80
81  Edit the (empty) ChangeLog file that this command creates, creating a
82  properly-formatted entry according to the GNU coding standards
83  <http://www.gnu.org/prep/standards/html_node/Change-Logs.html>.
84
85  Make your changes.
86
87  Run the command "vc-dwim" and make sure its output (the diff of all
88  your changes) looks good.
89
90  Run "vc-dwim --commit".
91
92  Run the command "git format-patch --stdout -1", and email its output
93  in, using the output's subject line.
94
95-----
96
97Copyright (C) 2002-2007, 2009-2013, 2015-2020 Free Software Foundation, Inc.
98
99This program is free software: you can redistribute it and/or modify
100it under the terms of the GNU General Public License as published by
101the Free Software Foundation, either version 3 of the License, or
102(at your option) any later version.
103
104This program is distributed in the hope that it will be useful,
105but WITHOUT ANY WARRANTY; without even the implied warranty of
106MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
107GNU General Public License for more details.
108
109You should have received a copy of the GNU General Public License
110along with this program.  If not, see <http://www.gnu.org/licenses/>.
111