Prashant Srinivasan wrote: > Jyri Virkki wrote: > >> Prashant Srinivasan wrote: >> >> >>>> It seems to deliver much documentation under /var/rubygems/repository/doc/ >>>> Is this "/var" content? It changes during runtime and/or users modify it? >>>> If it's just documentation why isn't it under /usr? >>>> >>>> >>> In general, the doc directory content can be changed during gem >>> administration. The ones that are here are inherent to packages in >>> rubygems it self. >>> In any case, I would prescribe not to attempt to change the location of >>> these directories since they are internal to the software. >>> >>> >> Can you expand on that? >> >> Is it that the docs can't be found if they are in /usr? By ri? >> >> Delivering tons of static files or docs under /var is certainly unorthodox. >> If there's any way to put the docs under /usr instead, that's better. >> If it truly is impossible, at least document why in the spec. >> >> >> > > Jyri, > The Rubygems software allows a user to customize locations only to the > level of the repository(changes deeper than that will change assumptions > that rubygems makes). So gemri(or ri) wont be able to find them. Even > if we somehow solved the previous problem, if the user decides to update > rubygems independant of our packages(which we should allow/encourage), > they would have two inconsistent copies of this documentation. > -ps > > > > >> For example it means that every zone would duplicate all this static >> documentation even though there is no need. >> >>
The documentation in the /var is subject to changing by rubygems users in a zone. So putting it into a SRZ shareable location like /usr would defeat the purpose. (which is why we put the gem repository into /var initially.) -ps >> >> > >
