- Document DESKTOP_ENTRIES

svn path=/head/; revision=27921

en_US.ISO8859-1/books/porters-handbook/book.sgml

@@ -4915,6 +4915,35 @@ BUILD_DEPENDS+= Xvfb:${X_VFBSERVER_PORT} \
 
       </sect2>
 
+      <sect2 id="desktop-entries">
+	<title>Desktop entries</title>
+
+	<para>Desktop Entries (<ulink
+	  url="http://standards.freedesktop.org/desktop-entry-spec/latest/">Freedesktop
+	  standard</ulink>) can be easily created in your port using
+	  <makevar>DESKTOP_ENTRIES</makevar> variable.  These entries do
+	  show up in application menus of compliant desktop environments
+	  like GNOME or KDE.  The <filename>.desktop</filename> file will
+	  be created, installed, and added to the
+	  <filename>pkg-plist</filename> automatically.  Syntax is:</para>
+
+	<programlisting>DESKTOP_ENTRIES=  "NAME" "COMMENT" "ICON" "COMMAND" "CATEGORY" StartupNotify</programlisting>
+
+	<para>List of possible categories is available <ulink
+	  url="http://standards.freedesktop.org/menu-spec/latest/apa.html">on
+	  Freedesktop website</ulink>.  The <makevar>StartupNotify</makevar>
+	  indicates, if the application will clear the status in startup
+	  notification aware environment.</para>
+
+	<para>Example:</para>
+
+	<programlisting>DESKTOP_ENTRIES=  "ToME" "Roguelike game based on JRR Tolkien's work" \
+                  "${DATADIR}/xtra/graf/tome-128.png" \
+                  "tome -v -g" "Application;Game;RolePlaying" \
+                  false</programlisting>
+
+      </sect2>
+
     </sect1>
 
     <sect1 id="using-gnome">