Re: [PATCH] org.el (org-show-context-detail): add option 'ancestors-with-entry

["Cheong Yiu Fung" <mail@yiufung.net>]

[-- Attachment #1: Type: text/plain, Size: 1162 bytes --]

Hi,

On Thu, Apr 22, 2021, at 9:32 PM, Nicolas Goaziou wrote:
> I would say
> 
>   See also [[*Sparse Trees]].
> 
> The ~org-show-context-detail~ variable is mentioned there anyway.

I agree. A new patch for docs is attached. 

> > +  ancestors-full show current subtree and its direct ancestors
> 
> IIUC, it seems to be current subtree, its direct ancestors along with
> their contents. But see below.

Current subtree means everything under it: heading + entry + children.  They
are shown. 

Regarding its ancestors: Only headings are shown. Contents of ancestors are *not*
to be shown.  

> > +    (should (equal '(0 3 7 8 9 10 11)
> > +                   (funcall list-visible-lines 'ancestors-full t)))
> > +    (should (equal '(0 3 7 8 9 10 11)
> > +                   (funcall list-visible-lines 'ancestors-full nil)))
> 
> Are you sure you want to display line 10? No other visibility does that.

Yes, that is the main purpose. The idea is to show the whole subtree (what "full" would
mean). So, whether target is in Self(7) or Match(8), 7-11 should all be shown. This is to
facilitate using tag or TODO keyword to choose what tree to be shown.

Yiufung

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0003-org-manual.org-add-hints-for-visible-only-export.patch --]
[-- Type: text/x-patch; name="0003-org-manual.org-add-hints-for-visible-only-export.patch", Size: 759 bytes --]

From 5fdbffd88f573f132ace4bae2f1665e325bca3a4 Mon Sep 17 00:00:00 2001
From: Cheong Yiu Fung <mail@yiufung.net>
Date: Thu, 22 Apr 2021 23:25:03 +0800
Subject: [PATCH] org-manual.org: add hints for visible-only export

---
 doc/org-manual.org | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/org-manual.org b/doc/org-manual.org
index e809ecadb..74a7c735a 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -11524,7 +11524,7 @@ further alter what is exported, and how.
 
   Toggle visible-only export.  This is useful for exporting only
   certain parts of an Org document by adjusting the visibility of
-  particular headings.
+  particular headings.  See also [[*Sparse Trees]].
 
 ** Export Settings
 :PROPERTIES:
-- 
2.31.0