diff options
| author | Glenn Morris | 2014-10-15 00:07:29 -0700 |
|---|---|---|
| committer | Glenn Morris | 2014-10-15 00:07:29 -0700 |
| commit | 12e8ede75cc09a665455609bbb3006f0896c52af (patch) | |
| tree | 79a59d62ffcc40aad1b9cf15ba0a64ea91674f8e /admin | |
| parent | 0b298692909debe108be77e9d357b49816bafb16 (diff) | |
| download | emacs-12e8ede75cc09a665455609bbb3006f0896c52af.tar.gz emacs-12e8ede75cc09a665455609bbb3006f0896c52af.zip | |
Remove some admin/notes files
* admin/notes/lel-TODO: Remove. This has not turned out to be a
useful way to get things documented.
* admin/notes/exit-value, admin/notes/iftc: Remove.
These don't seem to have any particular relationship to Emacs development.
Diffstat (limited to 'admin')
| -rw-r--r-- | admin/notes/exit-value | 28 | ||||
| -rw-r--r-- | admin/notes/iftc | 26 | ||||
| -rw-r--r-- | admin/notes/lel-TODO | 124 |
3 files changed, 0 insertions, 178 deletions
diff --git a/admin/notes/exit-value b/admin/notes/exit-value deleted file mode 100644 index 96337e4c8dd..00000000000 --- a/admin/notes/exit-value +++ /dev/null | |||
| @@ -1,28 +0,0 @@ | |||
| 1 | ttn 2004-05-09 | ||
| 2 | |||
| 3 | The exit value of a program returning to the shell on unixoid systems | ||
| 4 | is typically 0 for success, and non-0 (such as 1) for failure. This is | ||
| 5 | not always the case on other systems. | ||
| 6 | |||
| 7 | From the point of view of the program stdlib.h provides macros | ||
| 8 | `EXIT_SUCCESS' and `EXIT_FAILURE' that should DTRT. N.B. The | ||
| 9 | numerical values of these macros DO NOT need to fulfill the exit value | ||
| 10 | requirements outlined in the first paragraph! That is the job of the | ||
| 11 | `exit' function. Thus, this kind of construct shows misunderstanding: | ||
| 12 | |||
| 13 | #ifdef WEIRD_OS | ||
| 14 | exit (1); | ||
| 15 | #else | ||
| 16 | exit (0); | ||
| 17 | #endif | ||
| 18 | |||
| 19 | Values aside from EXIT_SUCCESS and EXIT_FAILURE are tricky, but can be | ||
| 20 | used to indicate finer gradations of failure. If this is the only | ||
| 21 | information available to the caller, clamping such values to | ||
| 22 | EXIT_FAILURE loses information. If there are other ways to indicate | ||
| 23 | the problem to the caller (such as a message to stderr) it may be ok | ||
| 24 | to clamp. In all cases, it is the relationship between the program | ||
| 25 | and its caller that must be examined. | ||
| 26 | |||
| 27 | [Insert ZAMM quote here.] <-- I presume this refers to ``Zen and the | ||
| 28 | Art of Motorcycle Maintenance'' - Reuben Thomas <rrt@sc3d.org>. | ||
diff --git a/admin/notes/iftc b/admin/notes/iftc deleted file mode 100644 index 983b1486685..00000000000 --- a/admin/notes/iftc +++ /dev/null | |||
| @@ -1,26 +0,0 @@ | |||
| 1 | Iso-Functional Type Contour | ||
| 2 | |||
| 3 | |||
| 4 | This is a term coined to describe "column int->float" change approach, and can | ||
| 5 | be used whenever low-level types need to change (hopefully not often!) but the | ||
| 6 | meanings of the values (whose type has changed) do not. | ||
| 7 | |||
| 8 | The premise is that changing a low-level type potentially means lots of code | ||
| 9 | needs to be changed as well, and the question is how to do this incrementally, | ||
| 10 | which is the preferred way to change things. | ||
| 11 | |||
| 12 | Say LOW and HIGH are C functions: | ||
| 13 | |||
| 14 | int LOW (void) { return 1; } | ||
| 15 | void HIGH (void) { int value = LOW (); } | ||
| 16 | |||
| 17 | We want to convert LOW to return float, so we cast HIGH usage: | ||
| 18 | |||
| 19 | float LOW (void) { return 1.0; } | ||
| 20 | void HIGH (void) { int value = (int) LOW (); } /* iftc */ | ||
| 21 | |||
| 22 | The comment /* iftc */ is used to mark this type of casting to differentiate | ||
| 23 | it from other casting. We commit the changes and can now go about modifying | ||
| 24 | LOW and HIGH separately. When HIGH is ready to handle the type change, the | ||
| 25 | cast can be removed. | ||
| 26 | |||
diff --git a/admin/notes/lel-TODO b/admin/notes/lel-TODO deleted file mode 100644 index 4a4ccb5e6e8..00000000000 --- a/admin/notes/lel-TODO +++ /dev/null | |||
| @@ -1,124 +0,0 @@ | |||
| 1 | Some lisp/emacs-lisp/ Features and Where They Are Documented | ||
| 2 | |||
| 3 | Copyright (C) 2007-2014 Free Software Foundation, Inc. | ||
| 4 | See the end of the file for license conditions. | ||
| 5 | |||
| 6 | |||
| 7 | * Status Key | ||
| 8 | - -- as yet unknown | ||
| 9 | n/a -- not applicable (internal, uninteresting, etc) | ||
| 10 | obsolete -- an obsolete feature, to be removed in future | ||
| 11 | todo -- not documented but should be | ||
| 12 | NODE -- documented in or under info node NODE | ||
| 13 | |||
| 14 | |||
| 15 | * Features | ||
| 16 | advice (elisp) Advising Functions | ||
| 17 | advice-preload n/a | ||
| 18 | assoc - | ||
| 19 | authors - | ||
| 20 | autoload (elisp) Autoload | ||
| 21 | avl-tree - | ||
| 22 | backquote n/a | ||
| 23 | benchmark n/a | ||
| 24 | bindat (elisp) Byte Packing | ||
| 25 | byte-compile (elisp) Byte Compilation | ||
| 26 | byte-opt - | ||
| 27 | bytecomp (elisp) Compilation Functions | ||
| 28 | checkdoc (elisp) Documentation Tips | ||
| 29 | cl (cl) | ||
| 30 | cl-compat n/a | ||
| 31 | cl-specs n/a | ||
| 32 | copyright - | ||
| 33 | crm - | ||
| 34 | cust-print (elisp) Printing in Edebug | ||
| 35 | debug (elisp) Debugger | ||
| 36 | derived (elisp) Derived Modes | ||
| 37 | disass (elisp) Disassembly | ||
| 38 | easy-mmode (elisp) Defining Minor Modes | ||
| 39 | easymenu - | ||
| 40 | edebug (elisp) Edebug | ||
| 41 | eldoc - | ||
| 42 | elint - | ||
| 43 | elp n/a | ||
| 44 | ewoc (elisp) Separated Rendering | ||
| 45 | find-func - | ||
| 46 | find-gc - | ||
| 47 | generic (elisp) Generic Modes | ||
| 48 | gulp n/a | ||
| 49 | helper - | ||
| 50 | levents obsolete | ||
| 51 | lisp-float-type - | ||
| 52 | lisp-mnt - | ||
| 53 | lisp-mode n/a | ||
| 54 | lmenu obsolete | ||
| 55 | lucid obsolete | ||
| 56 | macroexp (elisp) Expansion | ||
| 57 | pp (emacs) Program Indent | ||
| 58 | re-builder - | ||
| 59 | regexp-opt (elisp) Regexp Functions | ||
| 60 | regi - | ||
| 61 | ring (elisp) Rings | ||
| 62 | rx - | ||
| 63 | shadow - | ||
| 64 | sregex obsolete | ||
| 65 | syntax (elisp) Position Parse | ||
| 66 | testcover - | ||
| 67 | timer (elisp) Timers | ||
| 68 | tq (elisp) Transaction Queues | ||
| 69 | trace - | ||
| 70 | unsafep (elisp) Function Safety | ||
| 71 | warnings (elisp) Warnings | ||
| 72 | |||
| 73 | |||
| 74 | * Above list created using default directory lisp/emacs-lisp/ with | ||
| 75 | (shell-command | ||
| 76 | "sed '/^(provide '\\''/!d;s// /;s/).*//' *.el | sort | uniq") | ||
| 77 | |||
| 78 | |||
| 79 | * How to use this file to improve Emacs | ||
| 80 | (loop | ||
| 81 | (let* ((feature (choose-one Features)) | ||
| 82 | (status (feature-status feature))) | ||
| 83 | (if (or (eq '- status) (not (verify status))) | ||
| 84 | (update feature (current-docs feature)) | ||
| 85 | (case status | ||
| 86 | (todo (let (doc patch feedback) | ||
| 87 | (while (not (grok feature)) | ||
| 88 | (or (play-with feature) | ||
| 89 | (grep feature Internet) | ||
| 90 | (grep feature (wisdom-maybe "emacs-devel")))) | ||
| 91 | (setq doc (write-documentation feature) | ||
| 92 | patch (diff (current-docs) doc)) | ||
| 93 | (while (not (and (correct doc) | ||
| 94 | (well-placed doc) | ||
| 95 | (well-formed patch))) | ||
| 96 | (setq doc (revise doc) | ||
| 97 | patch (diff (current-docs) doc)) | ||
| 98 | feedback (wisdom-maybe "emacs-devel" patch)) | ||
| 99 | (when (install patch) | ||
| 100 | (when (update feature (current-docs feature)) | ||
| 101 | (job-well-done user-login-name))))) | ||
| 102 | (n/a (job-well-done user-login-name)))))) | ||
| 103 | |||
| 104 | |||
| 105 | * Etc | ||
| 106 | |||
| 107 | This file is part of GNU Emacs. | ||
| 108 | |||
| 109 | GNU Emacs is free software: you can redistribute it and/or modify | ||
| 110 | it under the terms of the GNU General Public License as published by | ||
| 111 | the Free Software Foundation, either version 3 of the License, or | ||
| 112 | (at your option) any later version. | ||
| 113 | |||
| 114 | GNU Emacs is distributed in the hope that it will be useful, | ||
| 115 | but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
| 116 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | ||
| 117 | GNU General Public License for more details. | ||
| 118 | |||
| 119 | You should have received a copy of the GNU General Public License | ||
| 120 | along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. | ||
| 121 | |||
| 122 | Local variables: | ||
| 123 | mode: outline | ||
| 124 | End: | ||