Re: [boost] Attention library authors.. Library requirements testing is now active.

Subject: Re: [boost] Attention library authors.. Library requirements testing is now active.
From: Andrey Semashev (andrey.semashev_at_[hidden])
Date: 2016-06-15 05:03:28

On Wednesday, 15 June 2016 11:52:03 MSK Rene Rivera wrote:
> 
> 2. Most structure library requirements are now checked both in the regular
> full testing and in the CI testing.
> 
> I've implemented a script to check for most of the library directory
> structure and integration requirements. The script runs as an additional CI
> job, currently in Travis. Here's one of those jobs <
> https://travis-ci.org/boostorg/boost/jobs/137506433>.

In that report:

libs/winapi: error: file not found; Did not find [project-root]/index.html 
file. The file is required for all libraries. Redirection to HTML 
documentation.
libs/winapi: error: directory not found; Missing [project-root]/doc directory. 
The [project-root]/doc directory is required for all libraries. Sources to 
build with and built documentation for the library. If the library needs to 
build documentation from non-HTML files this location must be buildable with 
Boost Build.

Boost.WinAPI does not have documentation, it's not a public library. What 
should I do about these errors?

libs/winapi: error: file not found; Did not find [project-root]/include/boost/
[library].h* file. A single header for the library is required at [project-
root]/include/boost/[library].h* if the library does not have a header 
directory at [project-root]/include/boost/[library].

I didn't know this was a requirement. Anyway, there's no single header for 
Boost.WinAPI and its headers are placed under boost/detail/winapi. Again, 
because it's not a public library and because it used to be part of 
Boost.Detail.

libs/winapi: error: directory not found; Missing [project-root]/meta 
directory. The [project-root]/meta directory is required for all libraries.

I thought meta/* is supposed to be created by someone else (you?) with a pull 
request. I'm not sure what I should do about it.

Also there's a python error at the end of the report:

Failed: 'b2' '--debug-configuration' '-j2' '-d0' '--check-libs-only' ERROR = 1

# /home/travis/build/boostorg/boost/status> 'b2' '--debug-configuration' '-j2' 
'-d0' '--check-libs-only' execution time 9.05490994453 seconds

Traceback (most recent call last):

  File "/home/travis/build/boostorg/boost/../script.py", line 421, in <module>

    script_travis()

  File "/home/travis/build/boostorg/boost/../script.py", line 377, in __init__

    commit=os.getenv("TRAVIS_COMMIT"))

  File "/home/travis/build/boostorg/boost/../script.py", line 248, in __init__

    self.main()

  File "/home/travis/build/boostorg/boost/../script.py", line 296, in main

    getattr(self,action_m)()

  File "/home/travis/build/boostorg/boost/../script.py", line 391, in 
command_script

    self.command_base_build()

  File "/home/travis/build/boostorg/boost/../script.py", line 282, in 
command_base_build

    self.b2("-d0","--check-libs-only")

  File "/home/travis/build/boostorg/boost/../script.py", line 308, in b2

    return utils.check_call(*cmd)

  File "/home/travis/build/boostorg/boost/../script.py", line 46, in 
check_call

    raise(SystemCallError([cwd].extend(command), result))

__main__.SystemCallError

The command "python "${TRAVIS_BUILD_DIR}/../script.py" script" exited with 1.
after_failure