[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/