it seemed that the cleanist & easiest way to implement this was to just allow the @title macro to be used multiple times in a script (Lua or uBASIC),
I would really prefer to have separate keywords, re-using the @title seems confusing. Yes, there are already a lot of confusing things in CHDK already, but I'd rather not proliferate them. I'd prefer to have something like @sectiontitle even if it was functionally equivalent.
I do agree with there is a need to provide a way to show more detailed information.
As far as UI goes, I think using the separator style is reasonable for 1.4. For the long term (1.5), I'd like to see something like the "hints and tips" in modern canon firmware, where there is a fixed area that shows a more detailed description of each item as you highlight it. This would need a different kind of definition, since it would be per item.
On a somewhat related note:
The current code scans the first 4k of the script for params. rawopint is up to ~2.7k. With more @titles or similar descriptive strings, hitting 4k is not implausible.