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 <gus...@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.fr...@ucl.ac.uk> >> Skickat: den 13 december 2020 10:49 >> Till: Bastien <b...@gnu.org> >> Kopia: Gustav Wikström <gus...@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