From 57e56ed55cd278e6c7eb8cf2a0f4b9fa4160781e Mon Sep 17 00:00:00 2001
From: Albert Krewinkel <albert@zeitkraut.de>
Date: Thu, 4 Feb 2021 19:07:59 +0100
Subject: [PATCH] doc/lua-filters.md: improve docs for `pandoc.mediabag.insert`

---
 doc/lua-filters.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/doc/lua-filters.md b/doc/lua-filters.md
index 3b3c03727..a99dc9008 100644
--- a/doc/lua-filters.md
+++ b/doc/lua-filters.md
@@ -3084,7 +3084,8 @@ Clear-out the media bag, deleting all items.
 
 `insert (filepath, mime_type, contents)`
 
-Adds a new entry to pandoc's media bag.
+Adds a new entry to pandoc's media bag. Replaces any existing
+mediabag entry with the same `filepath`.
 
 Parameters:
 
@@ -3092,7 +3093,7 @@ Parameters:
 :   filename and path relative to the output folder.
 
 `mime_type`:
-:   the file's MIME type
+:   the file's MIME type; use `nil` if unknown or unavailable.
 
 `contents`:
 :   the binary contents of the file.