# HG changeset patch # User Markus Mützel # Date 1613408941 -3600 # Mon Feb 15 18:09:01 2021 +0100 # Branch stable # Node ID 6c456d5c00ab38ad3d5628a53438d536ac9636c8 # Parent fd1c45b62ba99b615af99e317c2ff401a89b7be2 doc: Clarify usage of "Depends" keyword in package DESCRIPTION file (bug #60053). * doc/interpreter/package.txi (The DESCRIPTION File): Clarify that ranges for package version can be specified and that Octave core versions can be required. diff -r fd1c45b62ba9 -r 6c456d5c00ab doc/interpreter/package.txi --- a/doc/interpreter/package.txi Sun Feb 14 22:48:19 2021 +0100 +++ b/doc/interpreter/package.txi Mon Feb 15 18:09:01 2021 +0100 @@ -391,18 +391,30 @@ Optional list of homepages related to the package. @item Depends -A list of other Octave packages that this package depends on. This can -include dependencies on particular versions, with a format +A list of other Octave packages that this package depends on. This can include +dependencies on particular versions, with the following format: @example Depends: package (>= 1.0.0) @end example @noindent -Possible operators are @code{<}, @code{<=}, @code{==}, @code{>=} or -@code{>}. If the part of the dependency in @code{()} is missing, any -version of the package is acceptable. Multiple dependencies can be -defined as a comma separated list. +Possible operators are @code{<}, @code{<=}, @code{==}, @code{>=} or @code{>}. +If the part of the dependency in @code{()} is missing, any version of the +package is acceptable. Multiple dependencies can be defined as a comma +separated list. This can be used to define a range of versions of a particular +package: + +@example +Depends: package (>= 1.0.0), package (< 1.5.0) +@end example + +@noindent +It is also possible to depend on particular versions of Octave core: + +@example +Depends: octave (>= 3.8.0) +@end example @item License An optional short description of the used license (e.g., GPL version 3