@exdent in @itemize introduces excessive spacing

2020-11-14 Thread Christopher Dimech
The following section adds excessive vertical space instead of only removing
indentation,

@itemize @w{}
@item
   @exdent @math{H_I(t)}: The Instrumental Transfer Response Function.
@item
   @exdent @math{T_G(t)}: The Actual Physical Ground Motion.
@end itemize



Displaying images for html output

2020-11-14 Thread Christopher Dimech
What is the command for displaying images for html output.  When I use
@image, the image is only being displayed when using texi2pdf.

Regards
Christopher




Re: Failure in html output - Reference to nonexistent nodes

2020-11-14 Thread Christopher Dimech
> Another possibility is to put @novalidate in the document.

The above is good, but we still want the error to show and in the output to 
say unidentified, or something of the sort.
 

Howe

> Sent: Saturday, November 14, 2020 at 6:28 PM
> From: "Gavin Smith" 
> To: "Patrice Dumas" , "Christopher Dimech" 
> , "help-texinfo gnu" 
> Subject: Re: Failure in html output - Reference to nonexistent nodes
>
> On Sat, Nov 14, 2020 at 04:09:14PM +0100, Patrice Dumas wrote:
> > On Sat, Nov 14, 2020 at 03:13:27PM +0100, Christopher Dimech wrote:
> > > Some time ago I discussed the problem that calling a reference
> > > to a nonexistent node when generating .info files.
> > > 
> > > When outputting html, reference to nonexistent node also gives a
> > > problem.  
> > > 
> > > @ref reference to nonexistent node `igc03--Sicl--CircAmRg'
> > 
> > That seems to be a good thing to me, this is an clearly an error.
> > 
> > > Problem is aggravated because the failure stops the 
> > > generation of any files.   
> > >  
> > > When using texi2pdf, one gets in the output pdf document
> > > 
> > >  [igc03–Sicl–CircAmRg], page ,
> > > 
> > > This is much better than not generating any output.
> > 
> > My wild guess is that opinions are probably divided on that matter.
> > 
> > But there is a possibility with texi2any to generate input even in case
> > of errors, with the option --force.  The option --error-limit may also be
> > of use in that context.  There is also --no-warn that an be used to
> > silence the warnings.
> 
> Another possibility is to put @novalidate in the document.
>



Re: Failure in html output - Reference to nonexistent nodes

2020-11-14 Thread Gavin Smith
On Sat, Nov 14, 2020 at 04:09:14PM +0100, Patrice Dumas wrote:
> On Sat, Nov 14, 2020 at 03:13:27PM +0100, Christopher Dimech wrote:
> > Some time ago I discussed the problem that calling a reference
> > to a nonexistent node when generating .info files.
> > 
> > When outputting html, reference to nonexistent node also gives a
> > problem.  
> > 
> > @ref reference to nonexistent node `igc03--Sicl--CircAmRg'
> 
> That seems to be a good thing to me, this is an clearly an error.
> 
> > Problem is aggravated because the failure stops the 
> > generation of any files.   
> >  
> > When using texi2pdf, one gets in the output pdf document
> > 
> >  [igc03–Sicl–CircAmRg], page ,
> > 
> > This is much better than not generating any output.
> 
> My wild guess is that opinions are probably divided on that matter.
> 
> But there is a possibility with texi2any to generate input even in case
> of errors, with the option --force.  The option --error-limit may also be
> of use in that context.  There is also --no-warn that an be used to
> silence the warnings.

Another possibility is to put @novalidate in the document.



Re: Macros inside @displaymath

2020-11-14 Thread Christopher Dimech



> Sent: Saturday, November 14, 2020 at 5:17 PM
> From: "Patrice Dumas" 
> To: "Gavin Smith" 
> Cc: "Christopher Dimech" , "help-texinfo gnu" 
> 
> Subject: Re: Macros inside @displaymath
>
> On Sat, Nov 14, 2020 at 08:49:05AM +, Gavin Smith wrote:
> >
> > This works perfectly with TeX as far as I can see, but unfortunately
> > not with texi2any at present.  This could be changed to make
> > @displaymath more like @example, where Texinfo commands are interpreted,
> > and less like @verbatim where they are not.
>
> I think that even better would be that it is parsed the same way as
> @math, with braces balanced handled even if not associated with
> @-commands and @-commands interpreted.

