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



Reply via email to