Re: Sv: New startup options, show<n>levels

[TEC]

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