Re: HTML self links to anchor points

2020-09-21 Thread Gavin Smith
On Mon, Sep 21, 2020 at 12:17:35PM -0700, Raymond Toy wrote:
> Using CSS is fine too for deffn and friends instead of anchor.  But this
> seems hard because I don't have a good way of figuring out where to put
> such links.  AFAICT, the link is basically .
> If it said , then I could do something.

Yes, I was thinking that there would have to be some change to texi2any.



Re: HTML self links to anchor points

2020-09-21 Thread Raymond Toy
On Sun, Sep 20, 2020 at 1:24 AM Gavin Smith 
wrote:

> On Wed, Sep 16, 2020 at 04:32:23PM -0700, Raymond Toy wrote:
> > For example you can navigate to
> >
> https://common-lisp.net/project/maxima/docs/maxima_singlepage.html#Item_003a-Bugs_002fdeffn_002frun_005ftestsuite
> > and this works just fine.
> >
> > But once you get there and maybe scroll around a bit to look for other
> > functions or variables, you can't easily get a link to the
> > function/variable/section.  Currently, you have to go to the index to
> find
> > a link to the thing.
> >
> > These entries all have @anchor{}, so it would be really nice if the HTML
> > doc could add some kind of self-link so that when I find what I want, I
> can
> > copy the link and share it with someone.
>
> I agree that this could be a useful feature.  I don't think it should be
> done with @anchor{} but maybe with @deffn, @defop etc.  The interface
> could be an icon that appears when you mouse over the text, as at
>
>
> https://docs.readthedocs.io/en/stable/intro/getting-started-with-sphinx.html


That looks nice and would certainly fine with me.

>
>
> where mousing over any heading pops up such an icon.  E.g. at
>
>
> https://common-lisp.net/project/maxima/docs/maxima_singlepage.html#Functions-and-Variables-for-Bug-Detection-and-Reporting
>
> mousing over the "Function: run_testsuite" could pop up such an icon.
> This should be possible with CSS as this still works on the page linked
> above even when JavaScript is disabled.
>

Using CSS is fine too for deffn and friends instead of anchor.  But this
seems hard because I don't have a good way of figuring out where to put
such links.  AFAICT, the link is basically .
If it said , then I could do something.




-- 
Ray


Re: Octave manual not buildable with texinfo from git master

2020-09-21 Thread Gavin Smith
On Mon, Sep 21, 2020 at 5:46 PM  wrote:
>
> Hello list,
>
> GNU Octave uses a quite complex build system for the documention, so I
> am not sure if this issue should be filed here or in the octave bug
> tracker. It works with texinfo 6.7, but fails with texinfo from
> master. I think this is related to the fact brought up in the thread
> with title "Testing lots of Texinfo files".

If that is the case could you try testing it after running "export
TEXINFO_XS_PARSER=0"?

Is there any way for me to try this without building Octave itself? Is
the Octave documentation available to download in Texinfo format
somewhere?



Octave manual not buildable with texinfo from git master

2020-09-21 Thread stefan-husmann
Hello list,

GNU Octave uses a quite complex build system for the documention, so I
am not sure if this issue should be filed here or in the octave bug
tracker. It works with texinfo 6.7, but fails with texinfo from
master. I think this is related to the fact brought up in the thread
with title "Testing lots of Texinfo files".