That's a good strategy
Christopher

> I can do that for the perl parser.
>
> --
> Pat
>



Re: Failure in html output - Reference to nonexistent nodes

2020-11-14 Thread Christopher Dimech
Still for productivity's sake, output is better than no output.
This is especially important for large works, where the author
does not want complete failure because of some inconsistency.

I am suggesting that the error message still shows up in the
output.  

I suggest a variable that can be used for strict checking.

> Sent: Saturday, November 14, 2020 at 4:09 PM
> From: "Patrice Dumas" 
> To: "Christopher Dimech" 
> Cc: "help-texinfo gnu" , "Gavin Smith" 
> 
> Subject: Re: Failure in html output - Reference to nonexistent nodes
>
> On Sat, Nov 14, 2020 at 03:13:27PM +0100, Christopher Dimech wrote:
> > Some time ago I discussed the problem that calling a reference
> > to a nonexistent node when generating .info files.
> > 
> > When outputting html, reference to nonexistent node also gives a
> > problem.  
> > 
> > @ref reference to nonexistent node `igc03--Sicl--CircAmRg'
> 
> That seems to be a good thing to me, this is an clearly an error.
> 
> > Problem is aggravated because the failure stops the 
> > generation of any files.   
> >  
> > When using texi2pdf, one gets in the output pdf document
> > 
> >  [igc03–Sicl–CircAmRg], page ,
> > 
> > This is much better than not generating any output.
> 
> My wild guess is that opinions are probably divided on that matter.
> 
> But there is a possibility with texi2any to generate input even in case
> of errors, with the option --force.  The option --error-limit may also be
> of use in that context.  There is also --no-warn that an be used to
> silence the warnings.
> 
> -- 
> Pat
>



Re: Macros inside @displaymath

2020-11-14 Thread Gavin Smith
On Sat, Nov 14, 2020 at 05:17:16PM +0100, Patrice Dumas wrote:
> On Sat, Nov 14, 2020 at 08:49:05AM +, Gavin Smith wrote:
> > 
> > This works perfectly with TeX as far as I can see, but unfortunately
> > not with texi2any at present.  This could be changed to make
> > @displaymath more like @example, where Texinfo commands are interpreted,
> > and less like @verbatim where they are not.
> 
> I think that even better would be that it is parsed the same way as
> @math, with braces balanced handled even if not associated with
> @-commands and @-commands interpreted.
> 
> I can do that for the perl parser.

Great, thank you.



Re: Macros inside @displaymath

2020-11-14 Thread Patrice Dumas
On Sat, Nov 14, 2020 at 08:49:05AM +, Gavin Smith wrote:
> 
> This works perfectly with TeX as far as I can see, but unfortunately
> not with texi2any at present.  This could be changed to make
> @displaymath more like @example, where Texinfo commands are interpreted,
> and less like @verbatim where they are not.

I think that even better would be that it is parsed the same way as
@math, with braces balanced handled even if not associated with
@-commands and @-commands interpreted.

I can do that for the perl parser.

-- 
Pat



Re: Failure in html output - Reference to nonexistent nodes

2020-11-14 Thread Patrice Dumas
On Sat, Nov 14, 2020 at 03:13:27PM +0100, Christopher Dimech wrote:
> Some time ago I discussed the problem that calling a reference
> to a nonexistent node when generating .info files.
> 
> When outputting html, reference to nonexistent node also gives a
> problem.  
> 
> @ref reference to nonexistent node `igc03--Sicl--CircAmRg'

That seems to be a good thing to me, this is an clearly an error.

> Problem is aggravated because the failure stops the 
> generation of any files.   
>  
> When using texi2pdf, one gets in the output pdf document
> 
>  [igc03–Sicl–CircAmRg], page ,
> 
> This is much better than not generating any output.

My wild guess is that opinions are probably divided on that matter.

But there is a possibility with texi2any to generate input even in case
of errors, with the option --force.  The option --error-limit may also be
of use in that context.  There is also --no-warn that an be used to
silence the warnings.

-- 
Pat



Re: @vskip does not work in html output

