Comment change.
[bpt/emacs.git] / lisp / cus-start.el
index fdf8c8a..fda7b35 100644 (file)
@@ -1,6 +1,7 @@
 ;;; cus-start.el --- define customization properties of builtins
 ;;
-;; Copyright (C) 1997, 1999, 2000, 2001, 2002, 2005 Free Software Foundation, Inc.
+;; Copyright (C) 1997, 1999, 2000, 2001, 2002, 2003, 2004,
+;;   2005, 2006, 2007 Free Software Foundation, Inc.
 ;;
 ;; Author: Per Abrahamsen <abraham@dina.kvl.dk>
 ;; Keywords: internal
@@ -9,7 +10,7 @@
 
 ;; 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 2, or (at your option)
+;; the Free Software Foundation; either version 3, or (at your option)
 ;; any later version.
 
 ;; GNU Emacs is distributed in the hope that it will be useful,
 
 ;;; Code:
 
-(let ((all '(;; abbrev.c
-            (abbrev-all-caps abbrev-mode boolean)
-            (pre-abbrev-expand-hook abbrev-mode hook)
-            ;; alloc.c
+(let ((all '(;; alloc.c
             (gc-cons-threshold alloc integer)
             (garbage-collection-messages alloc boolean)
-            ;; undo.c
-            (undo-limit undo integer)
-            (undo-strong-limit undo integer)
-            (undo-outer-limit undo
-                              (choice integer
-                                      (const :tag "No limit"
-                                             :format "%t\n%d"
-                                             :doc
-                                             "With this choice, \
-the undo info for the current command never gets discarded.
-This should only be chosen under exceptional circumstances,
-since it could result in memory overflow and make Emacs crash."
-                                             nil))
-                              "22.1")
             ;; buffer.c
-            (mode-line-format modeline sexp) ;Hard to do right.
+            (mode-line-format mode-line sexp) ;Hard to do right.
             (default-major-mode internal function)
             (enable-multibyte-characters mule boolean)
             (case-fold-search matching boolean)
@@ -65,13 +49,53 @@ since it could result in memory overflow and make Emacs crash."
             (ctl-arrow display boolean)
             (truncate-lines display boolean)
             (selective-display-ellipses display boolean)
-            (indicate-empty-lines display boolean "21.1")
+            (indicate-empty-lines fringe boolean)
+            (indicate-buffer-boundaries
+             fringe
+             (choice
+              (const :tag "No indicators" nil)
+              (const :tag "On left, with arrows" left)
+              (const :tag "On right, with arrows" right)
+              (set :tag "Pick your own design"
+                   :value ((t . nil))
+                   :format "%{%t%}:\n%v\n%d"
+                   :doc "You can specify a default and then override it \
+for individual indicators.
+Leaving \"Default\" unchecked is equivalent with specifying a default of
+\"Do not show\"."
+                   (choice :tag "Default"
+                           :value (t . nil)
+                           (const :tag "Do not show" (t . nil))
+                           (const :tag "On the left" (t . left))
+                           (const :tag "On the right" (t . right)))
+                   (choice :tag "Top"
+                           :value (top . left)
+                           (const :tag "Do not show" (top . nil))
+                           (const :tag "On the left" (top . left))
+                           (const :tag "On the right" (top . right)))
+                   (choice :tag "Bottom"
+                           :value (bottom . left)
+                           (const :tag "Do not show" (bottom . nil))
+                           (const :tag "On the left" (bottom . left))
+                           (const :tag "On the right" (bottom . right)))
+                   (choice :tag "Up arrow"
+                           :value (up . left)
+                           (const :tag "Do not show" (up . nil))
+                           (const :tag "On the left" (up . left))
+                           (const :tag "On the right" (up . right)))
+                   (choice :tag "Down arrow"
+                           :value (down . left)
+                           (const :tag "Do not show" (down . nil))
+                           (const :tag "On the left" (down . left))
+                           (const :tag "On the right" (down . right))))
+              (other :tag "On left, no arrows" t)))
             (scroll-up-aggressively windows
                                     (choice (const :tag "off" nil) number)
                                     "21.1")
             (scroll-down-aggressively windows
                                       (choice (const :tag "off" nil) number)
                                       "21.1")
+            (line-spacing display (choice (const :tag "none" nil) integer))
             ;; callint.c
             (mark-even-if-inactive editing-basics boolean)
             ;; callproc.c
@@ -95,8 +119,11 @@ since it could result in memory overflow and make Emacs crash."
                                  :value (undecided . undecided)
                                  (coding-system :tag "Decoding")
                                  (coding-system :tag "Encoding"))
-                           (coding-system :tag "Single coding system"
-                                          :value undecided)
+                           (coding-system
+                            :tag "Single coding system"
+                            :value undecided
+                            :match (lambda (widget value)
+                                     (and value (not (functionp value)))))
                            (function :value ignore))))
             (selection-coding-system mule coding-system)
             ;; dired.c
@@ -112,6 +139,9 @@ since it could result in memory overflow and make Emacs crash."
             ;; eval.c
             (max-specpdl-size limits integer)
             (max-lisp-eval-depth limits integer)
+            (max-mini-window-height limits
+                                    (choice (const :tag "quarter screen" nil)
+                                            number))
             (stack-trace-on-error debug
                                   (choice (const :tag "off")
                                           (repeat :menu-tag "When"
@@ -137,6 +167,7 @@ since it could result in memory overflow and make Emacs crash."
             ;; fns.c
             (use-dialog-box menu boolean "21.1")
             (use-file-dialog menu boolean "22.1")
+            (focus-follows-mouse frames boolean "20.3")
             ;; frame.c
             (default-frame-alist frames
               (repeat (cons :format "%v"
@@ -145,8 +176,10 @@ since it could result in memory overflow and make Emacs crash."
             (mouse-highlight mouse (choice (const :tag "disabled" nil)
                                            (const :tag "always shown" t)
                                            (other :tag "hidden by keypress" 1)))
+            ;; fringe.c
+            (overflow-newline-into-fringe fringe boolean)
             ;; indent.c
-            (indent-tabs-mode fill boolean)
+            (indent-tabs-mode indent boolean)
             ;; keyboard.c
             (meta-prefix-char keyboard character)
             (auto-save-interval auto-save integer)
@@ -164,6 +197,42 @@ since it could result in memory overflow and make Emacs crash."
             (suggest-key-bindings keyboard (choice (const :tag "off" nil)
                                                    (integer :tag "time" 2)
                                                    (other :tag "on")))
+            ;; macselect.c
+            (mac-dnd-known-types mac (repeat string) "22.1")
+            ;; macterm.c
+            (mac-control-modifier mac (choice (const :tag "No modifier" nil)
+                                              (const control) (const meta)
+                                              (const alt) (const hyper)
+                                              (const super)) "22.1")
+            (mac-command-modifier mac (choice (const :tag "No modifier" nil)
+                                              (const control) (const meta)
+                                              (const alt) (const hyper)
+                                              (const super)) "22.1")
+            (mac-option-modifier mac (choice (const :tag "No modifier (work as option)" nil)
+                                             (const control) (const meta)
+                                             (const alt) (const hyper)
+                                             (const super)) "22.1")
+            (mac-function-modifier mac
+                                   (choice (const :tag "No modifier (work as function)" nil)
+                                           (const control) (const meta)
+                                           (const alt) (const hyper)
+                                           (const super)) "22.1")
+            (mac-emulate-three-button-mouse mac
+                                            (choice (const :tag "No emulation" nil)
+                                                    (const :tag "Option->2, Command->3" t)
+                                                    (const :tag "Command->2, Option->3" reverse))
+                                   "22.1")
+            (mac-wheel-button-is-mouse-2 mac boolean "22.1")
+            (mac-pass-command-to-system mac boolean "22.1")
+            (mac-pass-control-to-system mac boolean "22.1")
+            (mac-allow-anti-aliasing mac boolean "22.1")
+            (mac-ts-script-language-on-focus mac
+                                             (choice (const :tag "System default behavior" nil)
+                                                     (const :tag "Restore to script/language used in the last focus frame" t)
+                                                     (cons :tag "Specify script/language"
+                                                           (integer :tag "Script code")
+                                                           (integer :tag "Language code")))
+                                             "22.1")
 
 ;; This is not good news because it will use the wrong
 ;; version-specific directories when you upgrade.  We need
@@ -190,7 +259,7 @@ since it could result in memory overflow and make Emacs crash."
                                 :format "%t%n%h"
                                 :inline t
                                 (read-only t))
-                         (const :tag "Inviolable"
+                         (const :tag "Don't Enter"
                                 :doc "Prevent point from ever entering prompt"
                                 :format "%t%n%h"
                                 :inline t
@@ -217,6 +286,22 @@ since it could result in memory overflow and make Emacs crash."
             (words-include-escapes editing-basics boolean)
             (open-paren-in-column-0-is-defun-start editing-basics boolean
                                                    "21.1")
+             ;; term.c
+             (visible-cursor cursor boolean "22.1")
+            ;; undo.c
+            (undo-limit undo integer)
+            (undo-strong-limit undo integer)
+            (undo-outer-limit undo
+                              (choice integer
+                                      (const :tag "No limit"
+                                             :format "%t\n%d"
+                                             :doc
+                                             "With this choice, \
+the undo info for the current command never gets discarded.
+This should only be chosen under exceptional circumstances,
+since it could result in memory overflow and make Emacs crash."
+                                             nil))
+                              "22.1")
             ;; window.c
             (temp-buffer-show-function windows (choice (const nil) function))
             (display-buffer-function windows (choice (const nil) function))
@@ -255,19 +340,32 @@ since it could result in memory overflow and make Emacs crash."
             (even-window-heights windows boolean)
             (next-screen-context-lines windows integer)
             (split-height-threshold windows integer)
+             (split-window-preferred-function
+              windows
+              (choice (const :tag "vertically" split-window)
+                      ;; FIXME: Add `sensibly' which chooses between
+                      ;; vertical or horizontal splits depending on the size
+                      ;; and shape of the window.
+                      (const :tag "horizontally"
+                             (lambda (window)
+                               (split-window window nil 'horiz)))))
             (window-min-height windows integer)
             (window-min-width windows integer)
-            (scroll-preserve-screen-position windows boolean)
+            (scroll-preserve-screen-position
+             windows (choice
+                      (const :tag "Off (nil)" :value nil)
+                      (const :tag "Full screen (t)" :value t)
+                      (other :tag "Always" 1)))
             (display-buffer-reuse-frames windows boolean "21.1")
             ;; xdisp.c
             (scroll-step windows integer)
             (scroll-conservatively windows integer)
             (scroll-margin windows integer)
-            (hscroll-margin windows integer "21.3")
-            (hscroll-step windows number "21.3")
+            (hscroll-margin windows integer "22.1")
+            (hscroll-step windows number "22.1")
             (truncate-partial-width-windows display boolean)
-            (mode-line-inverse-video modeline boolean)
-            (mode-line-in-non-selected-windows modeline boolean "21.3")
+            (mode-line-inverse-video mode-line boolean)
+            (mode-line-in-non-selected-windows mode-line boolean "22.1")
             (line-number-display-limit display
                                        (choice integer
                                                (const :tag "No limit" nil)))
@@ -279,15 +377,24 @@ since it could result in memory overflow and make Emacs crash."
                                            (other :tag "Unlimited" t)))
             (unibyte-display-via-language-environment mule boolean)
             (blink-cursor-alist cursor alist "22.1")
+            (overline-margin display integer "22.1")
+             (mouse-autoselect-window
+             display (choice
+                      (const :tag "Off (nil)" :value nil)
+                      (const :tag "Immediate" :value t)
+                      (number :tag "Delay by secs" :value 0.5)) "22.1")
             ;; xfaces.c
             (scalable-fonts-allowed display boolean)
             ;; xfns.c
             (x-bitmap-file-path installation
                                 (repeat (directory :format "%v")))
-            (x-use-old-gtk-file-dialog menu boolean "22.1")
+            (x-gtk-use-old-file-dialog menu boolean "22.1")
+            (x-gtk-show-hidden-files menu boolean "22.1")
+            (x-gtk-file-dialog-help-text menu boolean "22.1")
+            (x-gtk-whole-detached-tool-bar x boolean "22.1")
             ;; xterm.c
-             (mouse-autoselect-window display boolean "21.3")
-            (x-use-underline-position-properties display boolean "21.3")
+            (x-use-underline-position-properties display boolean "22.1")
+            (x-underline-at-descent-line display boolean "22.1")
             (x-stretch-cursor display boolean "21.1")))
       this symbol group type standard version native-p
       ;; This function turns a value
@@ -322,10 +429,16 @@ since it could result in memory overflow and make Emacs crash."
                       (eq system-type 'ms-dos))
                      ((string-match "\\`w32-" (symbol-name symbol))
                       (eq system-type 'windows-nt))
+                     ((string-match "\\`mac-" (symbol-name symbol))
+                      (featurep 'mac-carbon))
                      ((string-match "\\`x-.*gtk" (symbol-name symbol))
-                      (or (boundp 'gtk) (not (eq system-type 'windows-nt))))
+                      (featurep 'gtk))
                      ((string-match "\\`x-" (symbol-name symbol))
                       (fboundp 'x-create-frame))
+                     ((string-match "selection" (symbol-name symbol))
+                      (fboundp 'x-selection-exists-p))
+                     ((string-match "fringe" (symbol-name symbol))
+                      (fboundp 'define-fringe-bitmap))
                      (t t))))
     (if (not (boundp symbol))
        ;; If variables are removed from C code, give an error here!
@@ -358,5 +471,5 @@ since it could result in memory overflow and make Emacs crash."
 (unless purify-flag
   (provide 'cus-start))
 
-;;; arch-tag: 4502730d-bcb3-4f5e-99a3-a86f2d54af60
+;; arch-tag: 4502730d-bcb3-4f5e-99a3-a86f2d54af60
 ;;; cus-start.el ends here