GEN  doc/interpreter/doc-cache
gkUdm2pEl7:1116: @xref reference to nonexistent node `Executable Octave 
Programs'
gkUdm2pEl7:1126: @xref reference to nonexistent node `Executable Octave 
Programs'
gkUdm2pEl7:1640: @xref reference to nonexistent node `The unwind_protect 
Statement'
gkUdm2pEl7:2227: @pxref reference to nonexistent node `Function Handles'
gkUdm2pEl7:2546: @xref reference to nonexistent node `Diary and Echo Commands'
gkUdm2pEl7:6583: @xref reference to nonexistent node `XREFtic'
gkUdm2pEl7:6963: @pxref reference to nonexistent node `XREFdbstop'
gkUdm2pEl7:7805: @pxref reference to nonexistent node `Formatted Output'
gkUdm2pEl7:7902: @pxref reference to nonexistent node `Formatted Output'
gkUdm2pEl7:7917: @ref reference to nonexistent node `XREFerror'
gkUdm2pEl7:7922: @pxref reference to nonexistent node `XREFwarning_ids'
gkUdm2pEl7:10873: @xref reference to nonexistent node `Strings'
gkUdm2pEl7:11061: @ref reference to nonexistent node 
`XREFmatlab_lang_makeValidName'
gkUdm2pEl7:12366: @ref reference to nonexistent node `Linear Algebra'
gkUdm2pEl7:12626: @ref reference to nonexistent node `Linear Algebra'
gkUdm2pEl7:12718: @ref reference to nonexistent node `Logical Values'
gkUdm2pEl7:12745: @ref reference to nonexistent node `Linear Algebra'
gkUdm2pEl7:12896: @ref reference to nonexistent node `Broadcasting'
gkUdm2pEl7:12963: @ref reference to nonexistent node `Broadcasting'
gkUdm2pEl7:13469: @ref reference to nonexistent node `Installation'
gkUdm2pEl7:13487: @xref reference to nonexistent node `Installation'
gkUdm2pEl7:14451: @pxref reference to nonexistent node `XREFbalance'
gkUdm2pEl7:14499: @pxref reference to nonexistent node `Startup Files'
gkUdm2pEl7:15018: @xref reference to nonexistent node `XREFregexp'
gkUdm2pEl7:15028: @xref reference to nonexistent node `XREFregexp'
gkUdm2pEl7:15853: @pxref reference to nonexistent node `XREFsize'
gkUdm2pEl7:15899: @pxref reference to nonexistent node `XREFsize'
gkUdm2pEl7:16524: @xref reference to nonexistent node `Timing Utilities'
gkUdm2pEl7:16528: @xref reference to nonexistent node `Timing Utilities'
gkUdm2pEl7:16532: @xref reference to nonexistent node `Timing Utilities'
gkUdm2pEl7:19768: @pxref reference to nonexistent node `XREFunique'
gkUdm2pEl7:19799: @pxref reference to nonexistent node `XREFsparse'
gkUdm2pEl7:20682: @pxref reference to nonexistent node `Formatted Output'
gkUdm2pEl7:21376: @pxref reference to nonexistent node `Formatted Output'
gkUdm2pEl7:21404: @pxref reference to nonexistent node `Formatted Output'
gkUdm2pEl7:22430: @pxref reference to nonexistent node `XREFcellfun'
gkUdm2pEl7:23234: @ref reference to nonexistent node `Figure Properties'
gkUdm2pEl7:23743: @ref reference to nonexistent node `XREFgetappdata'
gkUdm2pEl7:23766: @ref reference to nonexistent node `Uibuttongroup Properties'
gkUdm2pEl7:23810: @ref reference to nonexistent node `Uicontextmenu Properties'
gkUdm2pEl7:23852: @ref reference to nonexistent node `Uicontrol Properties'
gkUdm2pEl7:24048: @ref reference to nonexistent node `Uimenu Properties'
gkUdm2pEl7:24082: @ref reference to nonexistent node `Uipanel Properties'
gkUdm2pEl7:24128: @ref reference to nonexistent node `Uipushtool Properties'
gkUdm2pEl7:24248: @ref reference to nonexistent node `Uitable Properties'
gkUdm2pEl7:24448: @ref reference to nonexistent node `Uitoggletool Properties'
gkUdm2pEl7:24487: @ref reference to nonexistent node `Uitoolbar Properties'
gkUdm2pEl7:24547: @ref reference to nonexistent node `Figure Properties'
gkUdm2pEl7:24990: @pxref reference to nonexistent node `XREFlu'
gkUdm2pEl7:24993: @pxref reference to nonexistent node `XREFcgs'
gkUdm2pEl7:24993: @pxref reference to nonexistent node `XREFgmres'
gkUdm2pEl7:25021: @pxref reference to nonexistent node `Broadcasting'
gkUdm2pEl7:25282: @pxref reference to nonexistent node `Command Line Options'
gkUdm2pEl7:25915: @ref reference to nonexistent node `Image Properties'
gkUdm2pEl7:25949: @ref reference to nonexistent node `Image Properties'
gkUdm2pEl7:26163: @pxref reference to nonexistent node `Representing Images'
gkUdm2pEl7:26682: @pxref reference to nonexistent node `XREFdlmread'
gkUdm2pEl7:26699: @pxref reference to nonexistent node `XREFdlmwrite'
gkUdm2pEl7:27103: @pxref reference to nonexistent node `Anonymous Functions'
gkUdm2pEl7:27125: @pxref reference to nonexistent node `Anonymous Functions'
gkUdm2pEl7:29191: @pxref reference to nonexistent node `XREFsystem'
gkUdm2pEl7:30500: @xref reference to nonexistent node `XREFload'
gkUdm2pEl7:30503: @xref reference to nonexistent node `XREFhgload'
gkUdm2pEl7:30949: @xref reference to nonexistent node `XREFwarning_ids'
gkUdm2pEl7:32185: @ref