emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: "Cheong Yiu Fung" <mail@yiufung.net>
To: "Nicolas Goaziou" <mail@nicolasgoaziou.fr>
Cc: Emacs-orgmode <emacs-orgmode@gnu.org>
Subject: Re: [PATCH] org.el (org-show-context-detail): add option 'ancestors-with-entry
Date: Thu, 22 Apr 2021 23:31:52 +0800	[thread overview]
Message-ID: <57807c65-3ba8-4d4a-b584-cbe8cfe45f1c@www.fastmail.com> (raw)
In-Reply-To: <87lf9a4f8l.fsf@nicolasgoaziou.fr>

[-- 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


  reply	other threads:[~2021-04-22 15:33 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-04-16 13:39 Cheong Yiu Fung
2021-04-19  8:21 ` Nicolas Goaziou
2021-04-19 16:03   ` Cheong Yiu Fung
2021-04-20 13:15     ` Nicolas Goaziou
2021-04-20 13:38       ` Cheong Yiu Fung
2021-04-21  9:15         ` Cheong Yiu Fung
2021-04-21  9:51           ` Cheong Yiu Fung
2021-04-22 13:32             ` Nicolas Goaziou
2021-04-22 15:31               ` Cheong Yiu Fung [this message]
2021-04-27 20:31                 ` Nicolas Goaziou

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=57807c65-3ba8-4d4a-b584-cbe8cfe45f1c@www.fastmail.com \
    --to=mail@yiufung.net \
    --cc=emacs-orgmode@gnu.org \
    --cc=mail@nicolasgoaziou.fr \
    --subject='Re: [PATCH] org.el (org-show-context-detail): add option '\''ancestors-with-entry' \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link

Code repositories for project(s) associated with this inbox:

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).