Re: html cross refs proposal
Dumas Patrice <[email protected]> Mon, 15 Mar 2004 11:17:41 +0100
| Newsgroups | gmane.comp.tex.texinfo.pretest |
|---|---|
| Message-ID | <[email protected]> |
Hi Alper,
> I suppose the @ref in ``Testing manual name'' part should be:
>
> @verb{:../doc.texi:} @ref{node,,, ../doc.texi}@*
>
> instead of:
>
> @verb{:../manual/doc.texi:} @ref{node,,, ../manual/doc.texi}@*
>
> Is this correct?
I think both are correct. But the second shows a non trivial "feature" of
the proposal. And I think that you flaged it as an error because you
disagree with that part. Maybe that part could have been more discussed...
manual name expansion
---------------------
The manual description should only contain the following characters:
[A-Za-z0-9-_/.], / and . having a special meaning. It is interpreted as
a file name. The last element of the file with extension stripped is the
manual name.
Thus ../doc.texi and ../manual/doc.texi both lead to doc as manual name,
as /usr/doc/doc.bidule do.
And later in the proposal only the manual name is used to construct the
href leading to that manual (when there is nothing in the config file).
This means that the information embedded in the file path is lost in my
proposal. I believe this is a non trivial "feature", and maybe some may
disagree about that.
I am not fully satisfied with that approach, but I thought that ignoring
the path part and keeping only the manual name would be less prone to fail
outside of a peculiar installation. And also that instead of using the path
embedded in the @ref to locate the file, using the config file would be
better such that only manual names appear in the texinfo source. Maybe there
is a better solution ?
Pat
_______________________________________________
Texinfo home page: http://www.gnu.org/software/texinfo/
[email protected]
http://ff0.org/mailman/listinfo/texinfo-pretest