Ticket #1: ddoc_format.sh

#!/bin/bash

SRCDIR="`pwd`/src"

function ParseFile()
{
    echo "Parsing: $1"

    #Convert non-Doxygen comments to DDoc format.
    sed -ri -e '/\/\*\*/,/\*\// { /Returns:/ !{ /\* [[:alnum:]_]*:$/ { N; s/\*\//&/; t; s/:/ = /; s/\n[[:blank:]]*\*[[:blank:]]*//; } 
                                                /\* [[:alnum:]_]*:.*$/ { s/:/ =/ } } }' \
            -e '/\/\*\*/,/\*\// { /Returns:$/ { N; s/\n[[:blank:]]*\*[[:blank:]]*/ / } }' "$1"
    #TODO: remove "self" arguments.
    
    #Convert Doxygen comments to DDoc format.
    sed -ri -e '/\/\*\*/,/\*\// { s/@return/Returns:/ }' \
            -e '/\/\*\*/,/\*\// { /^.*@param.*$/ { s/@param //; s/ [[:alnum:]_]* /&= / } }' "$1"

    #Add "Params:" before DDoc function parameter lists.
    #sed -ri -e '/\/\*\*/,/\*\// { x; s/\n/&/; t e; x; s/ = /&/; T; h; H; g; s/[[:alnum:]_]* =.*\n/Params:\n/; b; :e; x; }' "$1"
    sed -ri -e '/\/\*\*/ { s/\*\//&/; t; :skip; n; s/\*\//&/; t; s/ = /&/; T skip; h; H; g; s/[[:alnum:]_]* =.*\n/Params:\n/; }' "$1"
}

function ScanDir()
{
    local previousdir="`pwd`"

    cd "$1"
    for entry in $( ls -b ); do
        if [ -f "${entry}" ]; then
            ParseFile "$1"/"${entry}"
        elif [ -d "${entry}" ]; then
            ScanDir "$1"/"${entry}"
        fi
    done

    cd "${previousdir}"
}

echo
echo "The following script will parse all your D source files and"
echo "hopefully format them according to the DDoc specification."
echo "NO backups will be made. You now have 5 seconds to abort."
sleep 5
echo
echo "Source directory: ${SRCDIR}"
echo

ScanDir "${SRCDIR}"

echo "Done!"