Adjust phrasing of install instructions?

[alansley]

Hi! Thanks for your plugin.

Either the install instructions are a little ambiguous or I'm an idiot (and the latter could well be the case) - as you have to enable the plugin in Preferences and then select Preferences again on the plugin to actually enable it!

Is it not possible to have the secondary preference (restore windows) checked by default?

Anyways, while it is of course entirely up to you, this is how I would suggest you phrase the README.md instructions:

1. Download and extract the latest release (yes, the source code (zip) file is the one as the plugin is not a compiled binary),
2. Go to ~/.local/share/gedit and create a folder called plugins if one does not already exist,
3. Copy the extracted ex-mortis folder and the ex-mortis.plugin file into your gedit plugins folder:
   
4. Restart gedit,
5. With geddit restarted, go to Settings | Preferences | Plugins and check the box for the Ex-Mortis entry..
6. ..THEN with the Ex-Mortis plugin selected click the [Preferences] button at the bottom of the Plugins window and check the Restore windows between sessions checkbox.
7. Restart gedit again, preferably using Quit in the Application menu or the File menu. This is necessary because the plugin cannot reopen any windows that were open when the plugin was activated.

No worries if you don't like the re-phrasing - just thought I'd try to be useful :)

[jefferyto]

as you have to enable the plugin in Preferences and then select Preferences again on the plugin to actually enable it!

Is it not possible to have the secondary preference (restore windows) checked by default?

From the one-line description of the plugin:

Reopen closed windows and optionally restore windows between sessions

There are two parts: reopen closed windows, and optionally restore windows between sessions. The Usage section of the readme has more details.

Reopening closed windows is available once the plugin is enabled (and after restarting gedit).

As restoring windows between sessions changes the (default) behaviour of the program, I think it is better to have the user opt into it rather than to have it enabled by default.

[alansley]

I don't know anything about having multiple copies of gedit open - when I open gedit it opens, and if I go to open gedit again it just brings the existing gedit instance to the front. With regard to the the preferences preference - considering that 'restore tabs' is the one and only option available in the plugin preferences, and that people are specifically installing the plugin in order to restore tabs on open I disagree that there should be a secondary manual 'opt-in', but it is of course entirely up to you. Should you opt to maintain the existing 'non-checked' default then I would ask that you rephrase the install instructions to explicitly state that the `Preferences/Plugins/<select plugin>/Preferences/check-the-box` path must be taken in order for the plugin to restore tabs on startup.

…

On Thu, 25 Jan 2024 at 20:04, Jeffery To ***@***.***> wrote: as you have to enable the plugin in *Preferences* and then select *Preferences* again on the plugin to actually enable it! Is it not possible to have the secondary preference (restore windows) checked by default? From the one-line description of the plugin: Reopen closed windows and optionally restore windows between sessions There are two parts: reopen closed windows, and optionally restore windows between sessions. The Usage <https://github.com/jefferyto/gedit-ex-mortis#usage> section of the readme has more details. Reopening closed windows is available once the plugin is enabled (and after restarting gedit). As restoring windows between sessions changes the (default) behaviour of the program, I think it is better to have the user opt into it rather than to have it enabled by default. — Reply to this email directly, view it on GitHub <#10 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ACCQJQJPH5IAPFT5VGUKCX3YQIN3PAVCNFSM6AAAAABCKDTI46VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMYTSMBZG4YDENBYGM> . You are receiving this because you authored the thread.Message ID: ***@***.***>