octave-bug-tracker
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Octave-bug-tracker] [bug #47480] io package relies on deprecated octave


From: Carnë Draug
Subject: [Octave-bug-tracker] [bug #47480] io package relies on deprecated octave_config_info
Date: Wed, 23 Mar 2016 16:29:09 +0000
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Firefox/38.0 Iceweasel/38.7.1

Follow-up Comment #5, bug #47480 (project octave):

> Why does _io_init_.m (or _enter_io_package_.m) and _io_exit_.m need a
texinfo header at all? 

For the same reason all private functions in octave have a texinfo.  They
usually only have one line saying that it's a private undocumented function.
If you don't have it, you will get a warning.  Users will always know about
the function. It's in their workspace afterall. Better to have help text
reminding them it's private and undocumented than nothing at all.

> But I would like to avoid the texinfo show up in the generated doc-cache; no
user should ever run it nor even know about it. So better no mention of it
anywhere. Does the texinfo show up anywwhere in the io package's
documentation?
> A mere plain text line with "undocumented" or so would do IMO. 

Even if you have a single line of plain text, it will appear on the doc-cache
file. If you don't want it to appear in the list of functions, simply omit it
from the INDEX file.

> As to the GPL license text, fine. 

You will need a license header in all files with code.  That it was absent in
the PKG_ADD file could be an issue. Please remove my name from it if that's
the issue.

    _______________________________________________________

Reply to this item at:

  <http://savannah.gnu.org/bugs/?47480>

_______________________________________________
  Message sent via/by Savannah
  http://savannah.gnu.org/




reply via email to

[Prev in Thread] Current Thread [Next in Thread]