[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-commits
Subject:    quality/apidox/src
From:       Allen Winter <winter () kde ! org>
Date:       2012-04-28 19:36:52
Message-ID: 20120428193652.F0BD8AC89C () svn ! kde ! org
[Download RAW message or body]

SVN commit 1292202 by winterz:

more cleaning and fixing


 M  +32 -10    gendox.sh  


--- trunk/quality/apidox/src/gendox.sh #1292201:1292202
@@ -1,9 +1,9 @@
 #! /bin/bash
-VERBOSE=false
+VERBOSE=1
 VERSION=""
 
 # Read arguments...
-test "x--verbose" = "x$1" && { shift ; VERBOSE=true ; }
+test "x--quiet" = "x$1" && { shift ; VERBOSE=0 ; }
 test "x--version" = "x$1" && { shift ; VERSION="$1" ; shift ; }
 test -z "$VERSION" && { echo "No version given"; exit 1 ; }
 
@@ -26,7 +26,7 @@
 SRCPATH=$SRCPREFIX/$VERSION
 # DOXYHOME: where the doxygen stuff livs
 DOXYHOME=$HOME/kdelibs/doc
-DOXYSH="$DOXYHOME/api/doxygen.sh"
+DOXYSH=$DOXYHOME/api/doxygen.sh
 test -s "$DOXYSH" || { echo "*** NO DOXYGEN.SH" ; exit ; }
 DOXDATAPATH=$DOXYHOME/common
 
@@ -43,8 +43,15 @@
 test -d "$SRCPATH" || { echo "No source path $SRCPATH" ; exit 1 ; }
 cd "$TEMPPATH" || { echo "Cannot cd into $TEMPPATH" ; exit 1 ; }
 
+# Make a nice title
+component=`echo $VERSION | sed s/kde-// | sed s/kde// | sed 's/^[a-z]/\U&/'`
+title="KDE $component API Reference"
+
 # Log it...
-$VERBOSE && echo "* Generating $MODULES"
+if [ $VERBOSE ]; then
+  echo "* Generating APIDOX for $VERSION"
+  echo "* Title \"$title\""
+fi
 
 # Specify url and path to Qt documentation....
 if [ "kde-3.5" = "$VERSION" ]; then
@@ -57,20 +64,30 @@
 
 # Generate the documentation for each module found
 for i in $MODULES; do
+    if [ $VERBOSE ]; then
+      echo "** Generating APIDOX for $SRCPATH/$i"
+    fi
+
     # Cleanup from previous generations....
     rm -rf $TEMPPATH/$i-*
     rm -f $TEMPPATH/$i.tar.gz $TEMPPATH/$i.log
 
     # Make sure the sources for this module exist...
-    test -d "$SRCPATH/$i" || { echo "Skipping $SRCPATH/$i" ; continue ; }
+    test -d "$SRCPATH/$i" || { echo "$SRCPATH/$i does not exist, skipping" ; \
continue ; }  
     # Build the documentation!
     DOXARGS="$SRCPATH/$i"
-    $VERBOSE && echo QTDOCTAG="$QTDOCTAG" sh \""$DOXYSH"\" --installdir=$TEMPPATH \
                --doxdatadir=$DOXDATAPATH --api-searchbox --no-cleanup --preprocess \
                $DOXARGS
-    sh "$DOXYSH" \
+    if [ $VERBOSE ]; then
+      echo ** Running $DOXYSH --installdir=$TEMPPATH \
+	                      --doxdatadir=$DOXDATAPATH \
+                              --title=\""$title"\" \
+                              --api-searchbox --no-cleanup --preprocess \
+                              $DOXARGS
+    fi
+    sh $DOXYSH \
         --installdir=$TEMPPATH \
         --doxdatadir=$DOXDATAPATH \
-        --title="KDE $VERSION API Reference" \
+        --title="$title" \
         --api-searchbox \
         --no-cleanup \
         --preprocess \
@@ -85,8 +102,9 @@
     if [ $VERBOSE ]; then
        AMT=`grep ^$SRCPATH $i.log | wc -l`
        expr 0 + "$AMT" > /dev/null 2>&1 || AMT="0"
-       echo "* Number of errors: $AMT"
-       echo "* Number of applications: " `grep 'Creating apidox' "$i.log" | wc -l`
+       echo "** Number of errors: $AMT"
+       echo "** Number of applications: " `grep 'Creating apidox' "$i.log" | wc -l`
+       echo "** Written to $i.log"
     fi
 
     # clean-up unneeded files
@@ -103,3 +121,7 @@
     rm -f $LOGPATH/$i.log
     mv -f $TEMPPATH/$i.log $LOGPATH
 done
+
+if [ $VERBOSE ]; then
+  echo "* APIDOX Generation complete"
+fi


[prev in list] [next in list] [prev in thread] [next in thread]