public inbox for gentoo-dev@lists.gentoo.org
 help / color / mirror / Atom feed
* [gentoo-dev] Horrible package descriptions
@ 2003-05-22 18:12 Vadim
  2003-05-22 18:23 ` oford
                   ` (2 more replies)
  0 siblings, 3 replies; 21+ messages in thread
From: Vadim @ 2003-05-22 18:12 UTC (permalink / raw
  To: Gentoo-Dev mailinglist

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

I think that Gentoo needs some better way of describing packages. For example, 
on Debian there is a short and a long description, which will almost always 
explain what's the package for.

Gentoo seems to have gems like this, though:
*  net-print/apsfilter
      Latest version available: 7.2.2
      Latest version installed: 7.2.2
      Size of downloaded files: 281 kB
      Homepage:    http://www.apsfilter.org
      Description: Apsfilter Prints So Fine, It Leads To Extraordinary Results

And this one is not as bad but still not good:
*  net-fs/samba
      Latest version available: 2.2.8a
      Latest version installed: 2.2.8a
      Size of downloaded files: 4,466 kB
      Homepage:    http://www.samba.org
      Description: SAMBA is a suite of SMB and CIFS client/server programs for 
UNIX


Okay, I realize that Gentoo isn't indended for newbies, but it's hard not to 
complain about that. I've been using computers for about 10 years, and Linux 
for maybe 3. And I have problems with both packages.

I simply don't know what the heck does apsfilter do. Yeah, it prints, but 
what? Does it use CUPS or it's generic? If I install it, will I get more 
features in the KDE printing dialog, or it's invoked manually? If it "prints" 
maybe it's a printer driver? I have no idea. Note that even though the text 
above says I installed it, I did it just in case, and planning to figure out 
if it was useful or not later.

About the same can be said for SAMBA. I know what it is, but I doubt I could 
find it if I was searching for it without knowing what it's called. Where are 
the references to the network (other than net-fs), Windows and file sharing? 
I'm pretty sure that there are quite a few Windows admins that have no idea 
of that the protocol is called SMB.


My suggestion is to make a policy that says that package descriptions have to 
be actually descriptive. The apsfilter description may be "cute", but it's 
completely unhelpful at describing its purpose, or even allowing it to be 
found easily with 'emerge -S'.

I think it would also be a good idea to add longer descriptions, like those 
that .deb and .rpm packages have.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2 (GNU/Linux)

iD8DBQE+zRLzvCkUtBccqkoRAu3pAJ40+E/5n4+IsZSsB1xiriC8N7YV2wCgnbgX
1+LI4i3ujwHVeMCDJNHel1E=
=F7tk
-----END PGP SIGNATURE-----


--
gentoo-dev@gentoo.org mailing list


^ permalink raw reply	[flat|nested] 21+ messages in thread
* Re: [gentoo-dev] Horrible package descriptions
@ 2003-05-22 22:06 Vadim
  2003-05-22 23:20 ` Ernst Herzberg
  0 siblings, 1 reply; 21+ messages in thread
From: Vadim @ 2003-05-22 22:06 UTC (permalink / raw
  To: gentoo-dev

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Thursday 22 May 2003 20:34, Sven Vermeulen wrote:
> This is why you also get the URL, so you can find out for yourself. I'm not
> in favor of adding a "long" description as other package formats do,
> although I won't object -- this is just my personal opinion.

Sure, that sometimes works. But not always. I can think of multiple problems
with that. For example:

That assumes that the web site says something useful about it. It might be a
site from somebody who just put his/her stuff on the web in case somebody
find it useful, with no documentation at all. Or it might happen to be some
obscure tiny tool made by a large company that's got a huge site where you
have to search for 15 minutes until your find something.

Sometimes, you have network problems too. The site might be down. Or have
moved somewhere else. Or perhaps you have a local Gentoo mirror and no
internet connection due to problems/paranoid security.

Then, there is a problem with searching. I'd like to be able to find SAMBA
without knowing how it, or the protocol is called. Most people might try to
search for "windows network", for example. The URL is not very helpful when
you know what kind of tool you want, but not the exact tool.

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2 (GNU/Linux)

iD8DBQE+zUnJvCkUtBccqkoRAlbqAJwPpC1UXhL2AgUa1E+KFoznmJJ8pgCeMkXI
DDkKJdRKGbLpgCOAsy51LKE=
=0Of6
-----END PGP SIGNATURE-----


--
gentoo-dev@gentoo.org mailing list


^ permalink raw reply	[flat|nested] 21+ messages in thread

end of thread, other threads:[~2003-05-23 10:23 UTC | newest]

Thread overview: 21+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2003-05-22 18:12 [gentoo-dev] Horrible package descriptions Vadim
2003-05-22 18:23 ` oford
2003-05-22 18:31 ` Dhruba Bandopadhyay
2003-05-22 19:01   ` John Robinson
2003-05-22 19:07     ` Seemant Kulleen
2003-05-22 20:28   ` Spundun Bhatt
2003-05-22 18:34 ` Sven Vermeulen
2003-05-22 18:56   ` Dylan Carlson
2003-05-22 19:02     ` Paul de Vrieze
2003-05-22 19:11       ` Dylan Carlson
2003-05-22 19:17         ` Paul de Vrieze
2003-05-23  2:04       ` Frantz Dhin
2003-05-23 19:40       ` leon j. breedt
2003-05-22 20:59         ` Matt Tucker
2003-05-23 10:23           ` Sven Vermeulen
2003-05-22 19:17   ` Matthew Kennedy
2003-05-22 19:19   ` Matthew Kennedy
2003-05-22 19:34     ` Paul de Vrieze
  -- strict thread matches above, loose matches on Subject: below --
2003-05-22 22:06 Vadim
2003-05-22 23:20 ` Ernst Herzberg
2003-05-23  2:55   ` John Nilsson

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox