Tree [r11215] / trunk / octave-forge /

File Date Author Commit
admin 2012-10-02 jpicarbajal [r11193] admin: releasePKG using tar and gzip packaged w...
doc 2011-09-14 carandraug [r8530] mention new -forge option of pkg command in the...
extra 2012-10-03 adam78a [r11201] isdicom: Now check for whitespace '\s' rather ...
language 2010-09-26 jmencisom [r7775] Spanish translation help strings with UTF-8 sup...
main 2012-10-07 paramaniac [r11215] control: fix names of state space matrices (tha...
nonfree 2011-12-15 carandraug [r9386] gpc: removal of package since we no longer supp...
packages 2008-04-08 adb014 [r4889] Update make check target for architecture depen...
.svnignore 2007-10-22 adb014 [r4145] Move the cvsignore files to svnignore
AUTHORS 2012-04-16 carandraug [r10236] maint: update e-mail address of Etienne Grossma...
COPYING 2002-11-27 pkienzle [r679] Default to BSD style license so we don't have t...
COPYING.BSD 2002-11-27 pkienzle [r679] Default to BSD style license so we don't have t...
COPYING.GPL 2008-02-04 adb014 [r4585] More copyright updates
ChangeLog 2009-06-07 hauberg [r5910] R2009-06-07 release
README 2009-06-07 hauberg [r5907] Updated for the new release
TODO 2010-03-05 hauberg [r7000] Remove redundant task from TODO
texinfo.tex 2008-02-04 adb014 [r4585] More copyright updates

Read Me

*** README is automatically generated from admin/template.readme ***

The octave-forge project contains functions for Octave which are not in
the main distribution.  While the main Octave distribution is
conservative about accepting new functions and changes, octave-forge is
very open.  As a result, be prepared for some lower quality code and
more rapidly changing interfaces to the functions in octave-forge.

The collection is in the public domain, but the individual functions
vary.  See COPYING for details.  See INSTALL for installation

Octave needs your support!  Please donate to the University of
Wisconsin Foundation:

designated as follows:

   I/we wish to support ongoing development of the Octave modelling
   language, under the supervision of Professor James B. Rawlings and
   Dr. John W. Eaton of the Department of Chemical and Biological 
   Engineering at the University of Wisconsin-Madison.

Donations are tax deductible in the United States.  A donation of $10/user
per year at current estimates of the user base would support two developers.
Adjust as appropriate for the percentage of users that you think will donate.

Project organization

	Contains files and scripts used to administer the octave-forge
	website and build the release files.  Nothing in here is needed
	by octave-forge users.

	Documentation for octave in general.  Documentation for specific
	packages goes into the doc/ subdirectory of the individual package 
	directories. This directory also contains the automatically built
	html code for the website.

	Packages which:
	   * are too narrow in scope for main/, or
	   * act as alternatives for functions in main/, or
	   * do not follow octave conventions (because they want
	     to retain compatibility with matlab for example), or
	   * are primarily developed elsewhere, or
	   * require patches to Octave, or
	   * are designed for older versions of Octave, or
	   * haven't been tested enough.

	Packages that supply translations of core Octave functions and 
	Octave-Forge packages. The directory base/template/ contains example
	code to and the directory base/help the original text of the functions
	to translate.

	Packages which may eventually be included in the main octave 
	distribution.  As such, they should follow Octave conventions.  
	The octave-forge SVN tree should be the primary development/release 
	site.  All functions should work with the latest Octave 
	interpreter without any special compilation switches or patches

	Packages which are not freely modifiable and redistributable 
	with modifications, or which depend on code which is not 
	free.  This includes functions which only permit non-commercial 
	use and functions which must be kept together as a package.  
	Functions in all other directories must be freely redistributable 
	with modifications.  Functions in non-free must be freely 
	redistributable for non-commercial use.  Functions of unknown
	license should not be included anywhere, since no license implies
	default license implies no rights to redistribute.

	This is the target directory, where the source packages are placed. It
	is also the directory where the test code is run for each of the
	packages and where the source RPMs are automatically built. There
	should be no reason for the user to add files to this directory

Package organization

	This is an optional file, whose presence tells octave-forge
	that this package should be ignored. This is typically for
	packages that are kept for historical reasons.
	This is a required file containing information about the
	This is a required containing the license of the package.
	This is an optional file describing the functions provided by
	the package.
	An optional file that includes commands that are run when the
        package is added to the users path.
	An optional file that includes commands that are run when the
        package is removed from the users path.
	This is an optional file that is for the use of Octave-Forge
	This is an optional script that is run prior to the
        installation of a package.
	This is an optional script that is run after the
        installation of a package.
	This is an optional script that is run prior to the
        de-installation of a package.
	An optional directory containing documentation for the
	An optional directory containing any files that are directly
	installed by package.
	An optional directory containing files that will be added to
	the Octave EXEC_PATH when the package is loaded.
	An optional directory containing code that must be 'built' prior
	to the packages installation.

Administrative files
	Generates ./configure and

	Basic configuration checks, such as locating the install paths,
	and the associated variables to be put into Makeconf.

	License for the collection

	The text of the GPL license

	This file

	Things that could/should be done

	Installation instructions

	Top level makefile
	Generates release tarball

Compatibility Issues

Issue the following command:
	$ grep -d skip "XXX COMPATIBILITY XXX" */* */*/*
for a list of compatibility issues in various functions.  As of this
writing, mu2lin is a likely cause of problems when porting audio

Paul Kienzle
March 17, 2002