debian man page for reverse

REVERSE(3)						       MBK UTILITY FUNCTIONS							REVERSE(3)

NAME
       reverse - reverse a list of chained elements

ORIGIN
       This  software  belongs	to  the  ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
       Paris, France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr

SYNOPSYS
       #include "mut.h"
       chain_list *reverse(ptold)
       chain_list *ptold;

PARAMETER
       ptold		   Pointer to a chain_list to be reversed

DESCRIPTION
       The reverse function allows to reverse the order of the elements of a chain_list. It means that the last element becomes the first one, the
       one before the last one the second one, and so on.

       remark :
	      all  mbk	structures have for first field the NEXT field, so, with appropriate cast, one can reverse any mbk list. Let's notice that
	      nothing in the C language description demands a structure to be defined in memory the same way its members are defined in C. But all
	      compiler do it this way now a day.  Let's hope it will continue!

RETURN VALUE
       reverse returns a pointer to the head of the reversed list.

EXAMPLE
       #include "mut.h"
       void reverse_con(p)
       lofig_list *p;
       {
	  p->LOCON = (locon_list *)reverse((chain_list *)p->LOCON);
       }

SEE ALSO
       mbk(1), chain(3).

BUG REPORT
       This tool is under development at the ASIM department of the LIP6 laboratory.
       We need your feedback to improve documentation and tools.

ASIM
/LIP6							  October 1, 1997							REVERSE(3)