Ihor Radchenko <yanta...@posteo.net> writes:

> David Masterson <dsmaster...@icloud.com> writes:
>
>> Ah, should've used the MIME commmand -- resending PATCH.
>
> This is a diff, not a patch :)

Oops

> A patch would also need to have a commit message.
> See https://orgmode.org/worg/org-contribute.html#patches

I'll look at that.

>>  #+begin_example
>> -,* Top level headline
>> +,* Top (or first) level headline
>
> IMHO, this sounds like "top" and "first" are two different things. Maybe
> it is my non-native English.

In keeping with the rest of the example, how about:

* First (AKA top) level headline

>>    #+vindex: org-export-headline-levels
>> -  Set the number of headline levels for export
>> -  (~org-export-headline-levels~).  Below that level, headlines are
>> -  treated differently.  In most backends, they become list items.
>> +  Set the last headline level for export as a headline
>> +  (~org-export-headline-levels~).  For children of that level,
>> +  headlines are treated differently.  In most backends, they become
>> +  list items.
>
> I am not sure how I feel about "children of that level". Does it mean
> headings having `org-export-headline-levels' level that are also a
> children of some other heading? I feel that there is a potential
> confusion in such phrasing.

I'm not sure I understand:
+ outlines are fundamentally parent-child relationships.
+ a top level header has no parents -- all other headers have 1 parent.
+ links between headers are not parent-child relationships.
+ maybe I should've said "children of headlines at that level" ??

-- 
David Masterson

Reply via email to