Re: [help-texinfo] Help with @ref

[Patrice Dumas]

On Fri, Jul 17, 2015 at 09:53:28AM -0700, Arthur Schwarz wrote:
> I am attempting to turn an Open Office document into a texinfo document. I
> have done:
> 
>     odt -> HTML -> texi using pandoc
> 
> and have discovered, well, that pandoc doesn't quite work. The major issue I
> have now is that pandoc has generated, man statements like "1.0 Overview
> @ref{#__RefHeading__4496_490911158,8}". Makeinfo reports an error message
> (@ref reference to nonexistent node `#__RefHeading__4496_490911158') for
> each @ref statement. I think I understand what is meant but the Texinfo
> Manual in Appendix A shows "@ref{ node, [entry], [node-title], [info-file],
> [manual]}" without any explanation. If would help me if some explanation is
> available to direct me on fixing the pandoc generated code. 

This part of the manual is terse for good reason, it is a list of every
command.  But there is some text though (in info):

'@ref{NODE, [ENTRY], [NODE-TITLE], [INFO-FILE], [MANUAL]}'
     Make a plain reference that does not start with any special text.
     Follow command with a punctuation mark.  Only the first argument is
     mandatory.  *Note @ref::.

And a reference to the specific @ref explanation in the manual.  There
should be such a reference in any output format which should lead you to
the section you are looking for.


For your particular issue, a @ref{} with only the node name (or @anchor) 
as argument looks good to me, but the document should contain such a
node or anchor, I guess the pandoc generated Texinfo document lacks the
node.

-- 
Pat