[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa-admin 22e8332 018/439: Nope changing the name made things
From: |
Philip Kaludercic |
Subject: |
[nongnu] elpa-admin 22e8332 018/439: Nope changing the name made things worse. |
Date: |
Sun, 17 Oct 2021 15:47:27 -0400 (EDT) |
branch: elpa-admin
commit 22e83324fd35736e914ac4b3914441875f6482da
Author: rocky <rocky@gnu.org>
Commit: rocky <rocky@gnu.org>
Nope changing the name made things worse.
---
README | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 53 insertions(+)
diff --git a/README b/README
new file mode 100644
index 0000000..fb75923
--- /dev/null
+++ b/README
@@ -0,0 +1,53 @@
+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*.
+
+The latest version is at
"http://github.com/rocky/emacs-load-relative/"://github.com/rocky/emacs-load-relative/
+
+h3. *==__FILE__==*
+
+*==__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. _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:
+
+bc. (load-relative "./baz")
+
+or:
+
+bc. (load-relative "baz.el") # if you want to exclude any byte-compiled files
+
+h3. require-relative, require-relative-list
+
+If instead of loading file _baz_, you want to _require_ it:
+
+bc. (require-relative "baz")
+
+or
+
+bc. (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_.
+
+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"))
+
+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.
- [nongnu] elpa-admin 07ef2ff 033/439: Add README file, (continued)
- [nongnu] elpa-admin 07ef2ff 033/439: Add README file, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin f8051b4 032/439: Fixes to archive-contents.el and package-update.sh., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin dbbb145 035/439: Clearer reference to the license text, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 3c6d0e1 037/439: Copy examples from wcheck-language-data doc to README, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 26ce878 006/439: # Updated for SourceForge, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin d8ee815 005/439: # Updated stuff., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 6ee3dad 009/439: Added script and documentation for installing from CVS, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin d9cdf2a 008/439: Added comment about installing with multiple emacsen., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 938c532 010/439: add README file., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 6de6395 017/439: See if changing the name from README to README.markup gives github a clue, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 22e8332 018/439: Nope changing the name made things worse.,
Philip Kaludercic <=
- [nongnu] elpa-admin 3f66070 019/439: Turn README back into text. Add special redcloth version., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 50fc47c 021/439: Update email addresses., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 051b643 041/439: README: Add a section about source code repository, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin ae7a3df 034/439: Copy Emacs wiki page's content to new README file, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 33a5782 042/439: Ensure case-fold-search=t in the example email detect function, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin e5ad0fa 044/439: Rephrase examples, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin cff4ab8 045/439: Add a note for programmers about wcheck-marked-text-at, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 1d4d089 094/439: Mark merge point of ack-el., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 170624f 106/439: Avoid lm-homepage which is not in Emacs-24.3, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin e6d646f 117/439: tutorials, Philip Kaludercic, 2021/10/17