On 08-06-2015 18:05, Pierre Labastie wrote:
> Le 08/06/2015 22:34, Bruce Dubbs a écrit :
>> Fernando de Oliveira wrote:
>>> Hi, Pierre,
>>>
>>> When updating to 1.9.5, I decided to install the docs, which I never did
>>> before.
>>>
>>> Noticed that it was loading, building(?) and installing documentation:
>>>
>>> {{{
>>> javadocs:
>>> [mkdir] Created dir:
>>> /tmp/porg-build-2015.06.08-09h07m19s/apache-ant-1.9.5/build/javadocs
>>> [javadoc] Generating Javadoc
>>> [javadoc] Javadoc execution
>>> [javadoc] Loading source files for package org.apache.tools.ant...
>>> [javadoc] Loading source files for package
>>> org.apache.tools.ant.attribute...
>>> ...
>>> [javadoc] Constructing Javadoc information...
>>> ...
>>> [javadoc] Generating
>>> /tmp/porg-build-2015.06.08-09h07m19s/apache-ant-1.9.5/build/javadocs/help-doc.html...
>>>
>>> [javadoc] Note: Custom tags that could override future standard tags:
>>> @todo. To avoid potential overrides, use at least one period character
>>> (.) in custom tag names.
>>> [javadoc] 100 warnings
>>>
>>> dist_javadocs:
>>> [mkdir] Created dir:
>>> /tmp/porg-build-2015.06.08-09h07m19s/DEST-apache-ant-1.9.5/opt/ant-1.9.5/manual/api
>>>
>>> [copy] Copying 1291 files to
>>> /tmp/porg-build-2015.06.08-09h07m19s/DEST-apache-ant-1.9.5/opt/ant-1.9.5/manual/api
>>>
>>> }}}
>>>
>>> There are many error messages, but it seemed to work. Found:
>>>
>>> {{{
>>> $ LANG=C du -sh opt/ant-1.9.5/{docs,manual}
>>> 35M opt/ant-1.9.5/docs
>>> 37M opt/ant-1.9.5/manual
>>> $ LANG=C diff -qr opt/ant-1.9.5/{docs,manual} | grep 'Only in'
>>> Only in opt/ant-1.9.5/docs: NOTICE
>>> Only in opt/ant-1.9.5/docs/api: resources
>>> Only in opt/ant-1.9.5/manual/api: script.js
>>> }}}
>>
>>
>> The errors seem to be due to missing jar files.
>>
>> org.apache.bcel
>> org.apache.commons
>> org.apache.log4j
>> javax.mail
>> org.apache.xalan
>> netrexx.lang
>> javax.media
>>
>> I haven't tried to get them though.
>>
>> -- Bruce
>>
> What I have checked is that both docs and manual contain the same files. There
> are some gif images the docs directory, which are not in the manual directory.
> Do not think it makes a difference, maybe some fancy icon in the shipped doc
> is not there in the generated doc...
Yes I noticed that, but the message was already too long.
They are only used in api/stylesheet.css, for the downloaded docs, not
the built manual (only searched background.gif):
{{{
$ find apache-ant-1.9.5/api/ -name \*.gif
apache-ant-1.9.5/api/resources/background.gif
apache-ant-1.9.5/api/resources/tab.gif
apache-ant-1.9.5/api/resources/titlebar_end.gif
apache-ant-1.9.5/api/resources/titlebar.gif
$ grep -r background.gif apache-ant-1.9.5/
apache-ant-1.9.5/api/stylesheet.css:
background-image:url(resources/background.gif);
apache-ant-1.9.5/api/stylesheet.css:
background-image:url(resources/background.gif);
apache-ant-1.9.5/api/stylesheet.css:
background-image:url(resources/background.gif);
}}}
As Pierre wrote, they change the html pages, e.g., by using "dégradé"
colours in the respective places naming them. They don't change the
essence of the docs, again, agreeing with Pierre.
--
[]s,
Fernando
--
http://lists.linuxfromscratch.org/listinfo/blfs-dev
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
