Re: removing the HTML Xref Mismatch node

[Patrice Dumas]

On Fri, Aug 23, 2024 at 11:01:25PM +0200, Patrice Dumas wrote:
> Hello,
> 
> While we are on the subject of HTML Xref, I think that the "HTML Xref
> Mismatch" node should be removed
> 
>  
> https://www.gnu.org/software/texinfo/manual/texinfo/html_node/HTML-Xref-Mismatch.html

Here is what I propose.  Could you please check the change in the
last paragraphs of HTML Xref Link Basics?  Here is that text obtained
after applying the patch:

 Whether the present manual is split or mono is determined by user
 option; @command{texi2any} defaults to split, with the
 @option{--no-split} option overriding this.
 Whether the referent manual is split or mono, however, is another bit
 of the external information (@pxref{HTML Xref Configuration}).

 By default, @command{texi2any} uses the same form of the referent manual as the
 present manual.  Thus, there can be a mismatch between the format of the
 referent manual that the generating software assumes, and the format it's
 actually present in.  If there is no external information, both mono
 and split form should be generated to be sure that the cross-references
 work irrespective of the split option.  This is something the software
 which generated the @emph{referent} manual has to do in advance, it's
 not something the software generating the cross-reference in the present
 manual can control.

-- 
Pat

remove_HTML_Xref_Mismatch.diff
Description: Text Data