bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Makeinfo --html produces broken external refs


From: Karl Berry
Subject: Re: Makeinfo --html produces broken external refs
Date: Thu, 5 Jul 2007 18:36:57 -0500

Hi Sergey,

- No question that the current situation with cross-manual links is bad.

- It doesn't make sense to hardwire the www.gnu.org setup into makeinfo
  IMHO.  This is why Patrice and I worked out this external
  configuration file thing.  No, it's not implemented in makeinfo yet,
  and I wasn't planning to attempt it for the next release (which has
  already been delayed too long).

- Having Texinfo source commands for this doesn't seem right to me.
  Where and how the references should link is related to the system on
  which the manual is installed rather than the document.

- I believe that the current situation can be ameliorated by changing
  gendocs.sh to assume a different structure, the one used in
  gnu.org/manual/emacs (which goes back to having html_mono).  .symlinks
  can be used to find manuals for other packages.  Not perfect, but
  better.  Perfection will have to come later ...

- The current structure written by gendocs was actually perpetrated by
  me, fairly recently.  It seemed unnecessary to me to have all those
  subdirectories for each file format, and desirable to have each manual
  in its directory, but I was wrong.  I just haven't had time to delve
  back into it since I was informed.

Best,
Karl




reply via email to

[Prev in Thread] Current Thread [Next in Thread]