mirror of
https://git.savannah.gnu.org/git/guile.git
synced 2025-05-21 12:10:26 +02:00
*** empty log message ***
This commit is contained in:
parent
d65010b8a2
commit
0822a9c108
1 changed files with 23 additions and 2 deletions
25
HACKING
25
HACKING
|
@ -1,5 +1,23 @@
|
||||||
Here are some guidelines for members of the Guile developers team.
|
Here are some guidelines for members of the Guile developers team.
|
||||||
|
|
||||||
|
Contributing Your Changes ============================================
|
||||||
|
|
||||||
|
- If you have put together a change that meets the coding standards
|
||||||
|
described below, we encourage you to submit it to Guile. The best
|
||||||
|
place to post it is guile@cygnus.com. Please don't send it directly
|
||||||
|
to me; I often don't have time to look things over. If you have
|
||||||
|
tested your change, then you don't need to be shy.
|
||||||
|
|
||||||
|
- Please submit patches using either context or unified diffs (diff -c
|
||||||
|
or diff -u). Don't include a patch for ChangeLog; such patches don't
|
||||||
|
apply cleanly, since we've probably changed the top of ChangeLog too.
|
||||||
|
Instead, provide the unaltered text at the top of your patch.
|
||||||
|
|
||||||
|
Please don't include patches for generated files like configure,
|
||||||
|
aclocal.m4, or any Makefile.in. Such patches are often large, and
|
||||||
|
we're just going to regenerate those files anyway.
|
||||||
|
|
||||||
|
|
||||||
CVS conventions ======================================================
|
CVS conventions ======================================================
|
||||||
|
|
||||||
- We use CVS to manage the Guile sources. The repository lives on
|
- We use CVS to manage the Guile sources. The repository lives on
|
||||||
|
@ -34,7 +52,6 @@ The Guile sources live in several modules:
|
||||||
|
|
||||||
There is a mailing list for CVS commit messages; see README for details.
|
There is a mailing list for CVS commit messages; see README for details.
|
||||||
|
|
||||||
|
|
||||||
- We check Makefile.in and configure files into CVS, as well as the
|
- We check Makefile.in and configure files into CVS, as well as the
|
||||||
files they are built from (Makefile.am, configure.in); we do not check
|
files they are built from (Makefile.am, configure.in); we do not check
|
||||||
in Makefiles or header files generated by configuration scripts. The
|
in Makefiles or header files generated by configuration scripts. The
|
||||||
|
@ -83,6 +100,11 @@ about uninitialized variables. You should look into these warnings to
|
||||||
make sure they are indeed spurious, but you needn't correct warnings
|
make sure they are indeed spurious, but you needn't correct warnings
|
||||||
caused by this EGCS bug.
|
caused by this EGCS bug.
|
||||||
|
|
||||||
|
- If you add code which uses functions or other features that are not
|
||||||
|
entirely portable, please make sure the rest of Guile will still
|
||||||
|
function properly on systems where they are missing. This usually
|
||||||
|
entails adding a test to configure.in, and then adding #ifdefs to your
|
||||||
|
code to disable it if the system's features are missing.
|
||||||
|
|
||||||
- When you make a user-visible change (i.e. one that should be
|
- When you make a user-visible change (i.e. one that should be
|
||||||
documented, and appear in NEWS, put an asterisk in column zero of the
|
documented, and appear in NEWS, put an asterisk in column zero of the
|
||||||
|
@ -116,7 +138,6 @@ alias for scm_map that guarantees the order in which we process list
|
||||||
elements, but we're not changing scm_map at all --- it's appropriate
|
elements, but we're not changing scm_map at all --- it's appropriate
|
||||||
to use the Scheme name in the log entry.
|
to use the Scheme name in the log entry.
|
||||||
|
|
||||||
|
|
||||||
- There's no need to keep a change log for documentation files. This
|
- There's no need to keep a change log for documentation files. This
|
||||||
is because documentation is not susceptible to bugs that are hard to
|
is because documentation is not susceptible to bugs that are hard to
|
||||||
fix. Documentation does not consist of parts that must interact in a
|
fix. Documentation does not consist of parts that must interact in a
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue