view etc/CONTRIBUTE @ 103273:c32ec20d0ab5

* abbrevs.texi (Abbrev Mode): abbrev-mode is an option. * backups.texi (Making Backups): backup-directory-alist and make-backup-file-name-function are options. (Auto-Saving): auto-save-list-file-prefix is an option. * buffers.texi (Killing Buffers): buffer-offer-save is an option. * display.texi (Refresh Screen): no-redraw-on-reenter is an option. (Echo Area Customization): echo-keystrokes is an option. (Selective Display): selective-display-ellipses is an option. (Temporary Displays): temp-buffer-show-function is an option. (Face Attributes): underline-minimum-offset and x-bitmap-file-path are options. (Font Selection): face-font-family-alternatives, face-font-selection-order, face-font-registry-alternatives, and scalable-fonts-allowed are options. (Fringe Indicators): indicate-buffer-boundaries is an option. (Fringe Cursors): overflow-newline-into-fringe is an option. (Scroll Bars): scroll-bar-mode is an option. * eval.texi (Eval): max-lisp-eval-depth is an option. * files.texi (Visiting Functions): find-file-hook is an option. (Directory Names): directory-abbrev-alist is an option. (Unique File Names): temporary-file-directory and small-temporary-file-directory are options. * frames.texi (Initial Parameters): initial-frame-alist, minibuffer-frame-alist and default-frame-alist are options. (Cursor Parameters): blink-cursor-alist and cursor-in-non-selected-windows ar options. (Window System Selections): selection-coding-system is an option. (Display Feature Testing): display-mm-dimensions-alist is an option. * help.texi (Help Functions): help-char and help-event-list are options. * keymaps.texi (Functions for Key Lookup): meta-prefix-char is an option. * minibuf.texi (Minibuffer History): history-length and history-delete-duplicates are options. (High-Level Completion): read-buffer-function and read-buffer-completion-ignore-case are options. (Reading File Names): read-file-name-completion-ignore-case is an option. * modes.texi (Mode Line Top): mode-line-format is an option. (Mode Line Variables): mode-line-position and mode-line-modes are options. * nonascii.texi (Text Representations): enable-multibyte-characters is an option. (Default Coding Systems): auto-coding-regexp-alist, file-coding-system-alist, auto-coding-alist and auto-coding-functions are options. (Specifying Coding Systems): inhibit-eol-conversion is an option. * os.texi (Init File): site-run-file is an option. (System Environment): mail-host-address is an option. (User Identification): user-mail-address is an option. (Terminal Output): baud-rate is an option. * positions.texi (Word Motion): words-include-escapes is an option. * searching.texi (Standard Regexps): page-delimiter, paragraph-separate, paragraph-separate and sentence-end are options. * text.texi (Margins): left-margin and fill-nobreak-predicate are options. * variables.texi (Local Variables): max-specpdl-size is an option. * windows.texi (Choosing Window): split-window-preferred-function, special-display-function and display-buffer-function are options.

