…lugin description You can view, comment on, or merge this pull request online at:
https://github.com/geany/geany/pull/4077
-- Commit Summary --
* persistent-temp-files-plugin: (persistent-untitled-documents) added plugin description
-- File Changes --
M doc/geany.txt (38)
-- Patch Links --
https://github.com/geany/geany/pull/4077.patch https://github.com/geany/geany/pull/4077.diff
@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?
@LiquidCake pushed 1 commit.
c40c7757cfce3ddd5670ef954ccab0dae39600b8 persistent-temp-files-plugin: (persistent-untitled-documents) added plugin description
@LiquidCake commented 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
done
@LiquidCake commented on this pull request.
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
done
@LiquidCake commented on this pull request.
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.
done
@LiquidCake commented on this pull request.
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.
done
@LiquidCake commented on this pull request.
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
done
@LiquidCake commented on this pull request.
-^^^^^^^^^^^^
-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.
done
@LiquidCake commented on this pull request.
+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.
done
@LiquidCake commented 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 +^^^^^^^^^^^^^^^^^^^^^^ + +This plugin automatically creates an underlying file for newly-opened editor tabs
done
applied all proposed fixes
Looks good, thanks. With the documentation of templates, let's wait how what I proposed in https://github.com/geany/geany/pull/3911#issuecomment-2504626664 turns out.
@techee approved this pull request.
Merged #4077 into master.
github-comments@lists.geany.org