git: e42e3044a2 - main - [phb]: Clarify desktop-file-utils

From: Fernando Apesteguía <fernape_at_FreeBSD.org>
Date: Mon, 12 Feb 2024 07:49:29 UTC
The branch main has been updated by fernape:

URL: https://cgit.FreeBSD.org/doc/commit/?id=e42e3044a273335f3065e80051bf473998d1d5c0

commit e42e3044a273335f3065e80051bf473998d1d5c0
Author:     Fernando Apesteguía <fernape@FreeBSD.org>
AuthorDate: 2024-02-12 07:48:00 +0000
Commit:     Fernando Apesteguía <fernape@FreeBSD.org>
CommitDate: 2024-02-12 07:49:16 +0000

    [phb]: Clarify desktop-file-utils
    
    Mention that it should be used if and only if the port installs a .desktop file
    with a MimeType entry in it.
---
 documentation/content/en/books/porters-handbook/uses/_index.adoc | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc
index cd6aa1943c..9b26e8c3a9 100644
--- a/documentation/content/en/books/porters-handbook/uses/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc
@@ -361,6 +361,8 @@ Possible arguments: (none)
 Uses update-desktop-database from package:devel/desktop-file-utils[].
 An extra post-install step will be run without interfering with any post-install steps already in the port [.filename]#Makefile#.
 A line with <<plist-keywords-desktop-file-utils,`@desktop-file-utils`>> will be added to the plist.
+Only use this macro if the port provides a `.desktop` file which contains a
+`MimeType` entry.
 
 [[uses-desthack]]
 == `desthack`