+
鐃緒申��申鐃緒申Copyright (C) 2006, 2007, 2008, 2009  Free Software Foundation, Inc.
+
鐃緒申��申鐃緒申See end for license conditions.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申			Contributing to Emacs
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Emacs is a collaborative project and we encourage contributions from
+
鐃緒申��申鐃緒申anyone and everyone.  If you want to contribute in the way that will
+
鐃緒申��申鐃緒申help us most, we recommend (1) fixing reported bugs and (2)
+
鐃緒申��申鐃緒申implementing the feature ideas in etc/TODO.  However, if you think of
+
鐃緒申��申鐃緒申new features to add, please suggest them too -- we might like your
+
鐃緒申��申鐃緒申idea.  Porting to new platforms is also useful, when there is a new
+
鐃緒申��申鐃緒申platform, but that is not common nowadays.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申For documentation on how to develop Emacs changes, refer to the Emacs
+
鐃緒申��申鐃緒申Manual and the Emacs Lisp Reference Manual (both included in the Emacs
+
鐃緒申��申鐃緒申distribution).  The web pages in http://www.gnu.org/software/emacs
+
鐃緒申��申鐃緒申contain additional information.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申You may also want to submit your change so that can be considered for
+
鐃緒申��申鐃緒申inclusion in a future version of Emacs (see below).
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申If you don't feel up to hacking Emacs, there are many other ways to
+
鐃緒申��申鐃緒申help.  You can answer questions on the mailing lists, write
+
鐃緒申��申鐃緒申documentation, find and report bugs, contribute to the Emacs web
+
鐃緒申��申鐃緒申pages, or develop a package that works with Emacs.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Here are some style and legal conventions for contributors to Emacs:
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申* Coding Standards
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Contributed code should follow the GNU Coding Standard.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申If it doesn't, we'll need to find someone to fix the code before we
+
鐃緒申��申鐃緒申can use it.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Emacs has certain additional style and coding conventions.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Ref: http://www.gnu.org/prep/standards_toc.html
+
鐃緒申��申鐃緒申Ref: GNU Coding Standards Info Manual
+
鐃緒申��申鐃緒申Ref: The "Tips" Appendix in the Emacs Lisp Reference.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申* Copyright Assignment
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申We can accept small changes without legal papers, and for medium-size
+
鐃緒申��申鐃緒申changes a copyright disclaimer is ok too.  To accept substantial
+
鐃緒申��申鐃緒申contributions from you, we need a copyright assignment form filled out
+
鐃緒申��申鐃緒申and filed with the FSF.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Contact us at [e-mail] to obtain the relevant forms.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申* Getting the Source Code
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申The latest version of Emacs can be downloaded using CVS or Arch from
+
鐃緒申��申鐃緒申the Savannah web site.  It is important to write your patch based on
+
鐃緒申��申鐃緒申this version; if you start from an older version, your patch may be
+
鐃緒申��申鐃緒申outdated when you write it, and maintainers will have a hard time
+
鐃緒申��申鐃緒申applying it.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申After you have downloaded the CVS source, you should read the file
+
鐃緒申��申鐃緒申INSTALL.CVS for build instructions (they differ to some extent from a
+
鐃緒申��申鐃緒申normal build).
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Ref: http://savannah.gnu.org/projects/emacs
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申* Submitting Patches
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Every patch must have several pieces of information before we
+
鐃緒申��申鐃緒申can properly evaluate it.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申When you have all these pieces, bundle them up in a mail message and
+
鐃緒申��申鐃緒申send it to [e-mail] or [e-mail].
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申All subsequent discussion should also be sent to the mailing list.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申** Description
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申For bug fixes, a description of the bug and how your patch fixes this
+
鐃緒申��申鐃緒申bug.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申For new features, a description of the feature and your implementation.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申** ChangeLog
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申A 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 for
+
鐃緒申��申鐃緒申documentation, i.e. Texinfo files.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Ref: "Change Log Concepts" node of the GNU Coding Standards Info
+
鐃緒申��申鐃緒申Manual, for how to write good log entries.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申** The patch itself.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Please use "Context Diff" format.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申If you are accessing the CVS repository use
+
鐃緒申��申鐃緒申	cvs update; cvs diff -cp
+
鐃緒申��申鐃緒申else, use
+
鐃緒申��申鐃緒申	diff -cp OLD NEW
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申If your version of diff does not support these options, then get the
+
鐃緒申��申鐃緒申latest 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 unreadable
+
鐃緒申��申鐃緒申and 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 to
+
鐃緒申��申鐃緒申separate them so we can consider each of the changes by itself.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申* 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 be
+
鐃緒申��申鐃緒申included 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 Emacs' CVS repository.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Once you become a frequent contributor to Emacs, we can consider
+
鐃緒申��申鐃緒申giving you write access to the CVS repository.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申** Emacs Mailing lists.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Discussion about Emacs development takes place on [e-mail].
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Bug reports for released versions are sent to [e-mail].
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Bug reports for development versions are sent to [e-mail].
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申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 the
+
鐃緒申��申鐃緒申documentation.  If it does, you can either do this yourself or add an
+
鐃緒申��申鐃緒申item to the NEWS file.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申If you document your change in NEWS, please mark the NEWS entry with
+
鐃緒申��申鐃緒申the documentation status of the change: if you submit the changes for
+
鐃緒申��申鐃緒申the manuals, mark it with "+++"; if it doesn't need to be documented,
+
鐃緒申��申鐃緒申mark it with "---"; if it needs to be documented, but you didn't
+
鐃緒申��申鐃緒申submit documentation changes, leave the NEWS entry unmarked.  (These
+
鐃緒申��申鐃緒申marks are checked by the Emacs maintainers to make sure every change
+
鐃緒申��申鐃緒申was 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 Appendix
+
鐃緒申��申鐃緒申of 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 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.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申GNU Emacs 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 GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Local variables:
+
鐃緒申��申鐃緒申mode: outline
+
鐃緒申��申鐃緒申paragraph-separate: "[ 	]*$"
+
鐃緒申��申鐃緒申end:
+
鐃緒申��申鐃緒申