@techee requested changes on this pull request.


>  
 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.

>  
 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..."

>  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`

>  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"

>  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"

>  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"

> -^^^^^^^^^^^^
-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 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 or view it on GitHub:
https://github.com/geany/geany/pull/4077#pullrequestreview-2465410374
You are receiving this because you are subscribed to this thread.

Message ID: <geany/geany/pull/4077/review/[email protected]>

Reply via email to