aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGlenn Morris2014-10-15 00:07:29 -0700
committerGlenn Morris2014-10-15 00:07:29 -0700
commit12e8ede75cc09a665455609bbb3006f0896c52af (patch)
tree79a59d62ffcc40aad1b9cf15ba0a64ea91674f8e
parent0b298692909debe108be77e9d357b49816bafb16 (diff)
downloademacs-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.
-rw-r--r--admin/notes/exit-value28
-rw-r--r--admin/notes/iftc26
-rw-r--r--admin/notes/lel-TODO124
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 @@
1ttn 2004-05-09
2
3The exit value of a program returning to the shell on unixoid systems
4is typically 0 for success, and non-0 (such as 1) for failure. This is
5not always the case on other systems.
6
7From the point of view of the program stdlib.h provides macros
8`EXIT_SUCCESS' and `EXIT_FAILURE' that should DTRT. N.B. The
9numerical values of these macros DO NOT need to fulfill the exit value
10requirements 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
19Values aside from EXIT_SUCCESS and EXIT_FAILURE are tricky, but can be
20used to indicate finer gradations of failure. If this is the only
21information available to the caller, clamping such values to
22EXIT_FAILURE loses information. If there are other ways to indicate
23the problem to the caller (such as a message to stderr) it may be ok
24to clamp. In all cases, it is the relationship between the program
25and its caller that must be examined.
26
27[Insert ZAMM quote here.] <-- I presume this refers to ``Zen and the
28Art 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 @@
1Iso-Functional Type Contour
2
3
4This is a term coined to describe "column int->float" change approach, and can
5be used whenever low-level types need to change (hopefully not often!) but the
6meanings of the values (whose type has changed) do not.
7
8The premise is that changing a low-level type potentially means lots of code
9needs to be changed as well, and the question is how to do this incrementally,
10which is the preferred way to change things.
11
12Say LOW and HIGH are C functions:
13
14 int LOW (void) { return 1; }
15 void HIGH (void) { int value = LOW (); }
16
17We 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
22The comment /* iftc */ is used to mark this type of casting to differentiate
23it from other casting. We commit the changes and can now go about modifying
24LOW and HIGH separately. When HIGH is ready to handle the type change, the
25cast 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 @@
1Some lisp/emacs-lisp/ Features and Where They Are Documented
2
3Copyright (C) 2007-2014 Free Software Foundation, Inc.
4See 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
107This file is part of GNU Emacs.
108
109GNU Emacs is free software: you can redistribute it and/or modify
110it under the terms of the GNU General Public License as published by
111the Free Software Foundation, either version 3 of the License, or
112(at your option) any later version.
113
114GNU Emacs is distributed in the hope that it will be useful,
115but WITHOUT ANY WARRANTY; without even the implied warranty of
116MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
117GNU General Public License for more details.
118
119You should have received a copy of the GNU General Public License
120along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
121
122 Local variables:
123 mode: outline
124 End: