Re: [docbook-apps] using markup inside title elements

2020-09-23 Thread Peter Eisentraut
On 2020-09-23 14:05, Norm Tovey-Walsh wrote: Let's say we have a refentry for "foo", so it would be nice to write You can use commands or bar for this. I’d probably do this: You can use commands or bar for this. Okay, thanks for this tip, this looks nicest. We're not

Re: [docbook-apps] using markup inside title elements

2020-09-23 Thread oasis
Hi Peter, > Let's say we have a refentry for "foo", so it would be nice to write > > You can use commands or > bar for this. depending on what you want to achieve (and what your documentation processes are), maybe using entities instead is a more viable solution? This (maybe in a

Re: [docbook-apps] using markup inside title elements

2020-09-23 Thread Norm Tovey-Walsh
Peter Eisentraut writes: > I have a question whether markup inside title elements is recommended > practice. It’s definitely one of those edge cases that probably depends a lot on your specific processing expectations. I don’t think there’s anything wrong with markup in titles, in principle, but

[docbook-apps] using markup inside title elements

2020-09-23 Thread Peter Eisentraut
I have a question whether markup inside title elements is recommended practice. For example, consider text like You can use commands foo or bar for this. Let's say we have a refentry for "foo", so it would be nice to write You can use commands or bar for this. But then the