doc srfi-1 partition

[Kevin Ryde]

        * srfi-modules.texi (SRFI-1 Filtering and Partitioning): For partition
        and partition!, emphasise the multi-value return, note partition may
        share a tail with the given list.

 - Scheme Procedure: partition pred lst
 - Scheme Procedure: partition! pred lst
     Split LST into those elements which do and don't satisfy the
     predicate PRED.

     The return is two values (*note Multiple Values::), the first
     being a list of all elements from LST which satisfy PRED, the
     second a list of those which do not.

     The elements in the result lists are in the same order as in LST.
     The order in which the calls `(PRED elem)' are made on the list
     elements is not specified.

     `partition' does not change LST, but one of the returned lists may
     share a tail with it.  `partition!' may modify LST to construct
     its return.