[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa-admin 3f66070 019/439: Turn README back into text. Add spe
From: |
Philip Kaludercic |
Subject: |
[nongnu] elpa-admin 3f66070 019/439: Turn README back into text. Add special redcloth version. |
Date: |
Sun, 17 Oct 2021 15:47:27 -0400 (EDT) |
branch: elpa-admin
commit 3f66070265869b86025b91d16a4a17e15d5bfde0
Author: rocky <rocky@gnu.org>
Commit: rocky <rocky@gnu.org>
Turn README back into text. Add special redcloth version.
---
README | 54 ++++++++++++++++++++++++------------------------------
1 file changed, 24 insertions(+), 30 deletions(-)
diff --git a/README b/README
index fb75923..c7229be 100644
--- a/README
+++ b/README
@@ -1,53 +1,47 @@
-h2. Emacs relative-file _load_, _require_ *==__FILE__==* and a _provide-me_
macro.
+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/"://github.com/rocky/emacs-load-relative/
+The latest version is at http://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
+__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_:
+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)
+ (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:
-bc. (load-relative "./baz")
+ (load-relative "./baz")
or:
-bc. (load-relative "baz.el") # if you want to exclude any byte-compiled files
-
-h3. require-relative, require-relative-list
+ (load-relative "baz.el") # if you want to exclude any byte-compiled files
-If instead of loading file _baz_, you want to _require_ it:
+require-relative, require-relative-list
-bc. (require-relative "baz")
+If instead of loading file baz, you want to require it:
-or
+ (require-relative "baz")
-bc. (require-relative "./baz")
+or
-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_.
+ (require-relative "./baz")
-If you have a list of files you want to _require_, you can require
-them one shot using _require-relative-list_ like this:
+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.
-bc. (require-relative-list '("dbgr-init" "dbgr-fringe"))
+If you have a list of files you want to require, you can require
+them one shot using require-relative-list like this:
-h3. provide-me
+ (require-relative-list '("dbgr-init" "dbgr-fringe"))
-Finally, macro _provide-me_ saves you the trouble of adding a symbol
-after _provide_, by using the file basename (without directory or file
+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
+forces the provide names to be the same as the filename, but I
consider that a good thing.
- [nongnu] elpa-admin f8051b4 032/439: Fixes to archive-contents.el and package-update.sh., (continued)
- [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, 2021/10/17
- [nongnu] elpa-admin 3f66070 019/439: Turn README back into text. Add special redcloth version.,
Philip Kaludercic <=
- [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
- [nongnu] elpa-admin a73fa6a 113/439: update link in README, Philip Kaludercic, 2021/10/17