+++ /dev/null
-#!/usr/bin/php
-<?php
-/**
- * @file util/createdoxygen.php
- * @brief Adds a doxygen header to functions
- */
-
-if (count($_SERVER["argv"]) < 2)
- die("usage: createdoxygen.php file\n");
-
-$file = $_SERVER["argv"][1];
-$data = file_get_contents($file);
-
-$lines = explode("\n", $data);
-
-$previous = "";
-
-foreach ($lines AS $line) {
- $line = rtrim(trim($line, "\r"));
-
- if (strstr(strtolower($line), "function")) {
- $detect = strtolower(trim($line));
- $detect = implode(" ", explode(" ", $detect));
-
- $found = false;
-
- if (substr($detect, 0, 9) == "function ")
- $found = true;
-
- if (substr($detect, 0, 17) == "private function ")
- $found = true;
-
- if (substr($detect, 0, 23) == "public static function ")
- $found = true;
-
- if (substr($detect, 0, 10) == "function (")
- $found = false;
-
- if ($found and (trim($previous) == "*/"))
- $found = false;
-
- if ($found and !strstr($detect, "{"))
- $found = false;
-
- if ($found) {
- echo add_documentation($line);
- }
- }
- echo $line."\n";
- $previous = $line;
-}
-
-/**
- * @brief Adds a doxygen header
- *
- * @param string $line The current line of the document
- *
- * @return string added doxygen header
- */
-function add_documentation($line) {
-
- $trimmed = ltrim($line);
- $length = strlen($line) - strlen($trimmed);
- $space = substr($line, 0, $length);
-
- $block = $space."/**\n".
- $space." * @brief \n".
- $space." *\n"; /**/
-
-
- $left = strpos($line, "(");
- $line = substr($line, $left + 1);
-
- $right = strpos($line, ")");
- $line = trim(substr($line, 0, $right));
-
- if ($line != "") {
- $parameters = explode(",", $line);
- foreach ($parameters AS $parameter) {
- $parameter = trim($parameter);
- $splitted = explode("=", $parameter);
-
- $block .= $space." * @param ".trim($splitted[0], "& ")."\n";
- }
- if (count($parameters) > 0)
- $block .= $space." *\n";
- }
-
- $block .= $space." * @return \n".
- $space." */\n";
-
- return $block;
-}