Re: fun with sphinx

Justin Deoliveira ha scritto:
> Nope, it references the sources online directly from the svn repo. So
> you need to be online or else you will get an empty code block.

Given the choice, and from the perspective of someone that has
a slow ping line (160ms to ping the svn repo), I'd very much prefer
it to hit the local checkout as opposed to a network connection.

To give you an example:


time curl
https://svn.codehaus.org/geoserver/trunk/src/main/src/main/java/org/geoserver/data/CatalogReader.java 
 > /dev/null
   % Total    % Received % Xferd  Average Speed   Time    Time     Time
  Current
                                  Dload  Upload   Total   Spent    Left
  Speed
100  5818  100  5818    0     0   6623      0 --:--:-- --:--:-- --:--:--
36136

real 0m0.885s
user 0m0.020s
sys 0m0.004s

So I would basically a bit less than an extra second in the build per
snippet included in the docs. If the docs start making heavy use
of it we may add up to a few extra minutes of build time (every time
the build is done).

I don't know how typical this is, but persuaded it's common enough
for people in southern Europe, and may be worse in other countries.
Also, this keeps on downloading small amounts at each build, which
is not so good in countries where you pay per MB downloaded (and not
so good either if you're paying per hour since you can't build
without being online).

Finally, we're talking about the developer guide here, not the user one,
so it does not seem so odd to require a full checkout of GeoServer
with sources included.

Cheers
Andrea

--
Andrea Aime
OpenGeo - http://opengeo.org
Expert service straight from the developers.

------------------------------------------------------------------------------
Enter the BlackBerry Developer Challenge  
This is your chance to win up to $100,000 in prizes! For a limited time,
vendors submitting new applications to BlackBerry App World(TM) will have
the opportunity to enter the BlackBerry Developer Challenge. See full prize  
details at: http://p.sf.net/sfu/Challenge
_______________________________________________
Geoserver-devel mailing list
Geoserver-devel@...
https://lists.sourceforge.net/lists/listinfo/geoserver-devel