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: Ciaran McCreesh <ciaran.mccreesh@...>
From: Christian Faulhammer <fauli@g.o>
Subject: Re: EAPI cheat sheet (for review)
Date: Sat, 4 Apr 2009 21:33:39 +0200
Hi,

Ciaran McCreesh <ciaran.mccreesh@...>:

> On Sat, 4 Apr 2009 02:12:06 +0200
> Christian Faulhammer <fauli@g.o> wrote:
> >  I will test it on my tree...you will get newer patches next week
> > probably.
> 
> Sounds good.

 Patch attached.  This version only references the tables, which is
kind of useless, but is what I took from appendix E.  Changing the
labels as stated below will be the proper solution.
 By the way I have a patch ready that factors out the preamble to a
pms.cls file, making the source easier to read.  It builds on top of my
cheat sheet patch, so not ready yet.

> 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.

> 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.

V-Li

-- 
Christian Faulhammer, Gentoo Lisp project
<URL:http://www.gentoo.org/proj/en/lisp/>, #gentoo-lisp on FreeNode

<URL:http://gentoo.faulhammer.org/>
Attachment:
0001-Desk-reference-for-quick-look-up.patch (Text Data)
Attachment:
signature.asc (PGP signature)
Replies:
Re: EAPI cheat sheet (for review)
-- Ciaran McCreesh
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
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.