Revision history for Rinci

1.1.7    2012-02-23

         + package: Add property 'pkg_version'.


1.1.6    2012-02-21

         + function: Add 'alias_for' argument specification.


1.1.5    2012-02-10

         No spec changes.

         + Add Rinci::Schema.


1.1.4    2012-02-01

         + Declare that 1.1 series might introduce minor backward compatibility
           problems between revisions.

         + Rename 'arg_pass_style' and 'result_envelope' to the old
           (Sub::Spec-era) 'args_as' and 'result_naked'. New names are not
           better.

         + Code entity URI now moved to Riap specification as the 'riap' URI
           scheme.

         + Some minor revisions.


1.1.3    2012-01-27

         + Change syntax of code entity URI, from 'Pkg.SubPkg.func' to
           'pm:/Pkg/SubPkg/func' (or 'py:', 'php:', and so on).

         + Some minor revisions like wording and paragraph reorganization.


1.1.2    2012-01-19

         + Add 'default_lang' property. Add guidelines on what to put in 'summary'
           and 'description'.

         + variable: Add 'schema' property.


1.1.1    2012-01-18

         No spec changes. Update module names (Rinci::HTTP -> Riap, Rias ->
         Perinci). Add documents Rinci::Upgrading and Rinci::Tutorial (stub).


1.1.0    2012-01-15

         First release. Spun off from Sub::Spec.

         Incompatible differences with Sub::Spec 1.0.x:

         + Terminology: 'spec clause' becomes 'property'. This is to avoid
           confusion with 'clause' as used in Sah schema language.

         + Default text markup format changed from Org to Markdown, but a new
           properties 'text_markup' is added to allow specifying 'org' or
           'markdown' (or 'none').

         + 'v' clause is now required to declare Rinci spec version (with value
           1.1, if unspecified then assumed spec is old Sub::Spec 1.0).

         + function: Incompatible changes to 'args' and 'result' properties;
           'args' is now a hash of arg names and arg *specs* (instead of arg
           schemas). 'result' is now a hash of data, instead of schema. The
           purpose is to keep Sah schema clean from custom, non-schema-related
           schema clauses, like arg_* (thus requiring custom Sah extensions,
           etc). Mixing them into schemas was not the right way.

         + function: property 'type' removed, replaced with 'is_func',
           'is_meth', 'is_static_meth'. This is because a single
           subroutine/function can act as all.

         + function: Other properties which are also removed/replaced: 'timeout'
           (non-core), 'retry' (non-core), 'scope' (can be replaced by using
           tags), 'result_naked' (replaced by 'result_envelope'), 'args_as'
           (replaced by 'arg_pass_style').

         + function: property 'deps': terminology change ('dep clause' -> 'dep
           type'), rename dep types: 'sub' -> 'func', 'mod' -> 'perl_module'.

         Additions:

         + Keys beginning with "_" are allowed and ignored. This can be used to
           store extra information.

         + New properties: 'tags', 'links', 'examples'.
