[doc] Doc directory for a library
If a library does not have a 'doc' subdirectory, because the doc is not buildable but is rather hardcoded into an HTML file, what is the best way to satsify Boost and the boost_check_library regression test for that library ?
On Fri, Oct 7, 2016 at 6:21 AM, Edward Diener
If a library does not have a 'doc' subdirectory, because the doc is not buildable but is rather hardcoded into an HTML file, what is the best way to satsify Boost and the boost_check_library regression test for that library ?
A "doc" subdirectory is required. So you would have to create it with some content in it. Ideally you would move the existing html docs into it. But just having an index.html that redirects would be enough. Note, do not add a jamfile in the doc subdir if it's all pre-made html. As otherwise we assume that there's something to build. -- -- Rene Rivera -- Grafik - Don't Assume Anything -- Robot Dreams - http://robot-dreams.net -- rrivera/acm.org (msn) - grafikrobot/aim,yahoo,skype,efnet,gmail
On 10/7/2016 10:08 AM, Rene Rivera wrote:
On Fri, Oct 7, 2016 at 6:21 AM, Edward Diener
wrote: If a library does not have a 'doc' subdirectory, because the doc is not buildable but is rather hardcoded into an HTML file, what is the best way to satsify Boost and the boost_check_library regression test for that library ?
A "doc" subdirectory is required. So you would have to create it with some content in it. Ideally you would move the existing html docs into it. But just having an index.html that redirects would be enough. Note, do not add a jamfile in the doc subdir if it's all pre-made html. As otherwise we assume that there's something to build.
Both the index.html and the rest of the HTML docs ( a single file ) exist a the top-level directory of the lib, so I am going to assume that putting a readme file in the doc sub-directory will be fine. I don't really want to move around either of the html files unless it is required in some way. The lib is a CMT lib and I don't want to change it more than I have to.
participants (2)
-
Edward Diener
-
Rene Rivera