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

> David Masterson <dsmaster...@icloud.com> writes:
>
>>>>  #+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
>
> Why not simply * First (top) level headline?

That's okay too.

>>>>    #+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.
>
> You said "children of that level". What about grandchildren? It is not
> clear what happens at deeper levels from your new wording. Say,

I get the point, so I guess the appropriate term is "descendants".  In
most of my compsci training, we talked about parent-child relationships
in a broad way to mean "parent and ancestors" and "child and
descendants", so I made an assumption that I shouldn't.

I'll put a new patch together tomorrow.

Thanks for the input.
-- 
David Masterson

Reply via email to