[M3devel] naming conventions for split/composed interfaces?

[Jay]

another idea:

merge UpthreadMachine.i3 and UstatMachine.i3 into just Umachine.i3.
Seems like it produces fewer medium sized files instead of more tiny ones but I think I see a drawback too, and until I hear back will go with UstatMachine.
Eventually more sharing is probably possible, like of all of Ustat across all platforms, except for struct_stat.
And all of Upthread except the sizes of the types and possibly the initializers (Cygwin has non-zero initializers, ideally they are all zero though.)
And most of Cstd*. It bugs me to have so many so similar files....

 - Jay

have moved struct
> From: jayk123 at hotmail.com
> To: m3devel at elegosoft.com
> Subject: naming conventions for split/composed interfaces?
> Date: Wed, 23 Apr 2008 15:20:41 +0000
> 
> 
> So I'm fixing AMD64_LINUX Utypes.i3, Ustat.i3, etc.
> 
> Look at what I did for example with Upthread.i3 vs. UpthreadMachine.i3.
> 
> Ustat.i3 shall be mostly the same between PPC_LINUX, LINUXLIBC6 (I386_LINUX), AMD64_LINUX, etc.
> 
> However struct_stat will not likely be. It appears, though I have to double check, the difference cannot be abstracted out to pointer-sized integer types, that the fields are of varying orders.
> 
> So I want to say:
> 
> linux-i386/UstatPlatformSpecific.i3
>   TYPE struct_stat = ...
> 
> linux-amd64/UstatPlatformSpecific.i3
>   TYPE struct_stat = ...
> 
> linux-ppc/UstatPlatformSpecific.i3
>   TYPE struct_stat = ...
> 
> linuxlibc/Ustat.i3
>   TYPE struct_stat = UstatsPlatformSpecific.struct_stat;
> 
> My question is simply:
> 
> What is the, or a good, naming convention for UstatPlatformSpecific?
> 
> Note that it /could/ be that all but x86 have the same definition, so "PlatformSpecific", might be too, um, specific.
> UstatMachine? (Similarly wrong, but maybe no matter, and shorter.)
> UstatNotCommon? Sounds dumb.
> UstatX? Not as bad as it sounds. There is a precedent. It self-documents the idea that there isn't an obvious good name.
> UstatInternal? UstatPrivate?
>   It's not really about hiding, so much as implementation factoring. But implementation structure is an internal detail.
> UstatF? (Friend?)
> Ustructstat? no -- ideally, anything in existing Ustat.i3 that varies goess here, not necessarily just this type.
> 
> I do not want fork entire files.
> The system is composed of common and uncommon pieces.
> I believe the decision where to split should be in general pushed down.
> However not without judgement calls.
> You know, there are things that must be shared, things that are nice to share, things that are more efficient to share, things that cannot be shared.
> Type declarations are usually "must" but in this case largely "nice" (not Ustat, but e.g. Upthreads), and some parts of them "cannot".
> 
> This split/compose pattern, you know, is a way to get something like #ifdef, without any language change or such.
> It does make existing code harder to read, because it is broken up into more pieces, but code will always be broken up into pieces and never all in one place and always require some assumption or tracking down of what the next level down does (until you get to atoms, quantum physics, and all that), the thing is merely to decide on just what amount is the right amount (says Goldilocks.)
> 
>  - Jay
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://m3lists.elegosoft.com/pipermail/m3devel/attachments/20080423/43d83c13/attachment-0002.html>