octave-maintainers
[Top][All Lists]
Advanced

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

OF package maintainers: online duplicate checker available


From: Olaf Till
Subject: OF package maintainers: online duplicate checker available
Date: Sun, 26 Feb 2017 10:11:24 +0100
User-agent: Mutt/1.5.23 (2014-03-12)

Dear package maintainers,

a web interface is now available to check for duplicate symbols over
Octave Forge packages and Octave. It is accessed with the frontend
function 'check_duplicates()' of the recent generate_html package
(version 0.2.0). Note that some duplications correspond to intended
overwrites.

You are encouraged to check for inadvertent symbol duplications
introduced by your package before submitting a new release.

Duplications are checked among function names, class base names (not
class method names), and namespace names (not namespaced functions)
together. There are reasons even to avoid inadvertent clashes of
namespace names and class basenames.

To make the check able to consider class basenames and namespace
names, this information has to be available online for your
package. This needs the html docs of your package to be generated with
a recent version (>= 0.2.0) of generate_html. If you have classes
and/or namespaces in your package, you may consider re-generating and
re-submitting the html docs even before your next package
release. This will have the side effect of making your class methods
and namespaced functions visible in the online lists of functions at
OF.

To make generate_html-0.2.0 work with namespaced functions and with
new style classes, an INDEX file must be provided. Class methods, both
of old and new style classes, should be listed in INDEX like:

 @basename/method

Namespaced functions should be listed in INDEX like:

 namespace.function

(without a '+' before namespace).

Olaf

-- 
public key id EAFE0591, e.g. on x-hkp://pool.sks-keyservers.net

Attachment: signature.asc
Description: Digital signature


reply via email to

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