emacs-orgmode
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Sv: New startup options, show<n>levels


From: Gustav Wikström
Subject: Sv: New startup options, show<n>levels
Date: Sun, 13 Dec 2020 15:36:33 +0000

Hi,

I believe we still can change the name if that’s preferred. I'm not overly 
attached to the name I committed, although I fail to see the ugliness in it. 
And it's only in master since a few days. No biggie to change.

In my opinion it's important to see the names in their context. One context is 
the other available startup options.

Principles I tried to follow when choosing the names (Alt 0 below):
1) Keep the name as close to the intent as possible. It should be possible to 
understand it based on name alone, if possible. (I.e. avoid ambiguity)
2) Let the pattern for the name match with the pattern already existing for 
names in its surrounding context.
3) Keep it short, but prefer principle 1 and 2 to short.

The following options have been presented, where the first one is already in 
master:

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 via email to

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