root-doc subpackage slightly obese

[Jonathan Underwood]

On 6 August 2010 09:53, Jonathan Dieter <jdieter at lesbg.com> wrote:
[snip]
>> No, please not...
>> Generating that documentation will take ages, so each time, %post needs
>> at least 45 min - 1 hour to complete...
>> (One of my reasons for switching to Fedora from Gentoo, was exactly
>> that amount of updating time. ;-) )
>
> According to http://root.cern.ch/root/Documentation.html , it will only
> regenerate changed or added documentation, so it should only take a long
> time on the first install (I haven't done it, so I'm assuming your 45
> min - 1 hour is accurate).
>
>> How about writing a little shell script and include that in the doc
>> subpackage, so if a user wants to see documentation, they can run the
>> snipped and wait for the run, as they wish?
>>
>> Currently, when building root, it's done the same:
>> """
>> # Generate documentation
>> echo Rint.Includes: 0 > .rootrc
>> sed "s!@PWD@!${PWD}!g" %{SOURCE2} > html.C
>> LD_LIBRARY_PATH=${PWD}/lib:${PWD}/cint/cint/include:${PWD}/cint/cint/stl
>> \ ROOTSYS=${PWD} ./bin/root.exe -l -b -q html.C
>> rm .rootrc
>> mv htmldoc ${RPM_BUILD_ROOT}%{_defaultdocdir}/%{name}-%{version}/html
>> """

As I said in the bug report, I don't think building docs client side
is the right way to go at all. In the general case this would require
end users to install extra tools to build the docs, and defeats the
purpose of a package managed system such as Fedora.
>>
>> Maybe putting that (except the mv in the end) in a snipped, would give
>> the user htmldoc in the current folder, where the user called it...
>
> Sounds great.  Honestly, I don't really mind which way it works.
>
> Jonathan
>
> --
> devel mailing list
> devel at lists.fedoraproject.org
> https://admin.fedoraproject.org/mailman/listinfo/devel
>