[Tinyos-devel] tinyos autobuilds

[Jan Beutel]

the make pdf is checkd in to the docs. it uses rst2latex and pdflatex

of course i can check in the pdfs. but so far i never bothered. now that
they are linked on index, it probably makes sense. but on the other hand
it makes a checkout a pretty long list of files. but probably in is
better than out and consistent/complete docu is really what we want.

about the link:

better than linking to the build with the link i mailed below would be
to copy the whole doc directory to some "static" web server address
automatically on every build (since the link below changes on every
build! - hence the long number/datecode in the url)

i don't know what server serves tinyos.net. but basically i can scp the
whole docs to wherever is suitable on every successful build. or i just
create a "static" link here like i did a while back for:

http://www.btnode.ethz.ch/static_docs/doxygen/btnut/

note the date on the bottom;-) it is automatically published too!


so probably the best thing is we have the auto generated docs alongside
the current release doc, i.e. 2.0.2 and possibly also older releases
2.0.1, 1.x on tinyos.net. most people running on the releases are fine
with those and CVS HEAD docs can change quite a bit from time to time.

jan




On Fri, 2007-08-17 at 09:01 -0700, Philip Levis wrote:
> On Aug 17, 2007, at 4:03 AM, Jan Beutel wrote:
> 
> > ahhh and i forgot. there are now pdfs generated from the TEP's (very
> > handy for printing nice documents!
> >
> > e.g.
> >
> > http://tik42x.ee.ethz.ch:8080/artifacts/tinyos-2.x/20070817104632/doc/
> >
> > http://tik42x.ee.ethz.ch:8080/artifacts/tinyos-2.x/20070817104632/ 
> > doc/pdf/tep2.pdf
> 
> Ah, cool.
> 
> I tried making PDFs a while back, but couldn't get the references to  
> work. In your PDFs, they show up as footnotes. What command did you  
> run? You should have write access all of -2.x; if you check in the  
> PDFs, I can upload them on www.tinyos.net. I notice that you checked  
> in a change to index.html that links them, but haven't checked the  
> PDFs themselves in yet. I try to keep the doc/ on tinyos.net  
> synchronized to major changes to CVS.
> 
> I'll point tinyos.net at your nesdoc; your auto-build approach is  
> much easier than the one I've been using (manual).
> 
> Phil
-- 
Dr. Jan Beutel                              j.beutel at ieee.org
Computer Engineering and Networks Laboratory, ETZ G75
ETH Zurich                             +41 44 632 70 32 Phone
Gloriastrasse 35                         +41 44 632 10 35 Fax
CH 8092 Zurich/Switzerland  http://www.tik.ee.ethz.ch/~beutel