% $Date: 2003/09/15 16:37:45 $ $Author: nthiery $ $Revision: 1.1.1.1 $

\begin{Mhelppage}{MultPerm}{V. Prosper}%
  \begin{MInfo}
    \eng{multiply permutations}
  \end{MInfo}
  
\begin{MCalls}
  \Mcall{perm1,perm2}
\end{MCalls}

\begin{MParameters}
  \param{perm1, perm2}
  \eng{any lists denoting permutations}
\end{MParameters}

\begin{MIntro}
  \eng{

The {\Mthis} function calculates the product of a sequence (of arbitrary
length) of permutations.

\Mex{{\Mthis}(perm1, perm2)} computes \Mex{perm1(perm2)}.

Permutations need not to belong to the same symmetric group:
\Mmath{Sn}{S_n} is embedded into \Mmath{Sn+1}{S_{n+1}} by adding the
fixed point \Mmath{n+1}{n+1}.
}
\end{MIntro}

\begin{MExample}{ex1}
\begin{Mexin}
muEC::SG::MultPerm( [1,3,2], [2,3,1] );
\end{Mexin}
\begin{Mexout}
                           [3, 2, 1]
\end{Mexout}
\begin{Mexin}
muEC::SG::MultPerm( [1,3,2], [2,3,1], [1,3,2,4] );
\end{Mexin}
\begin{Mexout}
                         [3, 1, 2, 4]
\end{Mexout}
\end{MExample}

\MRelatedFunctions{IsPerm}
\end{Mhelppage}
