[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: first_sentence_texinfo
From: |
Carnë Draug |
Subject: |
Re: first_sentence_texinfo |
Date: |
Fri, 10 Apr 2015 18:26:15 +0100 |
On 10 April 2015 at 18:12, Kozma, Endre <address@hidden> wrote:
> Working on the next revision of the ngspice package I continuously suffer
> from makeinfo warnings. I tracked down the cause of the issue and I
> concluded the following:
>
> 1. The warnings are caused by the nested @deftypefn structures in one of my
> oct-files (I need to document some callback prototypes and I do it in this
> way).
> 2. The real problem however lays in the first_sentence_texinfo () function
> (get_first_help_sentence.m). Namely it removes all @def... lines but not all
> @end def... ones, but it removes everything from the first @end def.. line
> to the end of the help text potentially making erroneous texinfo data by
> that.
>
> My question is: if we simply remove all @def.. lines why don't we remove
> similarly all @end def.. lines? By this we'd end up having a valid texinfo
> data (assumed the original help text was valid) which wouldn't cause
> makeinfo warnings.
Why are you nesting deftypefn in the first place? I thought that was just
invalid syntax. I think you have to end one and then start another. See
for example the help text of gallery [1]. I believe this creates perfectly
valid texinfo data.
Carnë
[1]
http://hg.savannah.gnu.org/hgweb/octave/file/b34a23c8a9c4/scripts/special-matrix/gallery.m