This is a proposal for changing the structure of
spec-files to be more logical and easier to grok.
Comments please.
Laca
--8<--
For historic reasons, spec-files is currently organised as follows:
spec-files/*.spec
base (formerly: linux) spec files
the were used to build the JDS/Linux product
spec-files/patches
most patches
spec-files/manpages
JDS/Linux manual pages (no longer used)
spec-files/ext-sources
all sorts of foo
spec-files/po-sun
l10n content for JDS specific strings
spec-files/LICENSE
various licenses used in JDS
spec-files/docs
build related docs and templates
spec-files/prototypes
package prototype files from the official builds, for reference
spec-files/scripts
various scripts
spec-files/Solaris
Solaris spec files + spec files includes (*.inc)
spec-files/Solaris/extra-specs
(mostly SuSE) spec files that were not included in the JDS/Linux
builds but %use'd by the Solaris spec files
spec-files/Solaris/patches
In theory: patches for Solaris-only spec files.
In practice: a big confusion
spec-files/Solaris/manpages
Manual pages for the Solaris packages
The biggest problem is that the Solaris spec files are hidden in Solaris/.
This is not really intuitive, newcomers usually try to build
spec-files/*.spec first and don't understand why it fails or what
aaa_base is that it's looking for. There's also a lot of confusion
caused by the 2 patches directories and extra-specs. Having the
manpages under spec-files/Solaris and the l10n stuff under spec-files,
although logical, doesn't make it easier to absorb this stuff.
I propose the following new structure:
spec-files/SUNW*.spec
Solaris spec files. The Solaris subdir is deleted.
spec-files/<subdir>/*.spec
Base (nee Linux) spec files. I need a good suggestion for
<subdir>, something like base-specs or linux-specs or used-specs.
Any preferences?
Solaris/extra-specs/*.spec is also moved into this dir.
spec-files/closed/SUNW*.spec
Spec files for closed source packages will be cast out here.
spec-files/patches/*.diff
All patches. (i.e. spec-files/Solaris/patches/* also moved here)
spec-files/include/*
Solaris.inc, default-depend.inc and in general, stuff %included
in the Solaris spec files
spec-files/manpages/**
Solaris man pages, moved here from Solaris/manpages.
The Linux man pages (currently spec-files/manpages) can be
deleted. They are out of date and we still have them in svn
history should we ever need them again.
spec-files/ext-sources/*
no change
spec-files/po-sun/**
no change
spec-files/LICENSE
no change
spec-files/docs
no change
spec-files/prototypes
no change
spec-files/scripts
no change