>> Mhmm, more tests show that for `@code{foo--bar}` there is no
>> `@discretionary` after the two hyphens.  Is this intentional?
> 
> Yes, it is.  This was to stop hyphenation in @option{--option}.

OK.  I guess it isn't easily possible to make TeX insert a
discretionary after two hyphens in the middle of a word while still
preventing a break after two leading dashes...

For LilyPond's documentation I've already written a LuaTeX filter to
improve `@code`, so it doesn't directly bother me :-)

  
https://gitlab.com/lilypond/lilypond/-/commit/33cd718fb0a3c844d0c20a99870fd6b4d4f91a9c

This filter needs `@allowcodebreaks false` and currently doesn't
handle the 'foo--bar' case (because it doesn't happen in LilyPond's
documentation), but adding it would be straightforward.

>> Additionally, I wonder whether the same logic should be applied to
>> `_`.  If you want to document, say, C prepocessor symbols, you will
>> have tokens like `_foo` or `__foo_bar`, and `texinfo.tex` happily
>> inserts `@discretionary` after all of those underline characters.
> 
> [...] it would make sense to do the same thing for _ as for -.

Yeah.  I currently don't see any negative side effects if the handling
would be made similar.


    Werner

Reply via email to