• marko's avatar
    branches/zip: Convert the function comments to Doxygen format. · e49dee37
    marko authored
    This patch was created by running the following commands:
    
    for i in */*[ch]; do doxygenify.pl $i; done
    perl -i -pe 's#\*{3} \*/$#****/#' */*[ch]
    
    where doxygenify.pl is
    https://svn.innodb.com/svn/misc/trunk/tools/doxygenify.pl r510
    
    Verified the consistency as follows:
    
    (0) not too many /* in: */ or /* out: */ comments left in the code:
    grep -l '/\*\s*\(in\|out\)[,:/]' */*[ch]
    
    (1) no difference when ignoring blank lines, after stripping all
    C90-style /* comments */, including multi-line ones, before and after
    applying this patch:
    
    perl -i -e 'undef $/;while(<ARGV>){s#/\*(.*?)\*/##gs;print}' */*[ch]
    diff -I'^\s*$' --exclude .svn -ru TREE1 TREE2
    
    (2) after stripping @return comments and !<, generated a diff and omitted
    the hunks where /* out: */ function return comments were removed:
    
    perl -i -e'undef $/;while(<ARGV>){s#!<##g;s#\n\@return\t.*?\*/# \*/#gs;print}'\
     */*[ch]
    svn diff|
    perl -e 'undef $/;$_=<>;s#\n-\s*/\* out[:,]([^\n]*?)(\n-[^\n]*?)*\*/##gs;print'
    
    Some unintended changes were left.  These will be removed in a
    subsequent patch.
    e49dee37
ut0vec.ic 2.36 KB