emacs-elpa-diffs
[Top][All Lists]
Advanced

[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
 



reply via email to

[Prev in Thread] Current Thread [Next in Thread]