Re: [ELPA] New package: toc-mode

[dalanicolai]

I guess it does no harm to explicitly mention it again here (it is also in the usage instructions)...

If you have a scanned pdf, then it is strongly recommended to use the pdf.tocgen functionality.

Using that, then in most cases, you can really extract the TOC and add it to the document in

a (few) minute(s).

On Sun, 25 Sept 2022 at 18:47, dalanicolai <dalanicolai@gmail.com> wrote:

Thanks for the feedback!

However, I am not sure if I understand every point correctly.

For point 1, I would say just keeping (S)-<left/right> pressed works so fast, that I think

it is not necessary to set the page number by reading from the user (b.t.w. I think,

generally, C-<left/right> are the most useful keys in tabular-mode). As mentioned in

the instructions for the tabular mode the contents of every field in tabular mode can be

updated by reading from the user through placing the cursor on the field and then pressing

C-r. I see now, that the phrasing of that instruction could be a improved.

For point 2, the answer again is that you can press C-r on the field to update it. However,

the tabular-mode should mainly be used for adjusting the page numbers. Cleaning up, and

setting levels, should preferably be done in the 'cleanup' stage.

As far as I know, the most use keybindings are major-mode keybindings, and automatically

listed when checking the mode documentation using C-h m, as mentioned in

the first section of the usage instructions. Or are you thinking about something else?

Of course if you see any improvement, then patches are welcome (although I prefer pull

requests, but all is fine).

On Sun, 25 Sept 2022 at 13:44, Visuwesh <visuweshm@gmail.com> wrote:

[செவ்வாய் செப்டம்பர் 20, 2022] dalanicolai wrote:

> This package has been for a while on MELPA now, but it would be nice if it
> could be moved to ELPA. The source can be found at
> https://github.com/dalanicolai/toc-mode.
>
> I would like to mention that the PDF functionalities largely depend on
> pdf-tools, which is not on
> ELPA of course (doc-view unfortunately does not provide the right
> features). I am not sure
> if that somehow is a problem.
>
> [...]

Thanks for this package, it simplified adding TOC to a pdf file
immensely but I had a couple hiccups when using it:

    1. Can we have a command that sets the page number of an outline
       item by reading it from the user?  I.e., if I say M-x
       toc-set-page-number RET 20, it would set the heading's page
       number to 20, and a respective -remaining command.  This would be
       a very nice complement to <right> and S-<right> that we already
       have.  Equivalently, we could also accept a numeric argument for
       <right> and S-<right>.
    2. AFAICT, there is no way to edit the outline level from the
       tabular buffer?  Is this possible, I figured out the way to
       adjust the level is to edit the spaces in the first buffer, but
       that took some trying to figure out.
    3. Finally, can you put the commonly used keybinding in the
       major-mode's documentation?

If you would like to have these as patches instead, then I can try to
shoot some in two weeks time.