Re: [help-texinfo] Using @ref @xref and @pxref

2019-01-01 Thread Gavin Smith
On Tue, Jan 01, 2019 at 06:00:53PM +0100, Christopher Dimech wrote:
> I have written a document in texinfo. I put all the document material into 
> one file.
> Now I am trying to split things into multiple files as the document has 
> become too long.
> 
> 
> I have seen that @ref can be used with up to five parameters but cannot find 
> useful examples 
> of how to carry out the change. I would appreciate help in this new plan so 
> very much
> 

You would carry on using one parameter to @ref.  If the files are 
included with @include that is as if the targets and links are all 
within the same manual.  It is not a link between different manuals in 
your situation: the link is within a single manual.



[help-texinfo] Using @ref @xref and @pxref

2019-01-01 Thread Christopher Dimech
I have written a document in texinfo. I put all the document material into one 
file.
Now I am trying to split things into multiple files as the document has become 
too long.


I have seen that @ref can be used with up to five parameters but cannot find 
useful examples 
of how to carry out the change. I would appreciate help in this new plan so 
very much

$ ~/umedu
.
├── report.texi
├── chap1
│   ├── bibliography.texi
│   ├── figures.texi
└── umedu--files

Here are examples I had using @ref  

report.texi:
@pxref{fig:siculo--calabri--tectonic--map}.
@ref{gutscher--kopp--krastel--et--al--2017,, Marc-Andr@'e (2017)}

@node figures
@unnumberedsec Figures
@include ./chap1/figures.texi

@node bibliography
@unnumberedsec Bibliography
@include ./chap1/bibliography.texi

figures.texi:

@float Figure,fig:siculo--calabri--tectonic--map
  @center @image{./umedu--files/siculo--calabri--tectonic--map,11cm,,,.png}
  @caption{Description}
  @shortcaption{Short Description}
@end float

bibliography.texi:

@anchor{gutscher--kopp--krastel--et--al--2017}  
2017.  @sc{Gutscher, Marc-Andr@'e}; @strong{Active tectonics of
the Calabrian subduction revealed by new multi-beam bathymetric data and
high-resolution seismic profiles in the Ionian Sea (Central
Mediterranean).} Earth and Planetary Science Letters, Volume 461,
Pagination 61-72.
@uref{https://www.researchgate.net/Calabrian_subduction_revealed, [Complete 
Article]}.
@c {Published: January 09}