address@hidden: Drew Adams's elisp libraries]

[Richard Stallman]

Would anyone like to look at some of his libraries to find things
that might be worth installing in Emacs?

------- Start of forwarded message -------
From: "Drew Adams" <address@hidden>
To: <address@hidden>
Cc: <address@hidden>
Subject: Drew Adams's elisp libraries
Date: Tue, 18 Dec 2001 12:40:37 -0800
X-Priority: 3 (Normal)
X-MSMail-Priority: Normal
Importance: Normal
X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2314.1300

Hi Gerd,

About a year ago, RMS suggested I send you some of my Emacs Lisp libraries,
for possible inclusion in GNU. His suggestion was that I wait until after
version 21 came out.

As I see that 21 is now out (congratulations, and thanks!), I'm wondering if
you would still like me to send you my files. I think that some of them
might offer useful additions to the standard release.

My code was written over the years. It works well with version 20.7,
although parts of it do go back to version 19.x (18.x?). Some of the code
redefines Emacs certain standard functions or built-ins to add
functionality; this code is clearly flagged and documented.

I do not have time to work on the code anymore; in particular, I won't be
able to modify it to be version 21-compatible. I would, however, like to
make it available for you or others to use/modify as you will. In general,
the code is clean and well-documented, and I will try to be available to
answer any clarification questions that might arise.

I can send you any or all the files I have, either individually or as a zip
or gzip archive.

Below is a brief description of the files. I can provide more detailed
descriptions (from the file COMMENTARY sections), if you like.

The files are of variable size, complexity and usefulness.  Some files that
are not especially useful may nevertheless contain one or two useful
functions.  A quick scan of the doc strings or code comments should make it
clear which functions and variables are most useful.

Some of the files that might be of most use are the following:
buff-menu+.el, compile+.el, def-face-const.el, dired+.el, elect-mbuf.el (my
version), frame-cmds.el, frame-fns.el, help+.el, icomplete+.el, info+.el,
isearch+.el, mkhtml.el, replace+.el, shrink-fit-all.el, shrink-fit.el,
strings.el, thingatpt+.el, vc+.el.

A shorter short list is this: compile+.el, dired+.el, elect-mbuf.el,
frame-cmds.el, frame-fns.el, help+.el, info+.el, mkhtml.el,
shrink-fit-all.el, shrink-fit.el.  A shorter list still: help+.el, info+.el,
mkhtml.el, shrink-fit-all.el, shrink-fit.el.

I've made the inter-library dependencies explicit, both as commentary (see
below) and via require and provide statements.  For example, if you wanted
to take a look at library shrink-fit-all, and have it work out-of-the-box,
you would also need these libraries: def-face-const, misc-fns, strings and
shrink-fit.

If you wanted to see shrink-fit-all at its best, you would need these
libraries, in addition to those above: frame-cmds, frame-fns, icomplete+ and
thingatpt+.  These provide more bells and whistles, but there is no error if
they are not present.

I can also provide you the expanded list of dependencies, which shows
immediately all of the libraries needed by each file.

Please let me know which files to email you, and how you want them packaged.

 - Drew Adams

- -------------------8<---------------------

The names of my Elisp files use the following convention.

