Octave-Forge: Difference between revisions

From Octave
Jump to navigation Jump to search
(Fixed octave prompt for installing packages)
m (Avoid double redirect.)
Tag: Redirect target changed
 
(56 intermediate revisions by 17 users not shown)
Line 1: Line 1:
Octave-Forge (http://octave.sf.net) is a community project for collaborative development of GNU Octave extensions. If you have a large package that you want to open up to collaborative development, or a couple of m-files that you want to contribute to an existing package, Octave-Forge is the place to do it. Tiny helper functions (the equivalent of e.g., shell aliases) should go in the [[Tips and tricks]] page.
#REDIRECT [[Category:Octave Forge]]
 
GNU Octave also needs the equivalent of CPAN so that packages such as epstk which have been developed elsewhere can be archived. [http://agora.panocha.org.mx Agora Octave] is a fledgeling proposal to do that (talk to [[User:JordiGH|JordiGH]] about it). Before that is possible we need a packaging system which works for both Octave and Matlab (and maybe Scilab if you are feeling ambitious) without too much work on the either the developers or the users end, even for users working in a tool desert such as Windows. Feel free to expand on the definition of such a system on this page.
 
== Installing packages ==
You can find the list of packages on the [http://octave.sourceforge.net/packages.php Octave-Forge website]. To install a package, download the package file, and install it from the GNU Octave prompt by typing:
 
  octave> pkg install package_file_name.tar.gz
 
Since Octave 3.4, it is possible to download and install Octave-Forge packages from the prompt with the '''-forge''' flag:
 
  octave> pkg install -forge package_name
 
== Contributing via the Agora website ==
'''<span style="color:#FF0000;">This is work in progress.</span>'''
 
You can upload your code to [http://agora.octave.org/ Agora]. The code is classified according the following criteria.
 
* Single file
:: The file is full responsibility of the uploader.
:: Octave and Agora do not check or support this submissions.
 
* Bundle of files
:: The file(s) is(are) full responsibility of the uploader.
:: The bundle passes a structure check to see if it is compatible with the builtin Octave installer. This doesn't mean the bundle with install  flawlessly.
:: Octave and Agora do not check or support this submissions.
 
* Forge
:: The file(s) is(are) responsibility of its maintainer and the Agora maintainers community.
:: This package will install using the builtin Octave installer.
 
 
[[File:agora.png|center|380px]]
 
The Forge packages have must comply with
* At least one package maintainer.
* Must install and work with the latest Octave release.
* The must be released under a [http://en.wikipedia.org/wiki/List_of_FSF-approved_software_licenses GPL compatible] license.
* All functions (except private ones) must be documented using [http://en.wikipedia.org/wiki/Texinfo Texinfo].
* The package must have all the [http://www.gnu.org/software/octave/doc/interpreter/Creating-Packages.html#Creating-Packages required files].
* If the package has a doc folder it should be written in [http://en.wikipedia.org/wiki/Texinfo Texinfo].
 
These packages are also recommended to comply with
* No shadowing of Octave core functions.
* No direct inclusion of external dependencies.
 
== Suggested new features ==
 
* Install directory
* Install from URL
* Build HTML / PDF docs
 
== See also ==
 
* [[Creating packages]]
 
[[Category:OctaveForge]]

Latest revision as of 05:34, 28 August 2019