I suggest adding a warning to the halign example, pointing out the use
of \linebreak versus \newline (aka \\) in text boxes. \newline destroys
proper aligning. Alas, \\ is often recommended as a way to enforce line
breaks in TeX. This is wrong but widespread, so a warning is warranted.
Ref.: Discussion on pyx-users, thread off