Ihor Radchenko <yanta...@posteo.net> writes: > David Masterson <dsmaster...@icloud.com> writes: > >> The documentation for 'org-export-headline-levels' seems problematic. I >> was going to suggest a patch, but thought I'd ask first. >> >> The problem is in the definition of 'level'. One could see a header >> with one '*' as "above" one with two. On the other hand, the value of >> this variable is a number and, so, without further explanation, someone >> (me) might read a value of '3' as encompassing values below '3' and, >> thus, confuse the term "above" in the docstring (and Org Manual) to mean >> greater than 3. >> >> Do others see this? > > The docstring has no word "above", so I do not quite understand what you > are talking about.
My mistake -- two doc places (that I saw): 1. docstring mentions inferior without defining inferior. I think a natural mistake is to assume inferior is where the headline level is less than org-export-headline-levels (ie. < 3) 2. In "13.2 Export Setting", 'H' says "below that level" -- again where the value is less than 3? The issue is level -- is it (1) the number of stars in the header or do the stars mean (2) 1=highest and N=lowest level. Since this is a "programmer's editor", my tendency is toward #1 (level=star#) and avoid the use of inferior/superior in favor of above/below. -- David Masterson
