Copyright (C) 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.See end for license conditions. Contributing to EmacsEmacs is a collaborative project and we encourage contributions fromanyone and everyone. If you want to contribute in the way that willhelp us most, we recommend (1) fixing reported bugs and (2)implementing the feature ideas in etc/TODO. However, if you think ofnew features to add, please suggest them too -- we might like youridea. Porting to new platforms is also useful, when there is a newplatform, but that is not common nowadays.For documentation on how to develop Emacs changes, refer to the EmacsManual and the Emacs Lisp Reference Manual (both included in the Emacsdistribution). The web pages in http://www.gnu.org/software/emacscontain additional information.You may also want to submit your change so that can be considered forinclusion in a future version of Emacs (see below).If you don't feel up to hacking Emacs, there are many other ways tohelp. You can answer questions on the mailing lists, writedocumentation, find and report bugs, contribute to the Emacs webpages, or develop a package that works with Emacs.Here are some style and legal conventions for contributors to Emacs:* Coding StandardsContributed code should follow the GNU Coding Standards.If it doesn't, we'll need to find someone to fix the code before wecan use it.Emacs has certain additional style and coding conventions.Ref: http://www.gnu.org/prep/standards/Ref: GNU Coding Standards Info ManualRef: The "Tips" Appendix in the Emacs Lisp Reference.* Copyright AssignmentWe can accept small changes (roughly, fewer than 15 lines) withoutlegal papers. Anything more substantial requires a copyrightdisclaimer or assignment (the latter is preferred, especially forlarger changes). Both of these involved filling out a short form andfiling it with the FSF. The process is straightforward -- contact usat emacs-devel@gnu.org to obtain the relevant forms.* Getting the Source CodeThe latest version of Emacs can be downloaded using Bazaar from theSavannah web site. It is important to write your patch based on thelatest version. If you start from an older version, your patch may beoutdated (so that maintainers will have a hard time applying it), orchanges in Emacs may have made your patch unnecessary.After you have downloaded the Bazaar source, you should read the fileINSTALL.BZR for build instructions (they differ to some extent from anormal build).Ref: http://savannah.gnu.org/projects/emacs* Submitting PatchesEvery patch must have several pieces of information before wecan properly evaluate it.When you have all these pieces, bundle them up in a mail message andsend it to bug-gnu-emacs@gnu.org or emacs-devel@gnu.org.All subsequent discussion should be sent to the same mailing list.** DescriptionFor bug fixes, a description of the bug and how your patch fixes thisbug.For new features, a description of the feature and your implementation.** ChangeLogA ChangeLog entry as plaintext (separate from the patch).See the various ChangeLog files for format and content. Note that,unlike some other projects, we do require ChangeLogs also fordocumentation, i.e. Texinfo files.Ref: "Change Log Concepts" node of the GNU Coding Standards InfoManual, for how to write good log entries.** The patch itself.Please use "Context Diff" format.If you are accessing the Bazaar repository, make sure your copy isup-to-date (e.g. with `bzr pull'), then use bzr diff --no-aliases --diff-options=-cpElse, use diff -cp OLD NEWIf your version of diff does not support these options, then get thelatest version of GNU Diff.** Mail format.We prefer to get the patches as inline plain text.Please be aware of line wrapping which will make the patch unreadableand useless for us. To avoid that, you can use MIME attachments or,as a last resort, uuencoded gzipped text.** Please reread your patch before submitting it.** Do not mix changes.If you send several unrelated changes together, we will ask you toseparate them so we can consider each of the changes by itself.** Do not make formatting changes.Making cosmetic formatting changes (indentation, etc) makes it harderto see what you have really changed.* Coding style and conventions.** Mandatory reading:The "Tips and Conventions" Appendix of the Emacs Lisp Reference.** Avoid using `defadvice' or `eval-after-load' for Lisp code to beincluded in Emacs.** Remove all trailing whitespace in all source and text files.** Use ?\s instead of ? in Lisp code for a space character.* Supplemental information for Emacs Developers.** Write access to the Emacs repository.Once you become a frequent contributor to Emacs, we can considergiving you write access to the Bazaar repository.** Emacs Mailing lists.Discussion about Emacs development takes place on emacs-devel@gnu.org.Bug reports and feature requests are sent to bug-gnu-emacs@gnu.org.You can subscribe to the mailing lists at savannah.gnu.org/projects/emacs.You can find the mailing lists archives at lists.gnu.org or gmane.org.** Document your changes.Think carefully about whether your change requires updating thedocumentation. If it does, you can either do this yourself or add anitem to the NEWS file.If you document your change in NEWS, please mark the NEWS entry withthe documentation status of the change: if you submit the changes forthe manuals, mark it with "+++"; if it doesn't need to be documented,mark it with "---"; if it needs to be documented, but you didn'tsubmit documentation changes, leave the NEWS entry unmarked. (Thesemarks are checked by the Emacs maintainers to make sure every changewas reflected in the manuals.)** Understanding Emacs Internals.The best way to understand Emacs Internals is to read the code,but the nodes "Tips" and "GNU Emacs Internals" in the Appendixof the Emacs Lisp Reference Manual may also help.The file etc/DEBUG describes how to debug Emacs bugs.This file is part of GNU Emacs.GNU Emacs is free software: you can redistribute it and/or modifyit under the terms of the GNU General Public License as published bythe Free Software Foundation, either version 3 of the License, or(at your option) any later version.GNU Emacs is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; without even the implied warranty ofMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See theGNU General Public License for more details.You should have received a copy of the GNU General Public Licensealong with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.Local variables:mode: outlineparagraph-separate: "[ ]*$"end: