[tor-bugs] #2706 [Website]: Perhaps we should have the doxygen content on a real site somewhere

[Tor Bug Tracker & Wiki]

#2706: Perhaps we should have the doxygen content on a real site somewhere
---------------------+------------------------------------------------------
 Reporter:  nickm    |          Owner:  phobos  
     Type:  defect   |         Status:  accepted
 Priority:  normal   |      Milestone:          
Component:  Website  |        Version:          
 Keywords:           |         Parent:          
   Points:           |   Actualpoints:          
---------------------+------------------------------------------------------

Comment(by nickm):

 > Can you document the setup? We can host it on doxygen.tpo and mirror it
 between the three webservers

 It's pretty trivial.  I have a crontab entry on moria that says:
 {{{
 20 6 * * * $HOME/bin/update-doxygen.sh
 }}}

 {That is, "please run update-doxygen.sh once every day at 6:20")

 The relevant part of update-doxygen.sh is:
 {{{
 cd ~/public_html/tor
 git pull
 sh autogen.sh
 ./configure
 doxygen
 }}}

 where ~/public_html/tor is a git checkout (OVER SSH) of the tor master
 branch.  This makes ~/public_html/tor/doc/doxygen get the doxygen output.

 >although, i doubt we need a new vm. maybe just a doxygen directory we
 include in the docs/ section of the website.

 This is not a terribly resource-intensive process, though you want to make
 sure that you're using an authenticated method to pull  the Tor code --
 otherwise an attacker could run arbitrary code on your webserver.

-- 
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/2706#comment:4>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online