llvm / llvm-project

The LLVM Project is a collection of modular and reusable compiler and toolchain technologies.
http://llvm.org
Other
26.8k stars 10.98k forks source link

Update of http://llvm.org/docs/doxygen/html/ should be done transparently #20948

Open sylvestre opened 9 years ago

sylvestre commented 9 years ago
Bugzilla Link 20574
Version trunk
OS Linux
CC @calixteman,@tlattner

Extended Description

The update of http://llvm.org/docs/doxygen/html/ is done in a violent way.

It seems that we are removing the directory and regenerating it after.

This causes the documentation to be unavailable for a while. At time of writing this bug (07-Aug-2014 02:39), it is not available.

I don't know if the generation is done on the server side or not but we should be doing something like:

$ generate the documentation in doxygen2 $ rm -rf doxygen $ mv doxygen2 doxygen

This will limit the downtime of the doc.

I can help if you want.

tlattner commented 8 years ago

The directory is not removed, so I'm not sure why you would be seeing this.

This is from the script:

for doxy in $MODULES_WITH_DOXYGEN ; do
  echo UPDATING $doxy DOXYGEN SOURCES
  # Change to the SOURCE directory
  cd $BASE/$doxy

  # Make sure the entire directory is updated to latest version
  svn update 

  # Make sure the doxygen.cfg file is generated
  make -C docs doxygen.cfg BUILD_FOR_WEBSITE=1

  # Kick off doxygen in the docs directory
  echo RUNNING DOXYGEN FOR $doxy
  cd docs 
  touch doxygen.cfg.in
  make doxygen BUILD_FOR_WEBSITE=1

  #when done, copy to the right location.
  cp -R $BASE/$doxy/docs/doxygen/html $BASE/doxygen-web/$doxy/

done
sylvestre commented 8 years ago

Tanya, this is still happening and this is a pain for European users. How can I help with this? Thanks

llvmbot commented 10 months ago

@llvm/issue-subscribers-infrastructure