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

Fernando Apesteguía <[email protected]>
Newsgroups gmane.os.freebsd.devel.cvs.doc
Message-ID <[email protected]>
The branch main has been updated by fernape:

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

commit e42e3044a273335f3065e80051bf473998d1d5c0
Author:     Fernando Apesteguía <[email protected]>
AuthorDate: 2024-02-12 07:48:00 +0000
Commit:     Fernando Apesteguía <[email protected]>
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`
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.