Mercurial > octave
view libinterp/gendoc.pl @ 22761:708a4fcb7382 stable release-4-2-0
Version 4.2.0 released.
* configure.ac: Bump version to 4.2.0.
(OCTAVE_PATCH_VERSION): Set to 0.
(OCTAVE_RELEASE_DATE): Update.
author | John W. Eaton <jwe@octave.org> |
---|---|
date | Sun, 13 Nov 2016 10:20:59 -0500 |
parents | bac0d6f07a3e |
children | 3a2b891d0b33 e9a0469dedd9 |
line wrap: on
line source
#! /usr/bin/perl -w # # Copyright (C) 2012-2016 Rik Wehbring # # This file is part of Octave. # # Octave is free software; you can redistribute it and/or modify it # under the terms of the GNU General Public License as published by the # Free Software Foundation; either version 3 of the License, or (at # your option) any later version. # # Octave is distributed in the hope that it will be useful, but WITHOUT # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or # FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License # for more details. # # You should have received a copy of the GNU General Public License # along with Octave; see the file COPYING. If not, see # <http://www.gnu.org/licenses/>. unless (@ARGV > 1) { die "Usage: $0 SRCDIR src-file1 ..." } $srcdir = shift (@ARGV); print <<__END_OF_MSG__; ### DO NOT EDIT! ### ### This file is generated automatically from Octave source files. ### Edit source files directly and run make to update this file. __END_OF_MSG__ FILE: foreach $fname (@ARGV) { if (-f "$fname") { $src_fname = "$fname"; } else { $src_fname = "$srcdir/$fname"; } open (SRC_FH, $src_fname) or die "Unable to open $src_fname"; @func_list = (); @docstr = (); LINE: while (<SRC_FH>) { if (/^\s*DEF(?:CONSTFUN|UN|UN_DLD|UNX|UNX_DLD)\s*\(/) { ($func) = /\("?(\w+)"?,/; unless ($func) { die "Unable to parse $src_fname at line $.\n" } push (@func_list, $func); if (<SRC_FH> =~ m#\s*doc:\s+\Q/*\E\s+\Q-*- texinfo -*-\E\s*$#) { $str = "-*- texinfo -*-\n"; $reading_docstring = 1; } else { print STDERR "gendoc.pl: undocumented function $func from $fname\n"; push (@docstr, "Undocumented."); } } elsif ($reading_docstring) { if (/^.*\s+\*\/\s*\)\s*$/) { s#\s+\*/\s*\)\s*$##; push (@docstr, $str . $_); $reading_docstring = 0; } else { $str .= $_; } } } close (SRC_FH); ## Print results in DOCSTRING format foreach $i (0 .. $#func_list) { $func = $func_list[$i]; print "\x{1d}$func\n"; print "\@c $func $fname\n"; print $docstr[$i],"\n"; } }