[NaCl SDK] Re-generate docs

native_client_sdk/src/doc/doxygen/generate_docs.py

 #!/usr/bin/env python
 # Copyright (c) 2014 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 """Script to regenerate API docs using doxygen.
 """
 
 import argparse
 import collections
@@ skipping 182 matching lines @@
   with open(template_filename) as f:
     data = f.read()
 
   with open(doxyfile, 'w') as f:
     f.write(data % {
       'out_dirname': out_dirname,
       'doc_dirname': doc_dirname,
       'script_dirname': SCRIPT_DIR})
 
 
+def CheckDoxygenVersion(doxygen):
+  version = subprocess.check_output([doxygen, '--version']).strip()
+  url = 'http://ftp.stack.nl/pub/users/dimitri/doxygen-1.7.6.1.linux.bin.tar.gz'
+  if version != '1.7.6.1':
+    print 'Doxygen version 1.7.6.1 is required'
+    print 'The version being used (%s) is version %s' % (doxygen, version)
+    print 'The simplest way to grab this version is to download it directly:'
+    print url
+    print 'Then either add it to your $PATH or set $DOXYGEN to point to binary.'
+    sys.exit(1)
+
+
 def RunDoxygen(out_dirname, doxyfile):
   Trace('Removing old output directory %s' % out_dirname)
   RemoveDir(out_dirname)
 
   Trace('Making new output directory %s' % out_dirname)
   os.makedirs(out_dirname)
 
   doxygen = os.environ.get('DOXYGEN', 'doxygen')
+  CheckDoxygenVersion(doxygen)
   cmd = [doxygen, doxyfile]
   Trace('Running Doxygen:\n  %s' % ' '.join(cmd))
   subprocess.check_call(cmd)
 
 
 def RunDoxyCleanup(out_dirname):
   script = os.path.join(SCRIPT_DIR, 'doxy_cleanup.py')
   cmd = [sys.executable, script, out_dirname]
   if Trace.verbose:
     cmd.append('-v')
@@ skipping 86 matching lines @@
   return 0
 
 
 if __name__ == '__main__':
   try:
     rtn = main(sys.argv[1:])
   except KeyboardInterrupt:
     sys.stderr.write('%s: interrupted\n' % os.path.basename(__file__))
     rtn = 1
   sys.exit(rtn)