Bug#362962: Please document that nm-applet needs the notification area applet to appear on the panel

2006-06-19 Thread Michael Biebl 
Richard Atterer wrote:
 reopen 362962
 retitle 362962 Please document that nm-applet needs the notification area 
 applet to appear on the panel [was: Networkmanager is not present in the 
 gnome-panel applets listing]
 thanks
 
 Hello,
 
 it took 15 minutes of head-scratching, running nm-applet manually, reading 
 manpages etc. before I figured out that you have to add the notification 
 area applet to the panel to see the NetworkManager icon.
 
 Please make this clearer in the documentation! It'd be great if you could 
 add it in several places:
 
  - Put it in the package description. For example:
  Note: The Notification Area applet must be running for 
  the NetworkManager icon to appear on your panel.
  - Put it in the nm-applet manpage more clearly - state that you have to 
add the notification area applet to the panel. The manpage talks about 
a notify-area, but I had no idea so far what that area is, and whether 
it was already existent on my desktop.
  - Put it in the README.Debian for both network-manager{-gnome,}
The manpage points the user to 
/usr/share/doc/network-manager/README.Debian for the information on how 
to add nm-applet in your gnome notify-area, but that file doesn't 
discuss installing the applet at all.
 

First of all, the notification area applet is added to the gnome panel
by default. So this shouldn't be a problem at all.
For people that remove the notification area applet from the
gnome-panel, I assume they know what they are doing.
Second, the description of network-manager-gnome says, that it is a
notification area applet.
Third, network-manager-gnome is not Gnome specific, it runs in every DE
which support the systray fd.o standard [1], e.g. XFCE, KDE or also
openbox' docker area. So I think adding Gnome specific documentation
might be a bit misleading.
Fourth, the man page is indeed not consistent when talking about
notify-area. It should be called notification area to be consistent.
This is the only change I'd consider.
Fifth, there are many other programs, that use a systray icon. Should
they all contain documentation about how to enable the systray dock of
their desktop environment of choice. I don't think so.

I'm intended to close this bug, but first want to hear your comment.

Cheers,
Michael

[1]http://standards.freedesktop.org/systemtray-spec/systemtray-spec-0.2.html

-- 
Why is it that all of the instruments seeking intelligent life in the
universe are pointed away from Earth?



signature.asc
Description: OpenPGP digital signature

Bug#362962: Please document that nm-applet needs the notification area applet to appear on the panel

2006-06-19 Thread Richard Atterer 
On Mon, Jun 19, 2006 at 06:23:14PM +0200, Michael Biebl wrote:
 First of all, the notification area applet is added to the gnome panel
 by default. So this shouldn't be a problem at all.
 For people that remove the notification area applet from the
 gnome-panel, I assume they know what they are doing.

I have been upgrading from older Gnome versions for many years, always 
taking my old panel with me. This way, I somehow seem to have missed the 
notification area so far.

 Second, the description of network-manager-gnome says, that it is a
 notification area applet.

Hm, it says notification applet, which to my uneducated mind ;) sounded 
just like an applet which notifies you of events - and when I hear applet 
in conjunction with Gnome, I think of regular Gnome panel applets.

Maybe you could change it into applet for the notification area of your 
desktop environment? That would have given me enough of a clue.

 Fifth, there are many other programs, that use a systray icon. Should 
 they all contain documentation about how to enable the systray dock of 
 their desktop environment of choice. I don't think so.

No, they shouldn't, you're right. But maybe it should be made clearer that 
this applet package with a *-gnome name is not a panel applet.

 I'm intended to close this bug, but first want to hear your comment.

Fair enough, it's your choice. Thanks for your work!

  Richard

-- 
  __   _
  |_) /|  Richard Atterer
  | \/¯|  http://atterer.net
  ¯ '` ¯

Bug#362962: Please document that nm-applet needs the notification area applet to appear on the panel

2006-06-18 Thread Richard Atterer 
reopen 362962
retitle 362962 Please document that nm-applet needs the notification area 
applet to appear on the panel [was: Networkmanager is not present in the 
gnome-panel applets listing]
thanks

Hello,

it took 15 minutes of head-scratching, running nm-applet manually, reading 
manpages etc. before I figured out that you have to add the notification 
area applet to the panel to see the NetworkManager icon.

Please make this clearer in the documentation! It'd be great if you could 
add it in several places:

 - Put it in the package description. For example:
 Note: The Notification Area applet must be running for 
 the NetworkManager icon to appear on your panel.
 - Put it in the nm-applet manpage more clearly - state that you have to 
   add the notification area applet to the panel. The manpage talks about 
   a notify-area, but I had no idea so far what that area is, and whether 
   it was already existent on my desktop.
 - Put it in the README.Debian for both network-manager{-gnome,}
   The manpage points the user to 
   /usr/share/doc/network-manager/README.Debian for the information on how 
   to add nm-applet in your gnome notify-area, but that file doesn't 
   discuss installing the applet at all.

Thanks for the great work!
Cheers,

  Richard

-- 
  __   _
  |_) /|  Richard Atterer
  | \/¯|  http://atterer.net
  ¯ '` ¯