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-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-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
  ¯ '` ¯