emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: TEC <tecosaur@gmail.com>
To: "Gustav Wikström" <gustav@whil.se>
Cc: Bastien <bzg@gnu.org>,
	"emacs-orgmode@gnu.org" <emacs-orgmode@gnu.org>,
	Eric S Fraga <e.fraga@ucl.ac.uk>
Subject: Re: Sv: New startup options, show<n>levels
Date: Sun, 13 Dec 2020 23:42:05 +0800	[thread overview]
Message-ID: <87ft49emm6.fsf@gmail.com> (raw)
In-Reply-To: <HE1PR0202MB2857A98F44B759AE6A9A2826DAC80@HE1PR0202MB2857.eurprd02.prod.outlook.com>


Just a quick note on the values proposed.

All of the Alt Ns have overview + N-in-the-name options for N >= 2.
e.g. show2levels, show3levels...

For the sake of completeness/consistency I would suggest having a N=1
variant with that format too. This would duplicate the behaviour of
"overview", but if say I currently have "levels:2" and I want to bump it
down to 1, then I'd naturally go to "levels:1" and expect it to work.

--
Timothy.

Gustav Wikström <gustav@whil.se> writes:

> Already in master (Alt 0): 
>  `overview'        Top-level headlines only.  
>  `content'         All headlines.             
>  `show2levels'     Headline levels 1-2.       
>  `show3levels'     Headline levels 1-3.       
>  `show4levels'     Headline levels 1-4.       
>  `show5levels'     Headline levels 1-5.       
>  `showall'         No folding on any entry.   
>  `showeverything'  Show even drawer contents. 
>
> Alt 1:
>  `overview'        Top-level headlines only.  
>  `content'         All headlines.             
>  `show:2'          Headline levels 1-2.       
>  `show:3'          Headline levels 1-3.       
>  `show:4'          Headline levels 1-4.       
>  `show:5'          Headline levels 1-5.       
>  `showall'         No folding on any entry.   
>  `showeverything'  Show even drawer contents. 
>
> Alt 2:
>  `overview'        Top-level headlines only.  
>  `content'         All headlines.             
>  `levels:2'        Headline levels 1-2.       
>  `levels:3'        Headline levels 1-3.       
>  `levels:4'        Headline levels 1-4.       
>  `levels:5'        Headline levels 1-5.       
>  `showall'         No folding on any entry.   
>  `showeverything'  Show even drawer contents. 
>
> Alt 3:
>  `overview'        Top-level headlines only.  
>  `content'         All headlines.             
>  `content:2'       Headline levels 1-2.       
>  `content:3'       Headline levels 1-3.       
>  `content:4'       Headline levels 1-4.       
>  `content:5'       Headline levels 1-5.       
>  `showall'         No folding on any entry.   
>  `showeverything'  Show even drawer contents.
>
> To me no option is perfect. There are incongruencies for all. Maybe a fourth option?
>
> Alt 4:
> `overview'        Top-level headlines only.  
>  `content'         All headlines.             
>  `2levels'         Headline levels 1-2.       
>  `3levels'         Headline levels 1-3.       
>  `4levels'         Headline levels 1-4.       
>  `5levels'         Headline levels 1-5.       
>  `showall'         No folding on any entry.   
>  `showeverything'  Show even drawer contents.
>
> Since show in showall and showeverything seems to symbolize the unfolding of things.
>
> That would be an improvement based on all three principles above, in that it removes the ambiguity of "show" (and how it relates to unfolding), makes the names shorter, and stays in line with the naming convention (i.e. no ':'). Not sure what the syntax says about names starting with numerals though.
>
> Your call. Personally I'd prefer Alt 4 or the existing one.
>
> /Gustav
>
>> -----Ursprungligt meddelande-----
>> Från: Eric S Fraga <e.fraga@ucl.ac.uk>
>> Skickat: den 13 december 2020 10:49
>> Till: Bastien <bzg@gnu.org>
>> Kopia: Gustav Wikström <gustav@whil.se>; emacs-orgmode@gnu.org
>> Ämne: Re: New startup options, show<n>levels
>> 
>> On Saturday, 12 Dec 2020 at 18:54, Bastien wrote:
>> > In this case, I think we could come up with better option names than
>> > "show2levels", even if I don't have a better suggestion right now.
>> 
>> I agree.  I had started responding to Gustav when the original post
>> appeared but then aborted my response.  I wonder whether something like
>> levels:N or show:N or content:N is possible in a startup setting, akin
>> to H:N in options?
>> 
>> I do have (org-content N) often in my file local variables in any case.
>> --
>> : Eric S Fraga via Emacs 28.0.50, Org release_9.4-160-g7c8dce



      reply	other threads:[~2020-12-13 15:46 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-12-10  9:46 New startup options, show<n>levels Gustav Wikström
2020-12-12 17:54 ` Bastien
2020-12-12 18:56   ` Gustav Wikström
2020-12-13  9:48   ` Eric S Fraga
2020-12-13 10:19     ` TEC
2020-12-13 10:19     ` TEC
2020-12-13 15:36     ` Sv: " Gustav Wikström
2020-12-13 15:42       ` TEC [this message]

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=87ft49emm6.fsf@gmail.com \
    --to=tecosaur@gmail.com \
    --cc=bzg@gnu.org \
    --cc=e.fraga@ucl.ac.uk \
    --cc=emacs-orgmode@gnu.org \
    --cc=gustav@whil.se \
    /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
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public 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).