Section list

Section list

[Jamie Lenehan]

On Fri, Aug 25, 2006 at 12:58:37PM +0200, "mickeyl commit" wrote:
> nfs-utils: s/networking/network/
[...]

Ah, good. I went through the sections used by all the recipes a while
back and generated a list and some suggested renames. I'll include it
here, along with the suggested renaming for some of the existing
sections.

I'll add this to the user manual once everyone is happy with it. I
also think it would be a good idea might to emit a warning if someone
tries to use a section name which is not definied in the list, so I
might code that up as well.

    * admin
    * applications		-> Really should find some other section?
    * apps			-> REPLACE with applications
    * base
    * base/shell
    * bootloader
    * console
    * console/editors
    * console/games
    * console/multimedia
    * console/net		-> REPLACE with console/network
    * console/network
    * console/networking	-> REPLACE with console/network
    * console/scientific
    * console/shells
    * console/telephony
    * console/tools
    * console/util		-> REPLACE with console/utils
    * console/utils
    * devel
    * devel/libs
    * devel/python
    * devel/rexx
    * devel/ruby
    * devel/tcltk
    * dev-lang			-> REPALCE with devel
    * doc
    * e/apps
    * e/libs
    * e/utils
    * games
    * games/arcade
    * gnome/libs
    * gnome/multimedia
    * gpe
    * gpe/applications
    * gpe/base
    * gpe/games
    * gpe/libs
    * gpe/multimedia
    * gui
    * interpreters
    * kde
    * kde/dev
    * kernel
    * kernel/module		-> REPALCE with kernel/modules
    * kernel/modules
    * kernel/userland
    * libs
    * libs/inputmethod		-> REPALCE with kernel/inputmethods
    * libs/inputmethods
    * libs/multimedia
    * libs/network
    * media-gfx			-> Find an existing category?
    * multimedia
    * net: Use network
    * net-misc			-> REPALCE with network/misc
    * net/misc			-> REPALCE with nerwork/misc
    * network
    * network/cms
    * network/misc
    * opie
    * opie/applets
    * opie/applications
    * opie/base
    * opie/codecs
    * opie/datebook
    * opie/decorations
    * opie/fontfactories
    * opie/fonts
    * opie/games
    * opie/help
    * opie/inputmethods
    * opie/libs
    * opie/multimedia
    * opie/network
    * opie/pim
    * opie/security
    * opie/settings
    * opie/shell
    * opie/Shell		-> REPLACE with opie/shell
    * opie/styles
    * opie/today
    * unknown			-> Should make it a known section...
    * utility			-> REPLACE with utils
    * utils
    * x11
    * x11/apps			-> Really should be x11/applications and probably should go somewhere else
    * x11/base
    * x11/data
    * x11/fonts
    * x11/games
    * x11/gnome
    * x11/gnome/libs
    * x11/graphics
    * x11/libs
    * x11-misc			-> Use x11/apps or other appropriate type?
    * x11/multimedia
    * x11/network
    * x11/office
    * x11/scientific
    * x11/utils
    * x11/wm 

-- 
 Jamie Lenehan <lenehan@twibble.org>

Re: Section list

[Marcin Juszkiewicz]

Dnia poniedziałek, 28 sierpnia 2006 01:39, Jamie Lenehan napisał:

> Ah, good. I went through the sections used by all the recipes a while
> back and generated a list and some suggested renames. I'll include it
> here, along with the suggested renaming for some of the existing
> sections.

> I'll add this to the user manual once everyone is happy with it. 

> I also think it would be a good idea might to emit a warning if someone
> tries to use a section name which is not definied in the list, so I
> might code that up as well.

Look at classes/sanity.bbclass


>     * applications		-> Really should find some other section?
>     * apps			-> REPLACE with applications

I would drop both rather as not describing anything.

>     * bootloader

bootloaders (as 'utils', 'editors', 'applications')

>     * console/shells

base/shell and console/shells? I would choose one.

>     * devel/libs

devel/perl

>     * devel/python
>     * devel/rexx
>     * devel/ruby

devel/scheme - we already has it (guile)

>     * devel/tcltk
[..]
>     * e/utils

fonts - TrueType fonts are currently in x11/fonts but can be used also by 
OPIE and other not X11 applications

>     * gui

another not describing anything section...

>     * kde/dev

kde/devel rather

>     * kernel
>     * kernel/module		-> REPALCE with kernel/modules
>     * kernel/modules

virtual/kernel modules -> kernel, out-of-tree modules -> kernel/modules 

What do you think?

>     * media-gfx			-> Find an existing category?
>     * multimedia

both need to be removed

>     * x11/gnome
>     * x11/gnome/libs

