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-dev
Navigation:
Lists: gentoo-dev: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-dev@g.o
From: Thomas Sachau <tommy@g.o>
Subject: Re: Re: spec draft for cross-compile support in future EAPI (EAPI-5)
Date: Tue, 19 Jun 2012 20:16:39 +0200
Thomas Sachau schrieb:
> Duncan schrieb:
>> Thomas Sachau posted on Sat, 16 Jun 2012 12:31:40 +0200 as excerpted:
>>
>>> Since i am not that sure about my ability to write formal specs, i am
>>> presenting my first draft for further review and suggestions for
>>> improvement.
>>
>> Just a format suggestion.  Call it nitpicky if you want, and yes, my 
>> client isn't perfect, but I'm sure people with a bit of experience 
>> writing such specs will tell you I'm not alone...
>>
>> Several of your points ended up as very long single lines.  My client can 
>> wrap, but that wraps the points as well (so for example 2.1 starts in the 
>> middle of a line).  So I was left with the choice to either massively 
>> horizontally scroll, or of trying to figure out where one point ended and 
>> another began, since wrapping it... /wrapped/ it, so points appeared in 
>> the middle of a line.
>>
>> Please:
>>
>> * If you use long lines, leave a vertical space (blank line) between 
>> points so when a client wraps them, they wrap as individual paragraphs.
>>
>> * Alternatively, wrap at something sensible. (The traditional wrap for 
>> posting is 72 chars or so, 80 minus a few to allow a few levels of 
>> quoting without rewrap.  I wouldn't complain at 90, but if you're going 
>> to bother, you might as well go the standard route and avoid further 
>> issues.)
>>
>> Long lines as paragraphs would probably be easier especially early in the 
>> process when you're modifying a lot, but you still risk (even more) 
>> limited clients having issues with it.  YMMV.
>>
> 
> I suggest you look for a better client to handle the line wrapping
> better. ;-) In the meantime, the same file attached with wrapped lines.
> 

Since there is again no response at all, it seems like everyone is ok
with this, so i will propose to add this to the next council agenda for
EAPI-5 addition.

-- 

Thomas Sachau
Gentoo Linux Developer



Attachment:
signature.asc (OpenPGP digital signature)
Replies:
Re: Re: spec draft for cross-compile support in future EAPI (EAPI-5)
-- Ciaran McCreesh
References:
spec draft for cross-compile support in future EAPI (EAPI-5)
-- Thomas Sachau
Re: spec draft for cross-compile support in future EAPI (EAPI-5)
-- Duncan
Re: Re: spec draft for cross-compile support in future EAPI (EAPI-5)
-- Thomas Sachau
Navigation:
Lists: gentoo-dev: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: spec draft for cross-compile support in future EAPI (EAPI-5)
Next by thread:
Re: Re: spec draft for cross-compile support in future EAPI (EAPI-5)
Previous by date:
Re: spec draft for cross-compile support in future EAPI (EAPI-5)
Next by date:
Re: Re: spec draft for cross-compile support in future EAPI (EAPI-5)


Updated Jun 29, 2012

Summary: Archive of the gentoo-dev mailing list.

Donate to support our development efforts.

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