[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/org-transclusion 92b3eaed55: docs: add note on 'sentenc
From: |
ELPA Syncer |
Subject: |
[elpa] externals/org-transclusion 92b3eaed55: docs: add note on 'sentence-end' in the manual for thing-at-point |
Date: |
Mon, 8 May 2023 12:59:15 -0400 (EDT) |
branch: externals/org-transclusion
commit 92b3eaed55bb8e34520a6d998a87d50c7643d1b3
Author: Noboru Ota <me@nobiot.com>
Commit: Noboru Ota <me@nobiot.com>
docs: add note on 'sentence-end' in the manual for thing-at-point
---
docs/org-transclusion-manual.org | 5 +++++
test/things-at-point-dir/story.txt | 4 +---
test/things-at-point.org | 5 +++--
3 files changed, 9 insertions(+), 5 deletions(-)
diff --git a/docs/org-transclusion-manual.org b/docs/org-transclusion-manual.org
index a97b185f5e..ddcceac34f 100644
--- a/docs/org-transclusion-manual.org
+++ b/docs/org-transclusion-manual.org
@@ -500,6 +500,11 @@ You can add =:thing-at-point= property to transclude a
certain "thing" at point
As it stands now, you cannot use :thing-at-point to specify the precise
beginning of the thing within a line -- it is always the beginning of the line.
#+end_quote
+#+ATTR_TEXINFO: :tag Note
+#+begin_quote
+The definition of sentence is controlled by various variables in Emacs. It is
suggested to consult the documentation of function ~sentence-end~. For those
who do not use double-space after a period (in the language this is relevant),
it is probably more intuitive to turn off customizing
~sentence-end-double-space~. The default behavior is this: "Non-nil means a
single space does not end a sentence."
+#+end_quote
+
See Example 4. When you have a text file for prose, you can use paragraph or
sentence as a "thing" to transclude. In this example, the beginning of the
source of transclude is specified by the search option with "::Once upon a
time". The two colons "::" immediately following the file name denote the
search option, which is a built-in Org syntax. Then the paragraph or sentence
beginning "Once upon a time" is transcluded. When the source file contains
multiple occurrences of "Once upon a [...]
Example 4:
diff --git a/test/things-at-point-dir/story.txt
b/test/things-at-point-dir/story.txt
index 3c9521de54..bec7eab5cd 100644
--- a/test/things-at-point-dir/story.txt
+++ b/test/things-at-point-dir/story.txt
@@ -1,7 +1,5 @@
This is a story
-Once upon a time. This paragraph should be transcluded. This is a story.
-And if I have a hard line break, I belive this line is still part of
-the paragraph as defined by ... thing-at-point I think.
+Once upon a time. This paragraph should be transcluded. This is a story. And
if I have a hard line break, I belive this line is still part of the paragraph
as defined by ... thing-at-point I think.
This is a new paragraph and should not be included.
diff --git a/test/things-at-point.org b/test/things-at-point.org
index 3fd9568b64..d36100acfa 100644
--- a/test/things-at-point.org
+++ b/test/things-at-point.org
@@ -16,9 +16,10 @@ I expect these will be more common:
sexp
list
-#+transclude: [[./things-at-point-dir/story.txt::Once upon a time][story]]
:thing-at-point paragraph
-#+transclude: [[./things-at-point-dir/story.txt::Once upon a time][story]]
:thing-at-point sentence
+#+transclude: [[./things-at-point-dir/story.txt::Once upon a time][story]]
:end "2" :thing-at-point paragraph
+
+#+transclude: [[./things-at-point-dir/story.txt::Once upon a time][story]]
:end "3" :thing-at-point sentence
#+transclude: [[./things-at-point-dir/baz.el::id:1234567890][barz-baz-fuzz]]
:src elisp
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [elpa] externals/org-transclusion 92b3eaed55: docs: add note on 'sentence-end' in the manual for thing-at-point,
ELPA Syncer <=