Bug#844268: [pkg-boost-devel] Bug#844268: libboost1.62-doc doesn't contain the actual documentation

2017-10-24 Thread Dimitri John Ledkov 
On 24 October 2017 at 16:07, Steve M. Robbins  wrote:
> On Tue, Oct 24, 2017 at 02:04:44PM +0100, Dimitri John Ledkov wrote:
>> On 24 October 2017 at 04:00, Steve M. Robbins  wrote:
>
>
>> > If I re-enable the doc packages and build, lintian spews dozens of
>> > errors of three kinds: privacy-breach-logo, privacy-breach-generic,
>> > privacy-breach-uses-embedded-file.
>> >
>> > E: libboost1.65-doc: privacy-breach-logo 
>> > usr/share/doc/libboost1.65-doc/HTML/doc/html/quickbook/syntax/block.html 
>> > (http://sourceforge.net/sflogo.php?group_id=28447type=1)
>> > W: libboost1.65-doc: privacy-breach-generic 
>> > usr/share/doc/libboost1.65-doc/HTML/libs/assert/doc/html/assert.html 
>> > (https://fonts.googleapis.com/css?family=open+sans:300,300italic,400,400italic,600,600italic%7cnoto+serif:400,400italic,700,700italic%7cdroid+sans+mono:400,700)
>> > E: libboost1.65-doc: privacy-breach-uses-embedded-file 
>> > usr/share/doc/libboost1.65-doc/HTML/libs/hana/doc/html/accessors_8hpp.html 
>> > You may use the libjs-mathjax package. 
>> > (https://cdn.mathjax.org/mathjax/latest/mathjax.js)
>> > E: libboost1.65-doc: privacy-breach-uses-embedded-file 
>> > usr/share/doc/libboost1.65-doc/HTML/libs/hana/doc/html/adapt__adt_8hpp.html
>> >  You may use the libjs-mathjax package. 
>> > (https://cdn.mathjax.org/mathjax/latest/mathjax.js)
>> > E: libboost1.65-doc: privacy-breach-uses-embedded-file 
>> > usr/share/doc/libboost1.65-doc/HTML/libs/hana/doc/html/adapt__struct_8hpp.html
>> >  You may use the libjs-mathjax package. 
>> > (https://cdn.mathjax.org/mathjax/latest/mathjax.js)
>> > E: libboost1.65-doc: privacy-breach-uses-embedded-file 
>> > usr/share/doc/libboost1.65-doc/HTML/libs/hana/doc/html/adjust_8hpp.html 
>> > You may use the libjs-mathjax package. 
>> > (https://cdn.mathjax.org/mathjax/latest/mathjax.js)
>> >
>> >  etc.
>> >
>>
>> The google fonts in assert appear to be generated by calling asciidoc
>> -> i wonder if debian's asciidoc can be made to not generate those
>> and/or use local fonts?
>>
>> For the mathjax, there appears to be support in Doxygen files to
>> specify a url from libjs-mathjax package.
>>
>> Let's see if we can fix up these docs to be offline, and also file
>> issues as appropriate about things we cannot offline.
>
> OK.  So the original approach -- the one that generated the big
> lintian list -- is to simply use the files as they appear in the
> source distribution.  To do what you suggest, I think we need to move
> to a strategy that actually generates documentation during the package
> build.  Will you look into setting that up?  The 1.65.1 is otherwise
> ready to go, from my point of view.

Yes indeed it should be actually rebuilt. I've patched the asciidoctor
and the doxygen files but i'm failing to figure out how to rebuild all
the .html files.

It seems like the preffered form of modification is not the source
tarball we use, as all the paths in this tarball with pre-built .html
documentation are not those that are expected by Jamfiles to build the
docs.

After bootstrapping b2 / bjam using all the documentation toolchain it
fails to build by not able to find the right paths to all the
split-modules in the assembled tarball =/

I wonder if we should start generating our own tarballs from git
checkouts out boost. In which case having our packaging as a debian
submodule may makes sense as well..

I'm not sure i will be able to tackle this in a day. Can we upload
1.65.1 as is now, and I'll work on building the docs on a long weekend
or some such?


-- 
Regards,

Dimitri.

Bug#844268: [pkg-boost-devel] Bug#844268: libboost1.62-doc doesn't contain the actual documentation

2017-10-24 Thread Steve M. Robbins 
On Tue, Oct 24, 2017 at 02:04:44PM +0100, Dimitri John Ledkov wrote:
> On 24 October 2017 at 04:00, Steve M. Robbins  wrote:


> > If I re-enable the doc packages and build, lintian spews dozens of
> > errors of three kinds: privacy-breach-logo, privacy-breach-generic,
> > privacy-breach-uses-embedded-file.
> >
> > E: libboost1.65-doc: privacy-breach-logo 
> > usr/share/doc/libboost1.65-doc/HTML/doc/html/quickbook/syntax/block.html 
> > (http://sourceforge.net/sflogo.php?group_id=28447type=1)
> > W: libboost1.65-doc: privacy-breach-generic 
> > usr/share/doc/libboost1.65-doc/HTML/libs/assert/doc/html/assert.html 
> > (https://fonts.googleapis.com/css?family=open+sans:300,300italic,400,400italic,600,600italic%7cnoto+serif:400,400italic,700,700italic%7cdroid+sans+mono:400,700)
> > E: libboost1.65-doc: privacy-breach-uses-embedded-file 
> > usr/share/doc/libboost1.65-doc/HTML/libs/hana/doc/html/accessors_8hpp.html 
> > You may use the libjs-mathjax package. 
> > (https://cdn.mathjax.org/mathjax/latest/mathjax.js)
> > E: libboost1.65-doc: privacy-breach-uses-embedded-file 
> > usr/share/doc/libboost1.65-doc/HTML/libs/hana/doc/html/adapt__adt_8hpp.html 
> > You may use the libjs-mathjax package. 
> > (https://cdn.mathjax.org/mathjax/latest/mathjax.js)
> > E: libboost1.65-doc: privacy-breach-uses-embedded-file 
> > usr/share/doc/libboost1.65-doc/HTML/libs/hana/doc/html/adapt__struct_8hpp.html
> >  You may use the libjs-mathjax package. 
> > (https://cdn.mathjax.org/mathjax/latest/mathjax.js)
> > E: libboost1.65-doc: privacy-breach-uses-embedded-file 
> > usr/share/doc/libboost1.65-doc/HTML/libs/hana/doc/html/adjust_8hpp.html You 
> > may use the libjs-mathjax package. 
> > (https://cdn.mathjax.org/mathjax/latest/mathjax.js)
> >
> >  etc.
> >
> 
> The google fonts in assert appear to be generated by calling asciidoc
> -> i wonder if debian's asciidoc can be made to not generate those
> and/or use local fonts?
> 
> For the mathjax, there appears to be support in Doxygen files to
> specify a url from libjs-mathjax package.
> 
> Let's see if we can fix up these docs to be offline, and also file
> issues as appropriate about things we cannot offline.

OK.  So the original approach -- the one that generated the big
lintian list -- is to simply use the files as they appear in the
source distribution.  To do what you suggest, I think we need to move
to a strategy that actually generates documentation during the package
build.  Will you look into setting that up?  The 1.65.1 is otherwise
ready to go, from my point of view.

Best,
-Steve


signature.asc
Description: PGP signature

Bug#844268: [pkg-boost-devel] Bug#844268: libboost1.62-doc doesn't contain the actual documentation

2017-10-24 Thread Dimitri John Ledkov 
On 24 October 2017 at 04:00, Steve M. Robbins  wrote:
> On Sun, Apr 23, 2017 at 11:55:15AM +0200, Klaus-J. Wolf wrote:
>> Package: libboost1.62-doc
>> Version: 1.62.0+dfsg-4
>> Followup-For: Bug #844268
>>
>> Dear Maintainer,
>>
>> I have observed that the actual documentation is completely missing in
>> this documentation package.  In duplicate bug report #850795 somebody
>> explained that this has to do with Debian project's Javascript policy.
>> I can only explain that I was incapable of finding any script elements
>> in the original docs.
>
> OK, it wasn't only javascript; also some basic HTML.
>
> If I re-enable the doc packages and build, lintian spews dozens of
> errors of three kinds: privacy-breach-logo, privacy-breach-generic,
> privacy-breach-uses-embedded-file.
>
> E: libboost1.65-doc: privacy-breach-logo 
> usr/share/doc/libboost1.65-doc/HTML/doc/html/quickbook/syntax/block.html 
> (http://sourceforge.net/sflogo.php?group_id=28447type=1)
> W: libboost1.65-doc: privacy-breach-generic 
> usr/share/doc/libboost1.65-doc/HTML/libs/assert/doc/html/assert.html 
> (https://fonts.googleapis.com/css?family=open+sans:300,300italic,400,400italic,600,600italic%7cnoto+serif:400,400italic,700,700italic%7cdroid+sans+mono:400,700)
> E: libboost1.65-doc: privacy-breach-uses-embedded-file 
> usr/share/doc/libboost1.65-doc/HTML/libs/hana/doc/html/accessors_8hpp.html 
> You may use the libjs-mathjax package. 
> (https://cdn.mathjax.org/mathjax/latest/mathjax.js)
> E: libboost1.65-doc: privacy-breach-uses-embedded-file 
> usr/share/doc/libboost1.65-doc/HTML/libs/hana/doc/html/adapt__adt_8hpp.html 
> You may use the libjs-mathjax package. 
> (https://cdn.mathjax.org/mathjax/latest/mathjax.js)
> E: libboost1.65-doc: privacy-breach-uses-embedded-file 
> usr/share/doc/libboost1.65-doc/HTML/libs/hana/doc/html/adapt__struct_8hpp.html
>  You may use the libjs-mathjax package. 
> (https://cdn.mathjax.org/mathjax/latest/mathjax.js)
> E: libboost1.65-doc: privacy-breach-uses-embedded-file 
> usr/share/doc/libboost1.65-doc/HTML/libs/hana/doc/html/adjust_8hpp.html You 
> may use the libjs-mathjax package. 
> (https://cdn.mathjax.org/mathjax/latest/mathjax.js)
>
>  etc.
>

The google fonts in assert appear to be generated by calling asciidoc
-> i wonder if debian's asciidoc can be made to not generate those
and/or use local fonts?

For the mathjax, there appears to be support in Doxygen files to
specify a url from libjs-mathjax package.

Let's see if we can fix up these docs to be offline, and also file
issues as appropriate about things we cannot offline.


-- 
Regards,

Dimitri.