[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: how offsets and alignment works: an explanation
From: |
Trevor Daniels |
Subject: |
Re: how offsets and alignment works: an explanation |
Date: |
Mon, 25 Mar 2013 08:45:50 -0000 |
Janek Warchoł wrote Sunday, March 24, 2013 10:56 PM
> On Sat, Mar 23, 2013 at 7:13 PM, Trevor Daniels <address@hidden> wrote:
>> The Notation Reference is a _reference_ document. It is intended to
>> remind users of information which they already understand. Explanations
>> belong either in the Learning Manual, the Extensions Manual or the
>> Contributor's Guide.
>
> I think that each manual needs some info about offsets and alignment:
> - Learning should give all users an idea of what's going on,
Maybe this material is a little too advanced for the users expected to
read the LM, unless a new chapter entitled "Advanced concepts" or
some such were added.
> - Notation should list all "knobs and switches"
No. The Internals manual is the place for this as it is automatically
updated from the code. Trying to replicate this manually is going to
lead to the information getting out of date. Wrong information is worse
than no information.
> - Extending should say how to override placement and handle callbacks,
> - CG should make it clean how a programmer is supposed to interact with these.
I'd be fine with these.
Trevor
- Re: how offsets and alignment works: an explanation, (continued)
- Re: how offsets and alignment works: an explanation, Janek Warchoł, 2013/03/24
- Re: how offsets and alignment works: an explanation, Thomas Morley, 2013/03/24
- Re: how offsets and alignment works: an explanation, Thomas Morley, 2013/03/25
- Re: how offsets and alignment works: an explanation, Urs Liska, 2013/03/26
- Re: how offsets and alignment works: an explanation, David Nalesnik, 2013/03/26
- Re: how offsets and alignment works: an explanation, Urs Liska, 2013/03/26
- Re: how offsets and alignment works: an explanation, David Nalesnik, 2013/03/26
- Re: how offsets and alignment works: an explanation, Janek Warchoł, 2013/03/26
- Re: how offsets and alignment works: an explanation, luis jure, 2013/03/24
- Re: how offsets and alignment works: an explanation, Wim van Dommelen, 2013/03/25
- Re: how offsets and alignment works: an explanation,
Trevor Daniels <=
- Re: how offsets and alignment works: an explanation, Urs Liska, 2013/03/25
Re: how offsets and alignment works: an explanation, Jean-Charles Malahieude, 2013/03/24