Merge pull request #23 from darktable-org/development

Update for 5.4

Author: wpferguson

content/lua.api.manual/darktable/darktable.query_event.md

@@ -0,0 +1,21 @@
+---
+title: darktable.query_event
+id: darktable.query_event
+weight: 196
+draft: false
+author: "people"
+---
+
+```
+function(
+  event_name : string,
+  event_type : string,
+) : boolean
+```
+
+This function determines if an event is registered by [darktable.register_event](darktable.register_event.md).
+Events are documented in the [event](../events) section.
+
+* **event_name** - _string_ - The name of the event registered. The combination of event_name and event_type must be unique.
+* **event_type** - _string_ - The type of the event registered.
+* **return** - _boolean_ - True if the event exists, otherwise false

content/lua.api.manual/events/collection-changed.md

@@ -0,0 +1,25 @@
+---
+title: collection-changed
+id: collection-changed
+weight: 11
+draft: false
+author: "people"
+---
+
+`event`
+
+This event is triggered whenever the lighttable collection changes.  The event triggers anytime the collection module rules change, including simply adding a rule, so the user needs to check to ensure there is actually a change by keeping track of the number of images or checking the collection rules.
+
+# collection-changed.callback
+
+```
+function(
+  event : string,
+)
+```
+
+* **event** - _string_ - The name of the event that triggered the callback.
+
+# collection-changed.extra registration parameters
+
+This event has no extra registration parameters.

content/lua.api.manual/version.md

@@ -8,10 +8,11 @@ author: "people"
 
 # Current API
 
-The Lua API version used in darktable 5.2.x is 9.5.0.
+The Lua API version used in darktable 5.4.x is 9.6.0.
 
 Previous API versions were
 
+- darktable-5.2.x  -  Lua API 9.5.0
 - darktable-5.0.x  -  Lua API 9.4.0
 - darktable-4.8.x  -  Lua API 9.3.0
 - darktable-4.6.x  -  Lua API 9.2.0

content/lua.scripts.manual/scripts/official/regenerate_thumbnails.md

@@ -0,0 +1,39 @@
+---
+title: regenerate_thumbnails
+id: regenerate_thumbnails
+weight: 95
+draft: false
+author: "people"
+---
+
+## Name
+
+regenerate_thumbnails.lua - regenerate mipmap cache for selected images
+
+## Description
+
+regenerate_thumbnails drops the cached thumbnail for each selected image
+and generates a new thumbnail.
+
+The script adds a button to the actions on selected images module that regenerates the
+thumbnail for the currently selected images.
+
+## Usage
+
+* enable the script in script_manager
+* assign a shortcut, if desired, to apply the script by hovering
+  over a skull and using the shortcut to regenerate the thumbnail
+
+## Additional Software Required
+
+None
+
+## Limitations
+
+The image must exist in order to generate the thumbnail
+
+## Author
+
+Bill Ferguson - [email protected]
+
+## Change Log

content/lua.scripts.manual/scripts/overview.md

@@ -18,6 +18,7 @@ These scripts are written primarily by the darktable developers and maintained b
 
 Name|Standalone|Op/Sys |Purpose
 ----|:--------:|:-----:|-------
+[apply_camera_style](official/apply_camera_style.md)|Yes|LMW|Apply camera styles to images
 [check_for_updates](official/check_for_updates.md)|Yes|LMW|Check for updates to darktable
 [copy_paste_metadata](official/copy_paste_metadata.md)|Yes|LMW|Copy and paste metadata, tags, ratings, and color labels between images
 [delete_long_tags](official/delete_long_tags.md)|Yes|LMW|Delete all tags longer than a specified length
@@ -27,6 +28,7 @@ Name|Standalone|Op/Sys |Purpose
 [image_path_in_ui](official/image_path_in_ui.md)|Yes|LMW|Plugin to display selected image path
 [import_filter_manager](official/import_filter_manager.md)|Yes|LMW|Manager for import filters
 [import_filters](official/import_filters.md)|No|LMW|Two import filters for use with import_filter_manager
+[regenerate_thumbnails](official/regenerate_thumbnails.md)|Yes|LMW|Regenerate missing lighttable thumbnails
 [save_selection](official/save_selection.md)|Yes|LMW|Provide save and restore from multiple selection buffers
 [selection_to_pdf](official/selection_to_pdf.md)|No|L|Generate a PDF file from the selected images