How does those two differ from other "gnome" ones? Can we move x11/gnome 
to x11/* and x11/gnome/libs -> x11/libs?

-- 
JID: hrw-jabber.org
Palmtop: Sharp Zaurus C760
OpenEmbedded/OpenZaurus developer

               Beware of Programmers who carry screwdrivers.
               		-- Leonard Brandwein

Re: Section list

[Jamie Lenehan]

Updated list, including your changes.

These sections are to be changed:

    * applications		-> Replace with appropriate section
    * apps			-> Replace with appropriate section
    * bootloader		-> Replace with bootloaders
    * console/shells		-> Replace with base/shell
    * console/net		-> Replace with console/network
    * console/networking	-> Replace with console/network
    * console/util		-> Replace with console/utils
    * dev-lang			-> Replace with devel
    * gnome/libs		-> Replace with x11/libs?
    * gnome/multimedia		-> Replace with x11/multimedia?
    * gui			-> Replace with appropriate section
    * kernel/module		-> Replace with kernel/modules
    * kde/dev			-> Replace with kde/devel
    * libs/inputmethod		-> Replace with libs/inputmethods
    * media-gfx			-> Replace with appropriate section
    * multimedia		-> Replace with appropriate section
    * net			-> Replace with network
    * net-misc			-> Replace with network/misc
    * net/misc			-> Replace with nerwork/misc
    * opie/Shell		-> Replace with opie/shell
    * unknown			-> Replace with appropriate section
    * utility			-> Replace with utils
    * x11-misc			-> Replace with appropriate section
    * x11/gnome			-> Replace with x11?
    * x11/gnome/libs		-> Replace with x11/libs?

That leaves us with these as the available sections:

    * admin
    * base
    * base/shell
    * bootloaders		-> NEW, replaces bootloader
    * console
    * console/editors
    * console/games
    * console/multimedia
    * console/network
    * console/scientific
    * console/telephony
    * console/tools
    * console/utils
    * devel
    * devel/libs
    * devel/perl		-> NEW
    * devel/python
    * devel/rexx
    * devel/ruby
    * devel/scheme		-> I missed this one before
    * devel/tcltk
    * doc
    * e/apps
    * e/libs
    * e/utils
    * fonts			-> NEW, for fonts that are not X11 or OPIE specific (truetype for exmaple)
    * games
    * games/arcade
    * gpe
    * gpe/applications
    * gpe/base
    * gpe/games
    * gpe/libs
    * gpe/multimedia
    * interpreters
    * kde
    * kde/devel			-> NEW, replaces kde/dev
    * kernel
    * kernel/modules
    * kernel/userland
    * libs
    * libs/inputmethods
    * libs/multimedia
    * libs/network
    * network
    * network/cms
    * network/misc
    * opie
    * opie/applets
    * opie/applications
    * opie/base
    * opie/codecs
    * opie/datebook
    * opie/decorations
    * opie/fontfactories
    * opie/fonts
    * opie/games
    * opie/help
    * opie/inputmethods
    * opie/libs
    * opie/multimedia
    * opie/network
    * opie/pim
    * opie/security
    * opie/settings
    * opie/shell
    * opie/styles
    * opie/today
    * utils
    * x11
    * x11/apps			-> Really should be x11/applications and probably should go somewhere else
    * x11/base
    * x11/data
    * x11/fonts
    * x11/games
    * x11/graphics
    * x11/libs
    * x11/multimedia
    * x11/network
    * x11/office
    * x11/scientific
    * x11/utils
    * x11/wm 

-- 
 Jamie Lenehan <lenehan@twibble.org>

Re: Section list

[Koen Kooi]

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

Jamie Lenehan schreef:
> Updated list, including your changes:

<list>

Don't forget to mention that you added it do the usermanual:
http://www.openembedded.org/user-manual&dpage=ch07s09 :)

regards,

Koen

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.1 (Darwin)

iD8DBQFFAo1dMkyGM64RGpERAqcPAJ9E4dF994yzoFUgPZgwRn83UdQ6bQCglUNS
H+V3Wn+HGUUKOu3KUx0iCII=
=q3i+
-----END PGP SIGNATURE-----

Re: Section list

[Paul Sokolovsky]

Hello Koen,

Saturday, September 9, 2006, 12:46:05 PM, you wrote:

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

> Jamie Lenehan schreef:
>> Updated list, including your changes:

> <list>

> Don't forget to mention that you added it do the usermanual:
> http://www.openembedded.org/user-manual&dpage=ch07s09 :)


  ... And I just wanted to write that it would be nice to add the
proposed list to http://www.openembedded.org/wiki/Policies . Maybe
it's better to let it stay for some time as RFC before adding to
the documentation? Organizing a good taxonomy is not an easy task,
would need some testing on existing package base, and even after that,
it's probably good idea to be prepared to refactors of it.

  Last week, I myself went thru few recipes to add/tweak SECTIONs for
them, and there already were few questions.

  One good example, is that ignorant user part of me is a bit
concerned with x11 section being so broard, with an SDL game, ye olde
MOTIF app and contemporary GNOME/GTK+ app would go into it. That
loses a bit deal of descreptivism. I know, that such taxonomy is
(wonder if there will be chance to say "was") pretty common, and I'm
afraid I don't have elegant proposal for split up. But my ignorant
user part, not concerned with formal correctness, but rather
with pragmatic convenience, says, that there might be possible to have
a "gnome" section (warning: do not mix with GNOME/Gnome ;-) ) for apps
written using contemporary GUI toolkit, like (and mostly) GTK+.

  So, is there any rational idea in that or should my ignorant user
part just shut up?


  Either way, as mood permits, I'm going to continue monkey's job of
applying SECTIONs, based on the list proposed. Just in case, I in
advance apoligize if my selections won't be every time 100% perfect -
as I told, we just should accept this as an iterative process. The
initial aim would be to offload default "base" section off stuff which
easily can be put elsewhere.

> regards,

> Koen


-- 
Best regards,
 Paul                            mailto:pmiscml@gmail.com

Re: Section list

[Jamie Lenehan]

On Sat, Sep 09, 2006 at 03:20:31PM +0300, Paul Sokolovsky wrote:
[...]
> it's better to let it stay for some time as RFC before adding to
> the documentation? Organizing a good taxonomy is not an easy task,
> would need some testing on existing package base, and even after that,
> it's probably good idea to be prepared to refactors of it.

I've changed in the documentation just now to note that it's a
recomendation only and that new additions/changes should be be
discussed cia OE mailing list.

The list was actually done by myself when trying to decide what
sections to put stuff in. I generated the list from the existing OE
packages and then noticed various things such as the use of "net" and
"networking" and the like. So the list is really just what was there
with some of these things removed, plus a few other changes from
other peoples comments.

So I think it's useful to have a documented list... the document can
always be changed!

[...]
>   Last week, I myself went thru few recipes to add/tweak SECTIONs for
> them, and there already were few questions.

Only two ;) I went round and round on dozens of them before sending
out my original list!

>   One good example, is that ignorant user part of me is a bit
> concerned with x11 section being so broard, with an SDL game, ye olde
> MOTIF app and contemporary GNOME/GTK+ app would go into it. That
> loses a bit deal of descreptivism. I know, that such taxonomy is
> (wonder if there will be chance to say "was") pretty common, and I'm
> afraid I don't have elegant proposal for split up. But my ignorant
> user part, not concerned with formal correctness, but rather
> with pragmatic convenience, says, that there might be possible to have
> a "gnome" section (warning: do not mix with GNOME/Gnome ;-) ) for apps
> written using contemporary GUI toolkit, like (and mostly) GTK+.
> 
>   So, is there any rational idea in that or should my ignorant user
> part just shut up?

That's definitely a question I had as well. Do you care if an
application is a gnome app, or a kde app or a motif app? Or do you
just want an "X app" that does what you want? I checked a few distros
and then didn't appear to distinguish between gnome/kde/motif etc. On
the other hand maybe we do care in OE since installing a gnome app
may pull in a huge number of gnome libraries?

[...]
>   Either way, as mood permits, I'm going to continue monkey's job of
> applying SECTIONs, based on the list proposed. Just in case, I in
> advance apoligize if my selections won't be every time 100% perfect -
> as I told, we just should accept this as an iterative process. The
> initial aim would be to offload default "base" section off stuff which
> easily can be put elsewhere.

That sound fine. I don't think you can make things worse by fixing up
the current section lists ;) And if you think other things you want
changed in the list please do send an email - preferably with a
propsed change (since finding a good solution is usually the most
difficult part!)

Thanks.

-- 
 Jamie Lenehan <lenehan@twibble.org>

Re: Section list

[Jamie Lenehan]

This time I'll send this to the list...

On Mon, Aug 28, 2006 at 11:47:00AM +0200, Marcin Juszkiewicz wrote:
> Dnia poniedziałek, 28 sierpnia 2006 01:39, Jamie Lenehan napisał:
[...]
> >     * console/shells
> 
> base/shell and console/shells? I would choose one.

base/shell is the most common, only fush uses console/shells, so make
this one base/shell.

[...]
> >     * kernel
> >     * kernel/module		-> REPALCE with kernel/modules
> >     * kernel/modules
> 
> virtual/kernel modules -> kernel, out-of-tree modules -> kernel/modules 
> 
> What do you think?

I don't think that makes much sense. I would go to section "kernel"
to find a new kernel and to "kernel/modules" to find modules for the
kernel. I don't think it matters to the end user where those modules
were from.

[...]
> >     * x11/gnome
> >     * x11/gnome/libs
> 
> How does those two differ from other "gnome" ones? Can we move x11/gnome 
> to x11/* and x11/gnome/libs -> x11/libs?

Hmm, yeah there are a few gnomes:

    * gnome/libs
    * gnome/multimedia
    * x11/gnome
    * x11/gnome/libs

The gnome core puts itself in x11/gnome/* while apps/libraries from other
people seem to put themselves in gnome/*. So you think this is the best way
to handle this?:

    * gnome/libs		-> x11/libs
    * gnome/multimedia		-> x11/multimedia
    * x11/gnome			-> x11
    * x11/gnome/libs		-> x11/libs

-- 
 Jamie Lenehan <lenehan@twibble.org>