I've been arguing with a colleague about a description for a piece of code. Originally, the message was as follows:
XXX is a macro that, given a component name and a variable name pattern, produces a name of a component-specific variable.
But my colleague thinks that the following would sound better:
XXX is a macro that for the given component name and variable name pattern produces a name of a component-specific variable.
My main question is: is the phrase "for the given component name ..." allowed at that position (i.e. before the verb)? I have the feeling that such phrase is only possible after the object (i.e. "... produces a name of a component-specific variable for the given component name ...") but I've been unable to find any specific rule. Also, what is the correct grammatical term for the phrase? (Is it an adjunct?).
Finally, if both sentences are possible, which of them sounds better?