| epoger@google.com | b0c5e07 | 2011-12-06 14:52:38 +0000 | [diff] [blame] | 1 | #!/bin/bash |
| 2 | # |
| epoger@google.com | 338ef65 | 2011-12-07 18:52:40 +0000 | [diff] [blame] | 3 | # Runs doxygen and stores its results in the skia-autogen repo, so that they |
| 4 | # can be browsed at http://skia-autogen.googlecode.com/svn/docs/html/index.html |
| rmistry@google.com | bcf0c52 | 2012-07-09 20:53:03 +0000 | [diff] [blame] | 5 | # |
| 6 | # The DOXYGEN_TEMPDIR env variable is the working directory within which we will |
| 7 | # check out the code, generate documentation, and store the doxygen log |
| 8 | # (by default, /tmp/skia-doxygen). The DOXYGEN_COMMIT env variable determines |
| 9 | # whether docs should be commited (true by default). |
| 10 | # |
| 11 | # Sample Usage: |
| 12 | # export DOXYGEN_TEMPDIR=/tmp/doxygen |
| 13 | # export DOXYGEN_COMMIT=false |
| 14 | # bash update-doxygen.sh |
| epoger@google.com | b0c5e07 | 2011-12-06 14:52:38 +0000 | [diff] [blame] | 15 | |
| 16 | # Prepare a temporary dir and check out Skia trunk and docs. |
| 17 | cd |
| rmistry@google.com | bcf0c52 | 2012-07-09 20:53:03 +0000 | [diff] [blame] | 18 | DOXYGEN_TEMPDIR=${DOXYGEN_TEMPDIR:-/tmp/skia-doxygen} |
| 19 | DOXYGEN_COMMIT=${DOXYGEN_COMMIT:-true} |
| 20 | |
| rmistry@google.com | bcf0c52 | 2012-07-09 20:53:03 +0000 | [diff] [blame] | 21 | mkdir -p $DOXYGEN_TEMPDIR |
| 22 | cd $DOXYGEN_TEMPDIR |
| rmistry@google.com | a8a977a | 2012-07-17 18:27:03 +0000 | [diff] [blame] | 23 | |
| 24 | if [ -d "trunk" ]; then |
| 25 | svn update --accept theirs-full trunk |
| 26 | else |
| 27 | svn checkout http://skia.googlecode.com/svn/trunk # read-only |
| 28 | fi |
| 29 | if [ -d "docs" ]; then |
| 30 | svn update --accept theirs-full docs |
| 31 | else |
| 32 | svn checkout https://skia-autogen.googlecode.com/svn/docs # writeable |
| borenet@google.com | 72e3403 | 2012-09-26 16:09:43 +0000 | [diff] [blame] | 33 | if [ ! -f "docs/static_footer.txt" ]; then |
| borenet@google.com | 71f0f8e | 2012-09-26 16:25:22 +0000 | [diff] [blame] | 34 | cp trunk/tools/doxygen_footer.txt docs/static_footer.txt |
| borenet@google.com | 72e3403 | 2012-09-26 16:09:43 +0000 | [diff] [blame] | 35 | fi |
| rmistry@google.com | a8a977a | 2012-07-17 18:27:03 +0000 | [diff] [blame] | 36 | fi |
| epoger@google.com | b0c5e07 | 2011-12-06 14:52:38 +0000 | [diff] [blame] | 37 | |
| 38 | # Run Doxygen. |
| 39 | cd trunk |
| 40 | doxygen Doxyfile |
| rmistry@google.com | 0032407 | 2012-08-24 17:16:05 +0000 | [diff] [blame] | 41 | ret_code=$? |
| 42 | if [ $ret_code != 0 ]; then |
| 43 | echo "Error while executing Doxygen command" |
| 44 | exit $ret_code |
| 45 | fi |
| 46 | |
| epoger@google.com | b0c5e07 | 2011-12-06 14:52:38 +0000 | [diff] [blame] | 47 | cd ../docs |
| 48 | |
| 49 | # Add any newly created files to Subversion. |
| 50 | NEWFILES=$(svn status | grep ^\? | awk '{print $2}') |
| 51 | if [ -n "$NEWFILES" ]; then |
| 52 | svn add $NEWFILES |
| 53 | fi |
| 54 | |
| 55 | # We haven't updated the timestamp footer yet... if there are no changes |
| 56 | # yet, just exit. (We'll wait until there are any actual doc changes before |
| 57 | # updating the timestamp and committing changes to the repository.) |
| 58 | MODFILES=$(svn status | grep ^[AM]) |
| 59 | if [ -z "$MODFILES" ]; then |
| 60 | echo "No documentation updates, exiting early." |
| 61 | exit 0 |
| 62 | fi |
| 63 | |
| 64 | # Update the timestamp footer. |
| 65 | cat >iframe_footer.html <<EOF |
| 66 | <html><body> |
| 67 | <address style="text-align: right;"><small> |
| 68 | Generated on $(date) for skia by |
| 69 | <a href="http://www.doxygen.org/index.html">doxygen</a> |
| 70 | $(doxygen --version) </small></address> |
| 71 | </body></html> |
| 72 | EOF |
| 73 | |
| 74 | # Make sure that all files have the correct mimetype. |
| epoger@google.com | 338ef65 | 2011-12-07 18:52:40 +0000 | [diff] [blame] | 75 | find . -name '*.html' -exec svn propset svn:mime-type text/html '{}' \; |
| 76 | find . -name '*.css' -exec svn propset svn:mime-type text/css '{}' \; |
| 77 | find . -name '*.js' -exec svn propset svn:mime-type text/javascript '{}' \; |
| 78 | find . -name '*.gif' -exec svn propset svn:mime-type image/gif '{}' \; |
| 79 | find . -name '*.png' -exec svn propset svn:mime-type image/png '{}' \; |
| epoger@google.com | b0c5e07 | 2011-12-06 14:52:38 +0000 | [diff] [blame] | 80 | |
| rmistry@google.com | bcf0c52 | 2012-07-09 20:53:03 +0000 | [diff] [blame] | 81 | # Output files with documentation updates. |
| 82 | echo -e "\n\nThe following are the documentation updates:" |
| 83 | echo $MODFILES |
| 84 | |
| 85 | if $DOXYGEN_COMMIT ; then |
| 86 | # Commit the updated docs to the subversion repo. |
| 87 | svn commit --message 'commit doxygen-generated documentation' |
| 88 | fi |