Files that replace standard GNU Emacs Lisp files keep their original names,
naturally (examples: `appt.el', `delsel.el').

Names of files that are extensions of standard files are suffixed by `-' or
`+', depending on whether they are to be loaded just before or just after
the corresponding standard files.  For example, my file `compile-.el' is to
be loaded before the standard GNU file `compile.el'; my file `compile+.el'
is to be loaded after `compile.el'.  The `+' case is more common than the
`-' case.

DEPENDENCIES AMONG MY ELISP LIBRARIES

Libraries that are required by a listed library are in parentheses.
Libraries that are not strictly required (no error if not found), but
are needed to take advantage of all features, are in square brackets.

[CONTRIB] means the library is neither a GNU library nor one provided
by me; my libraries that require it should indicate where to get it.

FILE         DESCRIPTION
- ------------------------

appt.el    -     replacement for GNU `appt.el'
 (def-face-const) [calendar+ frame-cmds icomplete+ misc-fns strings]

apropos+.el    -     extensions to GNU `apropos.el'
 () []

autoload+.el    -     extensions to GNU `autoload.el'
 () []

bookmark.el    -     extensions to GNU `bookmark.el'
 () []

buff-menu+.el    -     extensions to GNU `buff-menu.el'
 (def-face-const) [def-face-const misc-cmds misc-fns]

cal-opts.el    -     sets various calendar, diary etc. options
 () [appt calendar+]

calendar+.el    -     extensions to GNU `calendar.el'
 () [elect-mbuf misc-fns shrink-fit-all]

compile-.el    -     extensions to GNU `compile.el'
 () [shrink-fit]

compile+.el    -     extensions to GNU `compile.el'
 (compile-) [highlight misc-fns thingatpt+]

cursors.el    -     bar cursor in insert mode, block in overwrite mode
 () []

cus-edit+.el    -     extensions to GNU `cus-edit.el'
 () []

def-face-const.el    -     macro for defining faces & their variables
 () []

delsel.el    -     replacement for GNU `delsel.el'
 (def-face-const) [frame-cmds strings]

diff+.el    -     extensions to GNU `diff.el'
 (def-face-const) [icomplete+ shrink-fit-all]

dired+.el    -     extensions to GNU `dired.el'
 (def-face-const) [misc-fns mkhtml]

elect-mbuf.el    -     minibuffer completion and default input cycling
 (def-face-const) [frame-cmds strings]

faces+.el    -     extensions to GNU `faces.el'
 () [thingatpt+]

files+.el    -     extensions to GNU `files.el'
 () []

find-dired-.el    -     extensions to GNU `find-dired.el'
 () []

find-dired+.el    -     extensions to GNU `find-dired.el'
 (find-dired-) [dired+ thingatpt+]

frame+.el    -     extensions to GNU `frame.el'
 () [shrink-fit]

frame-cmds.el    -     frame & window commands (interactive functions)
 (frame-fns strings) [icomplete+]

frame-fns.el    -     non-interactive frame and window functions
 () []

header2.el    -     creation and update of file headers
 () [strings]

help+.el    -     extensions to GNU `help.el'
 () [frame-cmds frame-fns help-macro+ info+ thingatpt+]

help-macro+.el    -     extensions to GNU `help-macro.el'
 () []

highlight.el    -     simple highlighting commands
 () [faces+ frame-fns strings]

icomplete+.el    -     extensions to GNU `icomplete.el'
 (def-face-const) []

imenu+.el    -     extensions to GNU `imenu.el'
 () []

info+.el    -     extensions to GNU `info.el'
 (def-face-const) [setup-info shrink-fit strings thingatpt+]

isearch+.el    -     extensions to GNU `isearch.el'
 () []

line-num.el    -     display line numbers in left-margin of buffer
 () [shrink-fit]

macros+.el    -     extensions to GNU `macros.el'
 () [elect-mbuf thingatpt+]

menu-bar+.el    -     extensions to GNU `menu-bar.el'
 () [apropos+ compile+ diff+ dlgopen [CONTRIB] help+ highlight info+
     macros+ misc-cmds replace+ unaccent vc+]

misc-cmds.el    -     miscellaneous commands (interactive functions)
 () [frame-fns]

misc-fns.el    -     miscellaneous non-interactive functions
 (def-face-const) []

mkhtml.el    -     create HTML with links (extensions to `htmlize.el')
 (htmlize [CONTRIB]) [info+]

mouse+.el    -     extensions to GNU `mouse.el'
 () []

novice+.el    -     extensions to GNU `novice.el'
 () [elect-mbuf thingatpt+]

options+.el    -     extensions to GNU `options.el'
 () []

outline+.el    -     extensions to GNU `outline.el'
 () []

pp+.el    -     extensions to GNU `pp.el'
 () []

rebind-mbuf-maps.el    -     rebind minibuffer completion maps
 () []

replace+.el    -     extensions to GNU `replace.el'
 (def-face-const) [frame-cmds frame-fns highlight shrink-fit strings
                   thingatpt+]

ring+.el    -     extensions to GNU `ring.el'
 () []

setup-frames.el    -     define a custom default frame configuration
 () [files+ frame-cmds]

setup-info.el    -     custom definitions to load before `info.el'
 (def-face-const) []

setup-keys.el    -     custom key bindings
 () [buff-menu+ diff+ files+ frame-cmds help+ highlight misc-cmds pp+
     replace+ shrink-fit simple+ unaccent]

setup.el    -     custom startup configuration (assignments etc.)
 () [misc-fns paren shrink-fit strings]

show-wspace.el    -     whitespace highlighting
 (def-face-const) []

shrink-fit.el    -     shrink-wrap frames to fit their selected window
 (misc-fns strings) [frame-cmds]

shrink-fit-all.el    -     auto-shrink all frames to fit window
 (strings shrink-fit) []

simple+.el    -     extensions to GNU `simple.el'
 () [elect-mbuf icomplete+ strings]

sort+.el    -     extensions to GNU `sort.el'
 () []

start-opt.el    -     miscellaneous customizations
 (def-face-const) [faces+ frame-cmds header2 misc-cmds misc-fns
                   setup-keys shrink-fit-all wimpy-del]

start.el    -     main startup file - loads/autoloads most everything
 (apropos+ autoload+ bookmark+ buff-menu+ cal-opts calendar+ compile+
  cursors cus-edit+ delsel diff+ dired+ dlgopen [CONTRIB]
  elect-mbuf faces+ files+ find-dired+ frame+ frame-cmds frame-fns
  header2 help+ highlight icomplete+ imenu+ info+ isearch+ line-num
  macros+ make-regexp [CONTRIB] menu-bar+ misc-cmds misc-fns mkhtml
  mouse+ novice+ options+ pp+ printing [CONTRIB] replace+ ring+ setup
  setup-frames setup-info setup-keys show-wspace shrink-fit-all
  simple+ sort+ strings thingatpt+ timer+ unaccent vc+ vc-hooks+
  wimpy-del window+)

strings.el    -     miscellaneous string functions
 () [thingatpt+]

thingatpt+.el    -     extensions to GNU `thingatpt.el'
 () []

timer+.el    -     extensions to GNU `timer.el'
 () [elect-mbuf thingatpt+]

unaccent.el    -     functions dealing with accented characters
 () [strings]

vc-.el    -     extensions to GNU `vc.el'
 () []

vc+.el    -     extensions to GNU `vc.el'
 (dired+ vc-) [frame-cmds ring+ shrink-fit]

vc-hooks+.el    -     extensions to GNU `vc-hooks.el'
 () [vc+]

wimpy-del.el    -     confirmation for large region deletion
 () [frame-fns strings]

window+.el    -     extensions to GNU `window.el'
 () []
------- End of forwarded message -------