[gentoo-pms] Too many EAPIs for feature table

[gentoo-pms] Too many EAPIs for feature table

[Ulrich Mueller]

[-- Attachment #1: Type: text/plain, Size: 825 bytes --]

Hi all,
Appendix D contains a big table of EAPI features. This was already
turned sideways when adding EAPI 3, but with EAPI 6 it will be too
wide for the page, even in landscape mode.

We could:
- Use a smaller font size. This would be a temporary fix for EAPI 6,
  but for the next EAPIs we would run into the problem again.
- Split the table into two smaller tables (e.g., for EAPI 0 to 5 and
  for EAPI 6).
- Omit the oldest EAPIs (e.g., 0 and 1) from the table, and add a
  reference to a previous version of the document.

I'd prefer the last solution. Appendix D is only informative, and we
still have Appendix E which will list the differences to older EAPIs.

Any other opinions?

BTW, with the cheat sheet we'll run into the same problem. There we
have no other choice but omitting some of the information.

Ulrich

[-- Attachment #2: Type: application/pgp-signature, Size: 490 bytes --]

Re: [gentoo-pms] Too many EAPIs for feature table

[Ciaran McCreesh]

[-- Attachment #1: Type: text/plain, Size: 286 bytes --]

On Sat, 21 Jun 2014 10:11:26 +0200
Ulrich Mueller <ulm@gentoo.org> wrote:
> - Omit the oldest EAPIs (e.g., 0 and 1) from the table, and add a
>   reference to a previous version of the document.

Variation: consolidate EAPIs < 3 (say) into a single entry.

-- 
Ciaran McCreesh

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [gentoo-pms] Too many EAPIs for feature table

[Michael Orlitzky]

On 06/21/2014 04:11 AM, Ulrich Mueller wrote:
> Hi all,
> Appendix D contains a big table of EAPI features. This was already
> turned sideways when adding EAPI 3, but with EAPI 6 it will be too
> wide for the page, even in landscape mode.
> 
> We could:
> - Use a smaller font size. This would be a temporary fix for EAPI 6,
>   but for the next EAPIs we would run into the problem again.
> - Split the table into two smaller tables (e.g., for EAPI 0 to 5 and
>   for EAPI 6).
> - Omit the oldest EAPIs (e.g., 0 and 1) from the table, and add a
>   reference to a previous version of the document.
> 
> I'd prefer the last solution. Appendix D is only informative, and we
> still have Appendix E which will list the differences to older EAPIs.
> 
> Any other opinions?
> 
> BTW, with the cheat sheet we'll run into the same problem. There we
> have no other choice but omitting some of the information.

We want to be able to compare EAPIs at a glance, so they all need to be
side-by-side or atop one another. Two unrelated features, on the other
hand, can safely appear pages apart.

So my suggestion is to switch "Feature" and "EAPIs"; then, when you run
out of horizontal space (too many features), repeat the headers. The
features/references are in one-to-one correspondence so they don't need
to appear as a row/column in the table:


                  Feature (Reference)
 EAPI | feature1 (ref1) | feature2 (ref2) | feature3 (ref3)
-----------------------------------------------------------
   0  |       yes       |        no       |    whatever
   1  |
   2  |
   3  |
   4  |              ...
   5  |
   6  |
-----------------------------------------------------------
                  Feature (Reference)
 EAPI | feature4 (ref4) | feature5 (ref5) | feature6 (ref6)
-----------------------------------------------------------
   0  |       yes       |        no       |    whatever
   1  |
   2  |
   3  |
   4  |              ...
   5  |
   6  |

Re: [gentoo-pms] Too many EAPIs for feature table

[Ulrich Mueller]

[-- Attachment #1: Type: text/plain, Size: 545 bytes --]

>>>>> On Sat, 21 Jun 2014, Ciaran McCreesh wrote:

>> - Omit the oldest EAPIs (e.g., 0 and 1) from the table, and add a
>>   reference to a previous version of the document.

> Variation: consolidate EAPIs < 3 (say) into a single entry.

Heh, do I see a numerical relation for EAPI there? :)

What exactly to you mean by "consolidate"? List the values for EAPIs
0, 1, and 2 in one table cell, in case they are different? On first
glance, it would be a bit unwieldy for some of the features with long
entries (e.g., default-phase-funcs).

Ulrich

[-- Attachment #2: Type: application/pgp-signature, Size: 490 bytes --]

Re: [gentoo-pms] Too many EAPIs for feature table

[Ciaran McCreesh]

[-- Attachment #1: Type: text/plain, Size: 828 bytes --]

On Sat, 21 Jun 2014 22:05:29 +0200
Ulrich Mueller <ulm@gentoo.org> wrote:
> >>>>> On Sat, 21 Jun 2014, Ciaran McCreesh wrote:
> >> - Omit the oldest EAPIs (e.g., 0 and 1) from the table, and add a
> >>   reference to a previous version of the document.
> 
> > Variation: consolidate EAPIs < 3 (say) into a single entry.
> 
> Heh, do I see a numerical relation for EAPI there? :)

Temporal!

> What exactly to you mean by "consolidate"? List the values for EAPIs
> 0, 1, and 2 in one table cell, in case they are different? On first
> glance, it would be a bit unwieldy for some of the features with long
> entries (e.g., default-phase-funcs).

Just to indicate that "something changed between these EAPIs, and if
you're not a package mangler author, you should just use a later EAPI".

-- 
Ciaran McCreesh

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [gentoo-pms] Too many EAPIs for feature table

[Ulrich Mueller]

[-- Attachment #1: Type: text/plain, Size: 597 bytes --]

>>>>> On Sun, 22 Jun 2014, Ciaran McCreesh wrote:

> Just to indicate that "something changed between these EAPIs, and if
> you're not a package mangler author, you should just use a later EAPI".

I've started a branch for eapi-6 (nothing interesting there, so far):
http://git.overlays.gentoo.org/gitweb/?p=proj/pms.git;a=shortlog;h=refs/heads/eapi-6

As with previous EAPIs, expect the branch to be rebased, so please
don't refer to commits from elsewhere (like from bugzilla).
Once EAPI 6 is in shape, we will cherry pick individual commits to
master, and throw the eapi-6 branch away.

Ulrich

[-- Attachment #2: Type: application/pgp-signature, Size: 490 bytes --]

Re: [gentoo-pms] Too many EAPIs for feature table

[Ulrich Mueller]

[-- Attachment #1: Type: text/plain, Size: 547 bytes --]

>>>>> On Sat, 21 Jun 2014, Michael Orlitzky wrote:

> We want to be able to compare EAPIs at a glance, so they all need to
> be side-by-side or atop one another. Two unrelated features, on the
> other hand, can safely appear pages apart.

> So my suggestion is to switch "Feature" and "EAPIs"; then, when you
> run out of horizontal space (too many features), repeat the headers.

In fact, we have all these small tables with row-wise EAPI in the main
text already. So I'd rather keep one big table with transposed layout
in the appendix.

Ulrich

[-- Attachment #2: Type: application/pgp-signature, Size: 490 bytes --]