@techee requested changes on this pull request.

In doc/geany.txt:

>  
 You can save the current document when the editor's focus goes out.
 Every pop-up, menu dialogs, or anything else that can make the editor lose the focus,
 will make the current document to be saved.
 
 
+Untitled Document Save

I'd suggest moving it behind the "Backup copy" section so the order is identical to the order of tabs in settings.

In doc/geany.txt:

>  
 You can save the current document when the editor's focus goes out.
 Every pop-up, menu dialogs, or anything else that can make the editor lose the focus,
 will make the current document to be saved.
 
 
+Untitled Document Save
+^^^^^^^^^^^^^^^^^^^^^^
+
+This plugin automatically creates an underlying file for newly-opened editor tabs

I know it comes from the original description but I'd say "This configuration allows to automatically create an underlying..."

In doc/geany.txt:

>  Instant Save
-^^^^^^^^^^^^
-This plugin sets on every new file (*File->New* or *File->New (with template)*)
-a randomly chosen filename and set its filetype appropriate to the used template
-or when no template was used, to a configurable default filetype.
-This enables you to quickly compile, build and/or run the new file without the
-need to give it an explicit filename using the Save As dialog. This might be
-useful when you often create new files just for testing some code or something
-similar.
+````````````
+
+In this mode, for each new editor tab opened by the user - plugin creates a new

- plugin creates -> , the plugin creates

In doc/geany.txt:

>  Instant Save
-^^^^^^^^^^^^
-This plugin sets on every new file (*File->New* or *File->New (with template)*)
-a randomly chosen filename and set its filetype appropriate to the used template
-or when no template was used, to a configurable default filetype.
-This enables you to quickly compile, build and/or run the new file without the
-need to give it an explicit filename using the Save As dialog. This might be
-useful when you often create new files just for testing some code or something
-similar.
+````````````
+
+In this mode, for each new editor tab opened by the user - plugin creates a new
+file with randomly generated name inside a configured directory.

"a configured directory" -> "the configured directory"

In doc/geany.txt:

>  Instant Save
-^^^^^^^^^^^^
-This plugin sets on every new file (*File->New* or *File->New (with template)*)
-a randomly chosen filename and set its filetype appropriate to the used template
-or when no template was used, to a configurable default filetype.
-This enables you to quickly compile, build and/or run the new file without the
-need to give it an explicit filename using the Save As dialog. This might be
-useful when you often create new files just for testing some code or something
-similar.
+````````````
+
+In this mode, for each new editor tab opened by the user - plugin creates a new
+file with randomly generated name inside a configured directory.
+This enables user to quickly compile, build and/or run the new file without the

"user" -> "users"

In doc/geany.txt:

>  Instant Save
-^^^^^^^^^^^^
-This plugin sets on every new file (*File->New* or *File->New (with template)*)
-a randomly chosen filename and set its filetype appropriate to the used template
-or when no template was used, to a configurable default filetype.
-This enables you to quickly compile, build and/or run the new file without the
-need to give it an explicit filename using the Save As dialog. This might be
-useful when you often create new files just for testing some code or something
-similar.
+````````````
+
+In this mode, for each new editor tab opened by the user - plugin creates a new
+file with randomly generated name inside a configured directory.
+This enables user to quickly compile, build and/or run the new file without the
+need to assign it an explicit filename through the Save As dialog.

remove "it"

In doc/geany.txt:

> -^^^^^^^^^^^^
-This plugin sets on every new file (*File->New* or *File->New (with template)*)
-a randomly chosen filename and set its filetype appropriate to the used template
-or when no template was used, to a configurable default filetype.
-This enables you to quickly compile, build and/or run the new file without the
-need to give it an explicit filename using the Save As dialog. This might be
-useful when you often create new files just for testing some code or something
-similar.
+````````````
+
+In this mode, for each new editor tab opened by the user - plugin creates a new
+file with randomly generated name inside a configured directory.
+This enables user to quickly compile, build and/or run the new file without the
+need to assign it an explicit filename through the Save As dialog.
+
+By default, OS temp directory is used so files are cleaned up after reboot.

"OS temp" -> "the operating system temporary"

In doc/geany.txt:

> +In this mode, for each new editor tab opened by the user - plugin creates a new
+file with randomly generated name inside a configured directory.
+This enables user to quickly compile, build and/or run the new file without the
+need to assign it an explicit filename through the Save As dialog.
+
+By default, OS temp directory is used so files are cleaned up after reboot.
+
+Persistent Untitled Documents
+`````````````````````````````
+
+Goal of this mode is to automatically persist the contents of newly-created editor
+tab, so user could just spawn it, add some text and close Geany in 1 click without
+having to explicitly save current work through the Save As dialog.
+Tab will re-appear on next Geany launch with all its contents restored.
+
+Geany manages and cleans up an underlying storage files automatically.

Beware, I'm not a native speaker, but I'd rephrase this section this way:

Unlike Instant Save, which treats untitled documents as temporary files that are automatically deleted, untitled documents in this mode behave more like ordinary files that are stored permanently. Users do not have to worry about saving or restoring such files by themselves - all untitled documents are auto-saved at regular intervals and restored on Geany start or when opening/closing projects.

By default, files backing untitled documents in this mode are stored under the Geany configuration directory.

Does this sound good to you?

—
Reply to this email directly, view it on GitHub, or unsubscribe.
You are receiving this because you are subscribed to this thread.