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

bugzilla-daemon at bugzilla.ximian.com bugzilla-daemon at bugzilla.ximian.com
Fri Dec 16 03:53:55 EST 2005

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.


--- 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 Details: 
+Status: NEW   
+Priority: Normal
+Component: Gui
+AssignedTo: mario.sopena at gmail.com                            
+ReportedBy: gburt at uiuc.edu               
+QAContact: mono-bugs at ximian.com
+TargetMilestone: ---
+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
+--- 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 Documentation Browser
+ GenericName=Documentation Browser
+-Comment=Monodoc Documentation Browser
++Comment=Browse library and language documentation related to Mono
+ Exec=@bindir@/monodoc
+ Icon=monodoc.png
+ Terminal=false
+ Type=Application
+ Categories=Application;Development;

More information about the mono-bugs mailing list