There is another case as how children were to be religiously brought up.

Interesting that you mentioned King D. Miguel of Portugal.

His daughter, catholic Infanta D. Maria Anna, married protestant (future) Grand-Duke Wilhelm IV of Luxembourg.
The couple agreed that future sons would be brought up as protestants while future daughters will be brought up as catholics.

The couple only had daughters and, eventually, the problem was solved.