Re: [Docutils-users] emacs can't create index

[Ed B. <edm...@gm...>]

HI,


that's it!

Putting a title fixed it!!

Many thanks Stefan!


Ed


On 18 July 2018 at 17:57, Stefan Merten <st...@me...> wrote:

> Hi Ed!
>
> 3 hours ago Ed Brunelle wrote:
> > I have the following test.rst :
> >
> > list1
> > -----
> >
> > list2
> > -----
> >
> > list3
> > -----
>
> Thanks. I can reproduce the problem.
>
> `rst-toc-insert` is somewhat picky in what it accepts. I do not use it
> myself (and have not developed it myself) and doubt it's use. Thus I
> did not do anything to make it more useful. I just removed a couple of
> bugs ;-) .
>
> In fact you have found something I call a mis-feature in my unit
> tests for this function.
>
> Please read the documentation of `rst-toc-insert` carefully:
>
>   Insert the table of contents of the current section at the current
> column.
>   By default the top level is ignored if there is only one, because
>   we assume that the document will have a single title.
>
> Your document has neither a title nor is the cursor in a section. Try
> it with this example:
>
> =====
> TITLE
> =====
>
> list1
> -----
>
> list2
> -----
>
> list3
> -----
>
>
> Now in the line after the title `rst-toc-insert` works as documented.
>
> However, the intended usage of this function is to use it at the point
> marked by ``^@``:
>
> =====
> TITLE
> =====
>
> .. ^@
>
> list1
> -----
>
> list2
> -----
>
> list3
> -----
>
>
>                                                 Grüße
>
>                                                 Stefan
>