2020-11-14 Thread Patrice Dumas
On Sat, Nov 14, 2020 at 02:33:17PM +0100, Christopher Dimech wrote:
> The following does not work for html output.  It works with texi2pdf.

It works as intended, the @-command is ignored.  It seems to be quite
sensible to ignore this @-command in every output format but pdf through
TeX (if someday there is a converter to LaTeX, maybe it could be
handled too and converted to an equivalent LaTeX command).

> 
> 1
> @vskip 1mm
> 2
> @vskip 5mm
> 3
> @vskip 8mm
> 4
> 



Re: \blacksquare and \square do not work in texi2pdf

2020-11-14 Thread Patrice Dumas
On Sat, Nov 14, 2020 at 12:55:10PM +0100, Christopher Dimech wrote:
> Some have been saying that one can use some latex commands.
> What's the story?

The situations in which LaTeX commands will work are the following:
* expanding to html, maybe using --iftex and using latex2html to
  expand @math, @displaymath (and @tex).  Or using tex4ht, but setting
  in a perl init file 
   $Texinfo::TeX4HT::STYLE_MATH = 'latex' 
  and
   $Texinfo::TeX4HT::STYLE_TEX  = 'latex'
  In the next release, that would be with -c HTML_MATH=l2h or -c HTML_MATH=t4h
* expanding to html and using mathjax with -c HTML_MATH=mathjax

However that's the only output format and only situations in which LaTeX
commands will work, so it is not really documented anywhere, only TeX 
commands are documented to work, because they work with texi2pdf and in
the situations descibed above too.

-- 
Pat



Failure in html output - Reference to nonexistent nodes

2020-11-14 Thread Christopher Dimech
Some time ago I discussed the problem that calling a reference
to a nonexistent node when generating .info files.

When outputting html, reference to nonexistent node also gives a
problem.  

