Files
shaka-player/build/docs.py
T
Jacob Trimble 19973d63f4 Changed copyright headers from 2015 to 2016.
Change-Id: I429ff27e4794c03b7ea392e38415075077f9bfb1
2016-03-15 16:32:13 -07:00

45 lines
1.4 KiB
Python
Executable File

#!/usr/bin/python
#
# Copyright 2016 Google Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""Builds the documentation from the source code. This deletes the old
documentation first.
"""
import os
import shakaBuildHelpers
import shutil
import subprocess
import sys
def buildDocs(_):
base = shakaBuildHelpers.getSourceBase()
shutil.rmtree(os.path.join(base, 'docs', 'api'), ignore_errors=True)
os.chdir(base)
if shakaBuildHelpers.isWindows() or shakaBuildHelpers.isCygwin():
# Windows has a different command name. The Unix version does not seem to
# work on Cygwin, but the windows one does.
jsdoc = os.path.join('third_party', 'jsdoc', 'jsdoc.cmd')
else:
jsdoc = os.path.join('third_party', 'jsdoc', 'jsdoc')
cmdLine = [jsdoc, '-c', 'jsdoc.conf.json']
shakaBuildHelpers.printCmdLine(cmdLine)
return subprocess.call(cmdLine)
if __name__ == '__main__':
shakaBuildHelpers.runMain(buildDocs)