gnuplot-beta

How to generate <ul> & <li> or \begin{itemize} in documentation?

[Mojca M. <moj...@gm...>]

Dear list,

What is the syntax in help for terminals that would generate
<ul><li>...</li>...</ul> syntax in HTML output, \begin{itemize} in
LaTeX (PDF documentation) and a normal "-" in text mode?

Also, how could one replace TeX with \TeX in gnuplot.tex that is used
to generate gnuplot.doc?

Thank you,
   Mojca

Re: How to generate <ul> & <li> or \begin{itemize} in documentation?

[Ethan A M. <eam...@gm...>]

On Sunday, 11 September 2011, Mojca Miklavec wrote:
> Dear list,
> 
> What is the syntax in help for terminals that would generate
> <ul><li>...</li>...</ul> syntax in HTML output, \begin{itemize} in
> LaTeX (PDF documentation) and a normal "-" in text mode?

.../docs/README  explains the format of gnuplot.doc
But there is no provision for bulleted lists.  I agree with you that
it would be useful, but it would have to be added to all of the 
various doc2XXX.c conversion programs.

> Also, how could one replace TeX with \TeX in gnuplot.tex that is used
> to generate gnuplot.doc?

??
That's backwards.  gnuplot.doc is used to generate gnuplot.tex.
I suppose you could add a search-and-replace filter in doc2tex.c,
but it would probably be simpler to run sed 's/ TeX/ \\TeX/' on
the output. You could add it as an extra line in the Makefile rule
for gnuplot.tex

	Ethan

-- 
Tradition is not the worship of ashes, but the preservation of fire.
  - Gustav Mahler

Re: How to generate <ul> & <li> or \begin{itemize} in documentation?

[Mojca M. <moj...@gm...>]

On Sun, Sep 11, 2011 at 22:47, Ethan A Merritt wrote:
> On Sunday, 11 September 2011, Mojca Miklavec wrote:
>> Dear list,
>>
>> What is the syntax in help for terminals that would generate
>> <ul><li>...</li>...</ul> syntax in HTML output, \begin{itemize} in
>> LaTeX (PDF documentation) and a normal "-" in text mode?
>
> .../docs/README  explains the format of gnuplot.doc
> But there is no provision for bulleted lists.  I agree with you that
> it would be useful, but it would have to be added to all of the
> various doc2XXX.c conversion programs.

I now rewrote term_help, so that it doesn't need bullets any more.

But I can take a look into coding this if there is interest.

>> Also, how could one replace TeX with \TeX in gnuplot.tex that is used
>> to generate gnuplot.doc?
>
> ??
> That's backwards.

I'm sorry. I meant "that is used to generate gnuplot.pdf".

> gnuplot.doc is used to generate gnuplot.tex.
> I suppose you could add a search-and-replace filter in doc2tex.c,

That would probably be an overkill. I guess that *.el scripts are
written in lisp for exactly the same reason: to complex to code in
plain C.

> but it would probably be simpler to run sed 's/ TeX/ \\TeX/' on
> the output. You could add it as an extra line in the Makefile rule
> for gnuplot.tex

That probably makes more sense. I will try if I can figure out how and
where to apply this. I will ask again if I will need help.

Mojca