[Octave-bug-tracker] [bug #63141] Octave shows warning on texinfo doc functions with more than one @seealso

[Markus Mützel]

Follow-up Comment #3, bug #63141 (project octave):

Hmm. Reading the comments in the code, I'd guess that this part of the
generating script is supposed to combine multiple @seealso lines:
https://hg.savannah.gnu.org/hgweb/octave/file/de6fc38c78c6/doc/interpreter/mk-doc-cache.pl#l81

          ## Change @seealso to private @xseealso macro
          if ($line =~ m'@seealso')
          {
            ## Combine @seealso macro spread over multiple lines
            while ($line !~ m/}$/) {  $line .= <$FH>;  }

            ## escape @ characters in old-style class names like @ftp
            $line =~ s/\@(\w)/\@\@$1/g;
            $line =~ s'@@seealso'@xseealso';
          }


But tbh, my Perl is close to non-existent. So, I don't really know what those
commands do...
Maybe, it's meant to collect arguments that span over multiple lines?
Does something like the following work?

@seealso{mytest1,
         mytest2}




    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?63141>

_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/