Re: Problem in docs: ref in included/

[Trevor Daniels]

Mark Polesky wrote Tuesday, March 02, 2010 1:18 AM


> Francisco Vila wrote:
> > Compile stopped there, then I removed the @ref and compile
> > succeeded; I even added a warning following Graham.  An
> > extra point is: nobody told she could compile the docs
> > without the remove.
>
> I just successfully compiled commit 715dc5e, which contains
> the @ref being discussed.  Am I doing something wrong?  Why
> would it work for me and not for everyone else?  The reason
> it's important to me is because I don't want to commit
> something un-compilable.

Mark, I replied too hastily last night.  I think
you are right after all, although I don't have time
right now to actually compile the docs to check.
I'll do it a little later today.

Following Francisco's "correction" my local check
on reference validity now says

> Warning: xref should be internal around line  231  in 
> included/compile.itexi
> Warning: xref should be internal around line  761  in 
> included/compile.itexi

so I think these two should be set back to straight @refs.

Trevor