[Mono-bugs] [Bug 77012][Nor] New - Update .desktop File to Adhere to HIG

[bugzilla-daemon at bugzilla.ximian.com]

Please do not reply to this email- if you want to comment on the bug, go to the
URL shown below and enter your comments there.

Changed by gburt at uiuc.edu.

http://bugzilla.ximian.com/show_bug.cgi?id=77012

--- shadow/77012	2005-12-16 03:53:55.000000000 -0500
+++ shadow/77012.tmp.4935	2005-12-16 03:53:55.000000000 -0500
@@ -0,0 +1,61 @@
+Bug#: 77012
+Product: Mono: Doctools
+Version: 1.1
+OS: 
+OS Details: 
+Status: NEW   
+Resolution: 
+Severity: 
+Priority: Normal
+Component: Gui
+AssignedTo: mario.sopena at gmail.com                            
+ReportedBy: gburt at uiuc.edu               
+QAContact: mono-bugs at ximian.com
+TargetMilestone: ---
+URL: 
+Cc: 
+Summary: Update .desktop File to Adhere to HIG
+
+In monodoc's .desktop file, its Comment ("Monodoc Documentation Browser")
+does not adhere to the HIG, which suggests:
+
+* Phrase the tooltip as an imperative verb, for example "design", "write"
+or "check".
+* Describe the most important tasks users can accomplish with your application.
+* While tooltips should not be verbose, they should be longer and more
+descriptive than the item's name.
+
+Also, the _Comment is in heading case when it should be in sentence case.
+
+I would suggest changeing the Comment to "Browse library and language
+documentation related to Mono".
+
+With regards to the Name, I think monodoc is border-line between the first
+and second options described in the HIG, that it's name is functinally
+descriptive, and that it isn't and needs a functional description.  Errin
+on the side of redundancy, I think the Name should be "Monodoc
+Documentation Browser".
+
+I've pasted a patch making these changes and adding some other .desktop
+goodness.
+
+Thanks!
+
+--- monodoc.desktop.in.orig     2005-12-16 01:38:09.000000000 -0600
++++ monodoc.desktop.in  2005-12-16 01:44:46.000000000 -0600
+@@ -1,10 +1,12 @@
+ [Desktop Entry]
+-Name=Monodoc
++Version=1.0
++Encoding=UTF-8
++Name=Monodoc Documentation Browser
+ GenericName=Documentation Browser
+-Comment=Monodoc Documentation Browser
++Comment=Browse library and language documentation related to Mono
+ Exec=@bindir@/monodoc
+ Icon=monodoc.png
+-StartupNotify=false
++StartupNotify=true
+ Terminal=false
+ Type=Application
+ Categories=Application;Development;