Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-pms
Navigation:
Lists: gentoo-pms: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: Christian Faulhammer <fauli@g.o>
From: Ciaran McCreesh <ciaran.mccreesh@...>
Subject: Re: EAPI cheat sheet (for review)
Date: Sat, 4 Apr 2009 20:52:29 +0100
On Sat, 4 Apr 2009 21:33:39 +0200
Christian Faulhammer <fauli@g.o> wrote:
> > So what I'd like to be able to do is have it say "see section
> > [funcs.src_unpack.3]" rather than "see section 1.2.3.4", and then
> > when we have a labelled section, lay it out something like:
> 
>  What is possible is to reference the heading of the section and even
> the name from \label.  Displaying the label names in the margin should
> be feasible, too, as far as I remember.

That would be helpful.

> > I realise this is somewhat getting away from your original patch.
> > But I strongly suspect that the cheat sheet will be a lot more
> > useful if it has references to exactly what the new src_unpack is,
> > for when people need to look it up -- and it would help if people
> > didn't have to print out a new cheatsheet to get valid section
> > references every time we tweak the wording in such a way that the
> > section numbers change...
> 
>  Correct, but a task I can't handle in the near future, I can give
> some advise though and someone labelling all appropriate paragraphs
> would do the biggest part.  They should have a naming scheme like:
>  eapi4:<function>:<name> where function is something like
> install|phase|etc.

Yeah, that'd work.

I'm wondering what our best merge strategy is here. I'm inclined to
think we're best off fixing all the labels on the eapi-3 branch (even
if we can't get them displayed or used for named references just yet),
rebasing that onto master (not much has diverged) once we have the
go-ahead from the Council either next meeting or the one after
(probably...) and then doing the cheat-sheet with EAPI 3 included on top
of that.

Or were you particularly desperate to get the cheat-sheet in for EAPI 2?

-- 
Ciaran McCreesh
Attachment:
signature.asc (PGP signature)
Replies:
Re: EAPI cheat sheet (for review)
-- Christian Faulhammer
References:
EAPI cheat sheet (for review)
-- Christian Faulhammer
Re: EAPI cheat sheet (for review)
-- Ciaran McCreesh
Re: EAPI cheat sheet (for review)
-- Christian Faulhammer
Re: EAPI cheat sheet (for review)
-- Ciaran McCreesh
Re: EAPI cheat sheet (for review)
-- Christian Faulhammer
Navigation:
Lists: gentoo-pms: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: EAPI cheat sheet (for review)
Next by thread:
Re: EAPI cheat sheet (for review)
Previous by date:
Re: EAPI cheat sheet (for review)
Next by date:
Re: EAPI cheat sheet (for review)


Updated Jul 18, 2012

Summary: Archive of the gentoo-pms mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.