aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorGravatar commit-bot@chromium.org <commit-bot@chromium.org@2bbb7eff-a529-9590-31e7-b0007b416f81>2014-05-15 14:41:00 +0000
committerGravatar commit-bot@chromium.org <commit-bot@chromium.org@2bbb7eff-a529-9590-31e7-b0007b416f81>2014-05-15 14:41:00 +0000
commit76ac7f81d39a99616541ead9c40aa6d208b517af (patch)
treef6361901fe71eb98ee2757637d5cf82fee5e7357
parente1f941fe45e9754ca57c5157156afbb83bc31826 (diff)
delete no-longer-used update-doxygen.sh
BUG=skia:2470 NOTRY=True R=borenet@google.com Author: epoger@google.com Review URL: https://codereview.chromium.org/290033002 git-svn-id: http://skia.googlecode.com/svn/trunk@14747 2bbb7eff-a529-9590-31e7-b0007b416f81
-rw-r--r--Doxyfile13
-rwxr-xr-xtools/update-doxygen.sh112
2 files changed, 10 insertions, 115 deletions
diff --git a/Doxyfile b/Doxyfile
index c472164ed8..8a8bf160ce 100644
--- a/Doxyfile
+++ b/Doxyfile
@@ -1,9 +1,16 @@
-# To update the Doxygen output checked into the Skia subversion repo (which is
-# browsable at http://skia-autogen.googlecode.com/svn/docs/html/index.html ), run:
-# tools/update-doxygen.sh
+# Configuration used by
+# https://skia.googlesource.com/buildbot/+/master/slave/skia_slave_scripts/generate_doxygen.py
+# to generate our Doxygen docs, which are then uploaded to
+# http://chromium-skia-gm.commondatastorage.googleapis.com/doxygen/doxygen/html/index.html
+
PROJECT_NAME = skia
PROJECT_BRIEF = 2D Graphics Library
+
+# These lines are overridden by
+# https://skia.googlesource.com/buildbot/+/master/slave/skia_slave_scripts/generate_doxygen.py ,
+# but they are needed in case someone wants to generate the doxygen manually
+# for some reason.
OUTPUT_DIRECTORY = ../docs
HTML_FOOTER = ../docs/static_footer.txt
diff --git a/tools/update-doxygen.sh b/tools/update-doxygen.sh
deleted file mode 100755
index 1f20b4a7be..0000000000
--- a/tools/update-doxygen.sh
+++ /dev/null
@@ -1,112 +0,0 @@
-#!/bin/bash
-#
-# Runs doxygen and stores its results in the skia-autogen repo, so that they
-# can be browsed at http://skia-autogen.googlecode.com/svn/docs/html/index.html
-#
-# The DOXYGEN_TEMPDIR env variable is the working directory within which we will
-# check out the code, generate documentation, and store the doxygen log
-# (by default, /tmp/skia-doxygen). The DOXYGEN_COMMIT env variable determines
-# whether docs should be commited (true by default).
-#
-# Sample Usage:
-# export DOXYGEN_TEMPDIR=/tmp/doxygen
-# export DOXYGEN_COMMIT=false
-# bash update-doxygen.sh
-#
-# To install doxygen on most Linux systems, you can run:
-# sudo apt-get install doxygen
-
-function check_out_docs {
- svn checkout https://skia-autogen.googlecode.com/svn/docs # writeable
- ret_code=$?
- if [ $ret_code != 0 ]; then
- # docs directory does not exist, skia-autogen must have been reset.
- # Create a non svn docs directory instead.
- mkdir docs
- fi
-}
-
-# Prepare a temporary dir and check out Skia trunk and docs.
-cd
-DOXYGEN_TEMPDIR=${DOXYGEN_TEMPDIR:-/tmp/skia-doxygen}
-DOXYGEN_COMMIT=${DOXYGEN_COMMIT:-true}
-
-mkdir -p $DOXYGEN_TEMPDIR
-cd $DOXYGEN_TEMPDIR
-
-if [ -d "skia" ]; then
- pushd skia
- git pull
- git checkout origin/master
- popd
-else
- git clone https://skia.googlesource.com/skia.git
-fi
-if [ -d "docs" ]; then
- svn update --accept theirs-full docs
- svn info docs
- ret_code=$?
- if [ $ret_code != 0 ]; then
- # This is not a valid SVN checkout.
- rm -rf docs
- check_out_docs
- fi
-else
- check_out_docs
-fi
-
-if [ ! -f "docs/static_footer.txt" ]; then
- cp skia/tools/doxygen_footer.txt docs/static_footer.txt
-fi
-
-# Run Doxygen.
-cd skia
-doxygen Doxyfile
-ret_code=$?
-if [ $ret_code != 0 ]; then
- echo "Error while executing Doxygen command"
- exit $ret_code
-fi
-
-cd ../docs
-
-# Add any newly created files to Subversion.
-NEWFILES=$(svn status | grep ^\? | awk '{print $2}')
-if [ -n "$NEWFILES" ]; then
- svn add $NEWFILES
-fi
-
-# We haven't updated the timestamp footer yet... if there are no changes
-# yet, just exit. (We'll wait until there are any actual doc changes before
-# updating the timestamp and committing changes to the repository.)
-MODFILES=$(svn status | grep ^[AM])
-if [ -z "$MODFILES" ]; then
- echo "No documentation updates, exiting early."
- exit 0
-fi
-
-# Update the timestamp footer.
-cat >iframe_footer.html <<EOF
-<html><body>
-<address style="text-align: right;"><small>
-Generated on $(date) for skia by
-<a href="http://www.doxygen.org/index.html">doxygen</a>
-$(doxygen --version) </small></address>
-</body></html>
-EOF
-
-# Make sure that all files have the correct mimetype.
-find . -name '*.html' -exec svn propset svn:mime-type text/html '{}' \;
-find . -name '*.css' -exec svn propset svn:mime-type text/css '{}' \;
-find . -name '*.js' -exec svn propset svn:mime-type text/javascript '{}' \;
-find . -name '*.gif' -exec svn propset svn:mime-type image/gif '{}' \;
-find . -name '*.png' -exec svn propset svn:mime-type image/png '{}' \;
-
-# Output files with documentation updates.
-echo -e "\n\nThe following are the documentation updates:"
-echo $MODFILES
-
-if $DOXYGEN_COMMIT ; then
- # Commit the updated docs to the subversion repo.
- svn commit --message 'commit doxygen-generated documentation'
-fi