@ref reference to nonexistent node `igc03--Sicl--CircAmRg'

Problem is aggravated because the failure stops the 
generation of any files.   
 
When using texi2pdf, one gets in the output pdf document

 [igc03–Sicl–CircAmRg], page ,

This is much better than not generating any output.

I have read some innovative ideas from Language Designer Luca
Saiu, to make programs run even with errors.  These ideas will
certainly be interesting, because as with the pdf output, the
difficulties are transplanted in the output.  Then one can
eventually go and fix them.

However, the problem with undefined ref will not stop the author
from continuing with his work until he resolves undefined ref.

I mention this also for the generation of .info files.




@vskip does not work in html output

2020-11-14 Thread Christopher Dimech
The following does not work for html output.  It works with texi2pdf.

1
@vskip 1mm
2
@vskip 5mm
3
@vskip 8mm
4



@* in @macro gives error when using texi2pdf

2020-11-14 Thread Christopher Dimech
Introducing @* in @macro gives error when using texi2pdf.
But using @* works when output to html.

@macro Begof{entity, label, title}

@ifclear NoLabel
   @* @noindent @strong{\entity\ \label\.} @ @emph{\title\}
@end ifclear

@ifset NoLabel
   @* @noindent @strong{\entity\.} @ @emph{\title\}
@end ifset

@end macro

@Begof{Definition, 3.2, Analysis of Signals}





Re: \blacksquare and \square do not work in texi2pdf

2020-11-14 Thread Christopher Dimech
Some have been saying that one can use some latex commands.
What's the story?


> Sent: Saturday, November 14, 2020 at 11:19 AM
> From: "Gavin Smith" 
> To: "Christopher Dimech" 
> Cc: "help-texinfo gnu" , "Patrice Dumas" 
> 
> Subject: Re: \blacksquare and \square do not work in texi2pdf
>
> On Sat, Nov 14, 2020 at 11:07:12AM +0100, Christopher Dimech wrote:
> > Have noticed that \blacksquare and \square give errors when using texi2pdf.
> > The commands word when output is html.
> >
> > The following three commands all fail with texi2pdf
> >
> > @math{\blacksquare \square}
> >
> > @displaymath
> >   \blacksquare \square
> > @end displaymath
> >
> > @tex
> >   $\blacksquare \square$
> >   $$\blacksquare \square$$
> > @end tex
>
> Yes, any LaTeX commands will not work.
>



Re: \blacksquare and \square do not work in texi2pdf

2020-11-14 Thread Gavin Smith
On Sat, Nov 14, 2020 at 11:07:12AM +0100, Christopher Dimech wrote:
> Have noticed that \blacksquare and \square give errors when using texi2pdf.
> The commands word when output is html.
> 
> The following three commands all fail with texi2pdf
> 
> @math{\blacksquare \square}
> 
> @displaymath
>   \blacksquare \square
> @end displaymath
> 
> @tex
>   $\blacksquare \square$
>   $$\blacksquare \square$$
> @end tex

Yes, any LaTeX commands will not work.



\blacksquare and \square do not work in texi2pdf

2020-11-14 Thread Christopher Dimech
Have noticed that \blacksquare and \square give errors when using texi2pdf.
The commands word when output is html.

The following three commands all fail with texi2pdf

@math{\blacksquare \square}

@displaymath
  \blacksquare \square
@end displaymath

@tex
  $\blacksquare \square$
  $$\blacksquare \square$$
@end tex


-
Christopher Dimech
General Administrator - Naiad Informatics - GNU Project (Geocomputation)
- Geophysical Simulation
- Geological Subsurface Mapping
- Disaster Preparedness and Mitigation
- Natural Resource Exploration and Production
- Free Software Advocacy




Macros inside @displaymath

2020-11-14 Thread Gavin Smith
On Thu, Nov 12, 2020 at 01:15:33PM +0100, Patrice Dumas wrote:
> On Thu, Nov 12, 2020 at 11:57:47AM +0100, Christopher Dimech wrote:
> > Have done more tests with @tex, @math, and @displaymath.
> > 
> > \gdef is working for pdf output but not with MathJax.
> 
> I am not an expert in MathJax, but I think that MathJax only interpret
> the LaTeX/TeX locally, so cannot know about \Desig and will only
> interpret LaTeX/TeX "primary" commands.  Maybe there is a possibility to
> give some TeX/LaTeX code to MathJax?  In addition, when outputting html,
> @tex blocks are ignored.

If we could get Texinfo macros (with @macro) working inside @displaymath
blocks these could be used instead.  Then the macro expansion would be
done before MathJax processes the file, so there would no issue with scope.

In another you had the following:

@tex
\def\Exp{\mathop{\rm exp}}
\def\Mod#1{\left| #1 \right|}
\def\Expf#1{\Exp \left[ #1 \right]}
\def\Angf{\omega = 2 \pi \nu}
\def\Gm{\gamma}

\vskip 0.3cm
$\underline{\bf Gaussian\; Function}$

$$ W^G_t(t',\nu)
   = {\Mod{\nu} \over \sqrt{2 \pi}}\; \Expf{-\nu^2 (t-t')^2 \over 2} $$

$$ W^G_t(t',\omega)
   = {1 \over 2 \pi} {\left| \omega \right| \over \sqrt{2 \pi}}\;
  {\rm exp} \left[ {-\omega^2 (t-t')^2 \over 8 \pi^2} \right]
  \,,\quad  \Angf
$$
@end tex

You could change this to:

@macro Exp
\\mathop{\\rm exp}
@end macro

@macro Mod{A}
\\left| \A\ \\right|
@end macro

@macro Expf{A}
\\Exp \\left[ \A\ \\right]
@end macro

@macro Angf
\\omega = 2 \\pi \\nu
@end macro

@macro Gm
\\Gm
@end mao

@subsubheading Gaussian Function

@displaymath
\displaylines{
W^G_t(t',\nu)
   = {@Mod{\nu} \over \sqrt{2 \pi}}\; @Expf{-\nu^2 (t-t')^2 \over 2}\cr
W^G_t(t',\omega)
   = {1 \over 2 \pi} {\left| \omega \right| \over \sqrt{2 \pi}}\;
  {\rm exp} \left[ {-\omega^2 (t-t')^2 \over 8 \pi^2} \right]
  \,,\quad  @Angf\cr
}
@end displaymath

This works perfectly with TeX as far as I can see, but unfortunately
not with texi2any at present.  This could be changed to make
@displaymath more like @example, where Texinfo commands are interpreted,
and less like @verbatim where they are not.