← Back to team overview

kicad-developers team mailing list archive

Re: Rename proposal

 

Le 10/09/2014 08:49, Lorenzo Marcantonio a écrit :
> While inspecting for text module usage, I found a couple of call which
> (for a little) puzzled me :D
> 
> IgnoreMTextsOnCopper and IgnoreMTextsOnCmp in the collector 'guide'
> class. At first I tought the first was referring to actual copper layers :P
> 
> Then I realized they referred to board sides... wouldn't they better be
> called IgnoreMTextsOnFront and IgnoreMTextsOnBack ?
> 
> Also what is their supposed semantic? At the moment since text on
> modules is only on SilkTop the collector simply checks for the module
> side. But the idea is that modules could have text on other layers too,
> possibly on the other side. Is that predicate meant only to act on silk
> text or on other text too?
> 
> Just a design decision. In the meantime I'll add them to the list of
> things to inspect to gleam the *actual* usage. Of course the same
> proposal holds for IgnoreModulesOnCu and IgnoreModulesOnCmp (given how
> many board are dual populated it's difficult to tell the copper side
> from the component side...)
> 


I agree these names are not good:

IgnoreMTextsOnCmp  or IgnoreModulesOnCmp should be
IgnoreMTextsOnFrontSide  or IgnoreModulesOnFrontSide

IgnoreMTextsOnCu  or IgnoreModulesOnCu should be
IgnoreMTextsOnBackSide  or IgnoreModulesOnBackSide

In fact these names come from French usage:
the Front or top side of a board is named component side ("coté composant")
and
the Back side or bottom side of this board is named copper side or
solder side ("coté cuivre" or "coté soudure")

It is not a reference to a copper layer.

But for English speakers, component side or copper side is not a good name.

-- 
Jean-Pierre CHARRAS


Follow ups

References