[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa-admin 1329950 024/439: Administrivia. Add COPYING, update
From: |
Philip Kaludercic |
Subject: |
[nongnu] elpa-admin 1329950 024/439: Administrivia. Add COPYING, update README and .gitignore, bump version number. |
Date: |
Sun, 17 Oct 2021 15:47:28 -0400 (EDT) |
branch: elpa-admin
commit 1329950078048576bb0cd9b535deddf6f5b84642
Author: rocky <rocky@gnu.org>
Commit: rocky <rocky@gnu.org>
Administrivia. Add COPYING, update README and .gitignore, bump version
number.
---
README | 51 ++++++++++++++++++++++++---------------------------
1 file changed, 24 insertions(+), 27 deletions(-)
diff --git a/README b/README
index c7229be..223c9b0 100644
--- a/README
+++ b/README
@@ -1,47 +1,44 @@
-Emacs relative-file load, require __FILE__ and a provide-me macro.
+h2. Emacs relative-file _load_, _require_ *==__FILE__==* and a _provide-me_
macro.
-Here we add functions: load-relative, require-relative,
-require-relative-list, __FILE__, and macro provide-me.
+Here we add functions: *load-relative*, *require-relative*,
*require-relative-list*, *==__FILE__==*, and macro *provide-me*.
-The latest version is at http://github.com/rocky/emacs-load-relative/
+The latest version is at
"http://github.com/rocky/emacs-load-relative/"://github.com/rocky/emacs-load-relative/
-__FILE__ returns the file name that that the calling program is
-running. If you are _eval_’ing a buffer then the file name of that
-buffer is used. The name was selected to be analogous to the name its use in C
or Ruby.
+h3. *==__FILE__==*
-load-relative loads an Emacs Lisp file relative to another (presumably
currently running) Emacs Lisp file. For example if you have files foo.el and
bar.el in the same directory, then to load Emacs Lisp file bar.el from inside
Emacs lisp file foo.el:
+*==__FILE__==* returns the file name that that the calling program is running.
If you are _eval_'ing a buffer then the file name of that buffer is used. The
name was selected to be analogous to the name its use in C or Ruby.
- (require 'load-relative)
+h3. _load-relative_
+
+_load-relative_ loads an Emacs Lisp file relative to another (presumably
currently running) Emacs Lisp file. For example if you have files _foo.el_ and
_bar.el_ in the same directory, then to load Emacs Lisp file _bar.el_ from
inside Emacs lisp file _foo.el_:
+
+bc. (require 'load-relative)
(load-relative "baz")
-That load-relative line could above have also been written as:
+That _load-relative_ line could above have also been written as:
- (load-relative "./baz")
+bc. (load-relative "./baz")
or:
- (load-relative "baz.el") # if you want to exclude any byte-compiled files
+bc. (load-relative "baz.el") # if you want to exclude any byte-compiled files
+
+h3. require-relative, require-relative-list
-require-relative, require-relative-list
+If instead of loading file _baz_, you want to _require_ it:
-If instead of loading file baz, you want to require it:
+bc. (require-relative "baz")
- (require-relative "baz")
+or
-or
+bc. (require-relative "./baz")
- (require-relative "./baz")
+The above not only does a _require_ on _'baz_, but makes sure you get that
from the same file as you would have if you had issued _load_relative_.
-The above not only does a require on ’baz, but makes sure you get
-that from the same file as you would have if you had issued load_relative.
+If you have a list of files you want to _require_, you can require them one
shot using _require-relative-list_ like this:
-If you have a list of files you want to require, you can require
-them one shot using require-relative-list like this:
+bc. (require-relative-list '("dbgr-init" "dbgr-fringe"))
- (require-relative-list '("dbgr-init" "dbgr-fringe"))
+h3. provide-me
-Finally, macro provide-me saves you the trouble of adding a symbol
-after provide, by using the file basename (without directory or file
-extension) as the name of the thing you want to provide. Using this
-forces the provide names to be the same as the filename, but I
-consider that a good thing.
+Finally, macro _provide-me_ saves you the trouble of adding a symbol after
_provide_, by using the file basename (without directory or file extension) as
the name of the thing you want to provide. Using this forces the _provide_
names to be the same as the filename, but I consider that a good thing.
- [nongnu] elpa-admin 487ee79 022/439: Update README to note dependencies and what debugger's we've got., (continued)
- [nongnu] elpa-admin 487ee79 022/439: Update README to note dependencies and what debugger's we've got., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin a53e009 023/439: Merge branch 'master' of github.com:rocky/emacs-dbgr, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 8b07a20 027/439: * README: Explain how to run the repo build script., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 370423c 026/439: * COPYING, ChangeLog, README, admin/org-synch.el,, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin a703bf2 025/439: Merge branch 'master' of github.com:rocky/emacs-load-relative, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 14ac0ef 040/439: Merge branch 'action', Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 35ba6e2 055/439: Update README to describe the new repository layout., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 4866cb7 057/439: admin/archive-contents.el (archive--delete-elc-files): Delete backup files too., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 3ca74c1 011/439: preparing for new rst format document, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 7b9d56b 038/439: README: Move copyright and license text to the end, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 1329950 024/439: Administrivia. Add COPYING, update README and .gitignore, bump version number.,
Philip Kaludercic <=
- [nongnu] elpa-admin f545af1 036/439: Rephrase some parts of README, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 1761424 031/439: Use archive-contents.el script., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 5bbab91 030/439: * packages/all-1.0.el: Change version. Address byte-compiler warnings., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 06a86aa 043/439: Add an explicit OPERATION-MODE "nil" in README's examples, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin c51af29 058/439: Reorganize repository layout, allowing site installation., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 988d3f5 059/439: Add a table of contents to README file, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin d6dfeed 050/439: Fix last change., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 782beee 061/439: Merge branch 'action-autoselect', Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin aae2f27 064/439: imported README from googlecode's homepage, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 6011ab7 066/439: Initial import, Philip Kaludercic, 2021/10/17