From: Visuwesh <visuweshm@gmail.com>
To: dalanicolai <dalanicolai@gmail.com>
Cc: Emacs Devel <emacs-devel@gnu.org>
Subject: Re: [ELPA] New package: toc-mode
Date: Mon, 26 Sep 2022 21:39:18 +0530 [thread overview]
Message-ID: <87illadsnl.fsf@gmail.com> (raw)
In-Reply-To: <CACJP=3kow=7J9uxnLEZDv0kt5TZ66fBDD1kT59MW7GE4KC7p8A@mail.gmail.com> (dalanicolai@gmail.com's message of "Sun, 25 Sep 2022 18:47:50 +0200")
[ஞாயிறு செப்டம்பர் 25, 2022] dalanicolai wrote:
> Thanks for the feedback!
Thank you for your answers!
> 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
Having to hold S-<left/right> till the number increases by 20 is not
fast enough, unfortunately.
> As mentioned in the instructions for the tabular mode
> <https://github.com/dalanicolai/toc-mode#3-toc-tabular-adjust-pagenumbers>
> 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.
I completely missed C-r since it wasn't mentioned in the Commentary
section, nor does the command have a docstring. 🙃
> For point 2, the answer again is that you can press C-r on the field to
> update it.
I see now, thanks.
> 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
> <https://github.com/dalanicolai/toc-mode#2-toc-cleanup>.
I figured it out but it took me some time to find out that whitespace
governs the outline level. Maybe I missed the explanation in the
Commentary since I skimmed it due to being in a hurry (my mistake!).
> 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
> <https://github.com/dalanicolai/toc-mode#usage>. Or are you thinking about
> something else?
I was thinking we could put the keybinding texts from the Commentary in
the major-mode docstrings since it is hard to fish through all the
bindings and find the toc-mode ones.
;; toc-mode (tablist)
;; TAB~ preview/jump-to-page
;; right/left toc-in/decrease-remaining
;; C-right/C-left toc-in/decrease-remaining and view page
;; S-right/S-left in/decrease pagenumber current entry
;; C-down/C-up scroll document other window (if document buffer shown)
;; S-down/S-up full page scroll document other window ( idem )
;; C-j toc--jump-to-next-entry-by-level
[ Here, the Commentary section and the README file are out-of-sync. I
tried `C-x v +' but it didn't pull any new changes, you might want to
check this. ]
> Of course if you see any improvement, then patches are welcome (although I
> prefer pull
> requests, but all is fine).
Sure, I will make a pull request.
prev parent reply other threads:[~2022-09-26 16:09 UTC|newest]
Thread overview: 25+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-09-20 12:33 [ELPA] New package: toc-mode dalanicolai
2022-09-20 15:57 ` Jean Louis
2022-09-20 20:51 ` Emanuel Berg
2022-09-20 17:37 ` Philip Kaludercic
2022-09-21 6:57 ` dalanicolai
2022-09-21 7:09 ` Emanuel Berg
2022-09-21 16:55 ` dalanicolai
2022-09-21 16:58 ` dalanicolai
2022-09-21 7:46 ` Philip Kaludercic
2022-09-20 18:04 ` Stefan Kangas
2022-09-20 21:30 ` Jose A Ortega Ruiz
2022-09-21 7:12 ` dalanicolai
2022-09-22 8:02 ` Jean Louis
2022-09-22 15:27 ` Jose A Ortega Ruiz
2022-09-20 22:03 ` Stefan Monnier
2022-09-21 7:18 ` dalanicolai
2022-09-21 7:19 ` dalanicolai
2022-09-25 11:44 ` Visuwesh
2022-09-25 16:47 ` dalanicolai
2022-09-25 16:57 ` dalanicolai
2022-09-25 17:13 ` Yuri Khan
2022-09-25 21:18 ` dalanicolai
2022-09-25 21:37 ` Philip Kaludercic
2022-09-26 4:55 ` dalanicolai
2022-09-26 16:09 ` Visuwesh [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87illadsnl.fsf@gmail.com \
--to=visuweshm@gmail.com \
--cc=dalanicolai@gmail.com \
--cc=emacs-devel@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).