Re: @ref displays "see" strings in info files
The solution is to use this declaration in Emacs Init files for info. (setq Info-hide-note-references 'hide) "hide" is not in the Manual, but shows up when doing "M-x describe-variable Info-hide-note-references" Shall update the documentation. Would be worthwhile to add a few words about this alto in the Texinfo Manual. There could be a section: "Viewing Info Files in Emacs", with some details. I could write something. > Sent: Friday, October 16, 2020 at 10:23 PM > From: "Gavin Smith" > To: "Christopher Dimech" > Cc: "help-texinfo gnu" > Subject: Re: @ref displays "see" strings in info files > > On Fri, Oct 16, 2020 at 10:18:55PM +0200, Christopher Dimech wrote: > > > > > > > > It does not make a difference what value you put (t, nil, other). One > > either gets "see" > > or *note. > > > > You don't see any problem with texinfo right, but a problem with Emacs. > > Correct? > > > > Yes. >
Re: @ref displays "see" strings in info files
Have sent an bug-report to the Emacs group. Keep awesome. Regards Christopher - Christopher Dimech Chief Administrator - Naiad Informatics - GNU Project (Geocomputation) - Geophysical Simulation - Geological Subsurface Mapping - Disaster Preparedness and Mitigation - Natural Resource Exploration and Production - Free Software Advocacy > Sent: Friday, October 16, 2020 at 10:23 PM > From: "Gavin Smith" > To: "Christopher Dimech" > Cc: "help-texinfo gnu" > Subject: Re: @ref displays "see" strings in info files > > On Fri, Oct 16, 2020 at 10:18:55PM +0200, Christopher Dimech wrote: > > > > > > > > It does not make a difference what value you put (t, nil, other). One > > either gets "see" > > or *note. > > > > You don't see any problem with texinfo right, but a problem with Emacs. > > Correct? > > > > Yes. >
Re: @ref displays "see" strings in info files
On Fri, Oct 16, 2020 at 10:18:55PM +0200, Christopher Dimech wrote: > > > > It does not make a difference what value you put (t, nil, other). One either > gets "see" > or *note. > > You don't see any problem with texinfo right, but a problem with Emacs. > Correct? > Yes.
Re: @ref displays "see" strings in info files
It does not make a difference what value you put (t, nil, other). One either
gets "see"
or *note.
You don't see any problem with texinfo right, but a problem with Emacs. Correct?
Regards
C*
Sent: Friday, October 16, 2020 at 9:54 PM
From: "Gavin Smith"
To: "Christopher Dimech"
Cc: "help-texinfo gnu"
Subject: Re: @ref displays "see" strings in info files
You could check the Emacs documentation of Info-hide-note-references.
https://www.gnu.org/software/emacs/manual/html_node/info/Emacs-Info-Variables.html
On Fri, Oct 16, 2020 at 8:52 PM Christopher Dimech wrote:
>
>
> Hi, Gavin,
>
> Fine. Still, the problem should not occur. Is it a problem with Texinfo or
> Emacs?
> What could fix the problem? Have read the comment but does not provide clear
> details. To me anyway.
>
> Regards
> Christopher
>
> Sent: Friday, October 16, 2020 at 9:35 PM
> From: "Gavin Smith"
> To: "Christopher Dimech"
> Cc: "help-texinfo gnu"
> Subject: Re: @ref displays "see" strings in info files
> On Fri, Oct 16, 2020 at 06:06:23PM +0200, Christopher Dimech wrote:
> > I am writing a manual using makeinfo
> >
> > I have written the following
> >
> > @macro Gela-Menu
> > @paragraphindent 0
> > @* * @ref{Modifier-Keys}:: Modifier Keys on Lisp Machine Keyboards.
> > @* * @ref{Key-Mnemonics}:: Mnemonics that identify specific keys.
> > @paragraphindent 3
> > @end macro
> >
> > This was to add a Menu at the end of sections, so that users can continue
> > using the manual without having to go to the top of the buffer.
> >
> > But I have noticed that the output is as follows even though @ref is not
> > supposed
> > so generate the "see" string when loading the info file.
> >
> > * see Modifier-Keys:: Modifier Keys on Lisp Machine Keyboards.
> > * see Key-Mnemonics:: Mnemonics that identify specific keys.
> >
> > This also happens when @ref is not put in a @macro. And same "see" effect
> > when
> > put in @table as well.
> >
> > Regards
> > C*
>
> This has been asked so many times that I've written a whole new FAQ about
> it, to which I refer you ;-)
>
> https://git.savannah.gnu.org/cgit/texinfo.git/commit/?id=35f4537b19697a448d4aa36389e6f1f736905281[https://git.savannah.gnu.org/cgit/texinfo.git/commit/?id=35f4537b19697a448d4aa36389e6f1f736905281]
Re: @ref displays "see" strings in info files
You could check the Emacs documentation of Info-hide-note-references.
https://www.gnu.org/software/emacs/manual/html_node/info/Emacs-Info-Variables.html
On Fri, Oct 16, 2020 at 8:52 PM Christopher Dimech wrote:
>
>
> Hi, Gavin,
>
> Fine. Still, the problem should not occur. Is it a problem with Texinfo or
> Emacs?
> What could fix the problem? Have read the comment but does not provide clear
> details. To me anyway.
>
> Regards
> Christopher
>
> Sent: Friday, October 16, 2020 at 9:35 PM
> From: "Gavin Smith"
> To: "Christopher Dimech"
> Cc: "help-texinfo gnu"
> Subject: Re: @ref displays "see" strings in info files
> On Fri, Oct 16, 2020 at 06:06:23PM +0200, Christopher Dimech wrote:
> > I am writing a manual using makeinfo
> >
> > I have written the following
> >
> > @macro Gela-Menu
> > @paragraphindent 0
> > @* * @ref{Modifier-Keys}:: Modifier Keys on Lisp Machine Keyboards.
> > @* * @ref{Key-Mnemonics}:: Mnemonics that identify specific keys.
> > @paragraphindent 3
> > @end macro
> >
> > This was to add a Menu at the end of sections, so that users can continue
> > using the manual without having to go to the top of the buffer.
> >
> > But I have noticed that the output is as follows even though @ref is not
> > supposed
> > so generate the "see" string when loading the info file.
> >
> > * see Modifier-Keys:: Modifier Keys on Lisp Machine Keyboards.
> > * see Key-Mnemonics:: Mnemonics that identify specific keys.
> >
> > This also happens when @ref is not put in a @macro. And same "see" effect
> > when
> > put in @table as well.
> >
> > Regards
> > C*
>
> This has been asked so many times that I've written a whole new FAQ about
> it, to which I refer you ;-)
>
> https://git.savannah.gnu.org/cgit/texinfo.git/commit/?id=35f4537b19697a448d4aa36389e6f1f736905281
Re: @ref displays "see" strings in info files
Apologies, Gavin,
Fine. Still, the problem should not occur. Is it a problem with Texinfo or
Emacs?
What could fix the problem? Have read the comment but does not provide clear
details. To me anyway.
Regards
Christopher
Sent: Friday, October 16, 2020 at 9:35 PM
From: "Gavin Smith"
To: "Christopher Dimech"
Cc: "help-texinfo gnu"
Subject: Re: @ref displays "see" strings in info files
On Fri, Oct 16, 2020 at 06:06:23PM +0200, Christopher Dimech wrote:
> I am writing a manual using makeinfo
>
> I have written the following
>
> @macro Gela-Menu
> @paragraphindent 0
> @* * @ref{Modifier-Keys}:: Modifier Keys on Lisp Machine Keyboards.
> @* * @ref{Key-Mnemonics}:: Mnemonics that identify specific keys.
> @paragraphindent 3
> @end macro
>
> This was to add a Menu at the end of sections, so that users can continue
> using the manual without having to go to the top of the buffer.
>
> But I have noticed that the output is as follows even though @ref is not
> supposed
> so generate the "see" string when loading the info file.
>
> * see Modifier-Keys:: Modifier Keys on Lisp Machine Keyboards.
> * see Key-Mnemonics:: Mnemonics that identify specific keys.
>
> This also happens when @ref is not put in a @macro. And same "see" effect when
> put in @table as well.
>
> Regards
> C*
This has been asked so many times that I've written a whole new FAQ about
it, to which I refer you ;-)
https://git.savannah.gnu.org/cgit/texinfo.git/commit/?id=35f4537b19697a448d4aa36389e6f1f736905281
Re: @ref displays "see" strings in info files
Hi, Gavin,
Fine. Still, the problem should not occur. Is it a problem with Texinfo or Emacs?
What could fix the problem? Have read the comment but does not provide clear
details. To me anyway.
Regards
Christopher
Sent: Friday, October 16, 2020 at 9:35 PM
From: "Gavin Smith"
To: "Christopher Dimech"
Cc: "help-texinfo gnu"
Subject: Re: @ref displays "see" strings in info files
On Fri, Oct 16, 2020 at 06:06:23PM +0200, Christopher Dimech wrote:
> I am writing a manual using makeinfo
>
> I have written the following
>
> @macro Gela-Menu
> @paragraphindent 0
> @* * @ref{Modifier-Keys}:: Modifier Keys on Lisp Machine Keyboards.
> @* * @ref{Key-Mnemonics}:: Mnemonics that identify specific keys.
> @paragraphindent 3
> @end macro
>
> This was to add a Menu at the end of sections, so that users can continue
> using the manual without having to go to the top of the buffer.
>
> But I have noticed that the output is as follows even though @ref is not supposed
> so generate the "see" string when loading the info file.
>
> * see Modifier-Keys:: Modifier Keys on Lisp Machine Keyboards.
> * see Key-Mnemonics:: Mnemonics that identify specific keys.
>
> This also happens when @ref is not put in a @macro. And same "see" effect when
> put in @table as well.
>
> Regards
> C*
This has been asked so many times that I've written a whole new FAQ about
it, to which I refer you ;-)
https://git.savannah.gnu.org/cgit/texinfo.git/commit/?id=35f4537b19697a448d4aa36389e6f1f736905281
Re: @ref displays "see" strings in info files
On Fri, Oct 16, 2020 at 06:06:23PM +0200, Christopher Dimech wrote:
> I am writing a manual using makeinfo
>
> I have written the following
>
> @macro Gela-Menu
> @paragraphindent 0
> @* * @ref{Modifier-Keys}:: Modifier Keys on Lisp Machine Keyboards.
> @* * @ref{Key-Mnemonics}:: Mnemonics that identify specific keys.
> @paragraphindent 3
> @end macro
>
> This was to add a Menu at the end of sections, so that users can continue
> using the manual without having to go to the top of the buffer.
>
> But I have noticed that the output is as follows even though @ref is not
> supposed
> so generate the "see" string when loading the info file.
>
> * see Modifier-Keys:: Modifier Keys on Lisp Machine Keyboards.
> * see Key-Mnemonics:: Mnemonics that identify specific keys.
>
> This also happens when @ref is not put in a @macro. And same "see" effect when
> put in @table as well.
>
> Regards
> C*
This has been asked so many times that I've written a whole new FAQ about
it, to which I refer you ;-)
https://git.savannah.gnu.org/cgit/texinfo.git/commit/?id=35f4537b19697a448d4aa36389e6f1f736905281
