# Copyright (c) 2014 Renato Tegon Forti, Antony Polukhin.
# Copyright (c) 2015-2025 Antony Polukhin.
#
# Distributed under the Boost Software License, Version 1.0. (See accompanying
# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

using quickbook ;
using boostbook ;
using doxygen ;
using xsltproc ;

import set ;
import doxygen ;
import xsltproc ;
import notfile ;
import path ;

project dll/doc ;

#
# Common params for doxygen
# 

local doxygen_params =
    <doxygen:param>HIDE_UNDOC_MEMBERS=YES
    <doxygen:param>HIDE_UNDOC_CLASSES=YES
    <doxygen:param>HIDE_SCOPE_NAMES=YES
    <doxygen:param>EXTRACT_ALL=NO
    <doxygen:param>EXTRACT_PRIVATE=NO
    <doxygen:param>BUILTIN_STL_SUPPORT=YES
    <doxygen:param>ENABLE_PREPROCESSING=YES
    <doxygen:param>MACRO_EXPANSION=YES
    <doxygen:param>"ALIASES= \\
        \"forcedlink{1}=\\xmlonly<link linkend='boost.dll.\\1'>boost::dll::\\1</link>\\endxmlonly\" \\
        \"forcedlinkfs{1}=\\xmlonly<link linkend='boost.dll.fs.\\1'>boost::dll::fs::\\1</link>\\endxmlonly\" \\
        \"forcedmacrolink{1}=\\xmlonly<link linkend='\\1'>\\1</link>\\endxmlonly\" "
    <doxygen:param>"PREDEFINED= \\
        \"BOOST_DLL_IMPORT_RESULT_TYPE=result_type\" \\
        \"BOOST_DLL_MANGLED_IMPORT_RESULT_TYPE=result_type\" \\
        \"BOOST_DLL_DOXYGEN\" "
    ;

#
# Ref Sessions Generation
#
doxygen autodoc_shared_library_core
    :
        [ glob 
            ../include/boost/dll/config.hpp
            ../include/boost/dll/shared_library.hpp
            ../include/boost/dll/shared_library_load_mode.hpp
            ../include/boost/dll/library_info.hpp
            ../include/boost/dll/runtime_symbol_info.hpp
            ../include/boost/dll/alias.hpp

            ../include/boost/dll/smart_library.hpp
        ]
    :
        $(doxygen_params)
        <xsl:param>"boost.doxygen.reftitle=Shared Library Reference"
    ;

doxygen autodoc_shared_library_refcountable
    :
        [ glob 
            ../include/boost/dll/import.hpp
            ../include/boost/dll/import_class.hpp
            ../include/boost/dll/import_mangled.hpp
        ]
    :
        $(doxygen_params)
        <xsl:param>"boost.doxygen.reftitle=Shared Library Refcountable Reference"
    ;

#
# Docs Generation
#
boostbook dll-doc
    :
        dll.qbk
    :
        <dependency>autodoc_shared_library_core
        <dependency>autodoc_shared_library_refcountable
        <xsl:param>boost.root=http://www.boost.org/doc/libs/1_87_0
        #<xsl:param>boost.root=../../../.
        <xml:param>html.stylesheet=../../../../doc/src/boostbook.css
    ;

###############################################################################
alias boostdoc
    : dll-doc/<format>docbook
    :
    :
    : ;
explicit boostdoc ;
alias boostrelease ;
explicit boostrelease ;
