Blame doc/man/CMakeLists.txt

Packit b1f7ae
# Copyright (c) 2015-2017, Intel Corporation
Packit b1f7ae
#
Packit b1f7ae
# Redistribution and use in source and binary forms, with or without
Packit b1f7ae
# modification, are permitted provided that the following conditions are met:
Packit b1f7ae
#
Packit b1f7ae
#  * Redistributions of source code must retain the above copyright notice,
Packit b1f7ae
#    this list of conditions and the following disclaimer.
Packit b1f7ae
#  * Redistributions in binary form must reproduce the above copyright notice,
Packit b1f7ae
#    this list of conditions and the following disclaimer in the documentation
Packit b1f7ae
#    and/or other materials provided with the distribution.
Packit b1f7ae
#  * Neither the name of Intel Corporation nor the names of its contributors
Packit b1f7ae
#    may be used to endorse or promote products derived from this software
Packit b1f7ae
#    without specific prior written permission.
Packit b1f7ae
#
Packit b1f7ae
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Packit b1f7ae
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
Packit b1f7ae
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
Packit b1f7ae
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
Packit b1f7ae
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
Packit b1f7ae
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
Packit b1f7ae
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
Packit b1f7ae
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
Packit b1f7ae
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
Packit b1f7ae
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
Packit b1f7ae
# POSSIBILITY OF SUCH DAMAGE.
Packit b1f7ae
Packit b1f7ae
file(MAKE_DIRECTORY ${MAN_OUTPUT_DIRECTORY}/man3)
Packit b1f7ae
Packit b1f7ae
find_program(PANDOC pandoc
Packit b1f7ae
  DOC "Path to pandoc; used for building man pages."
Packit b1f7ae
)
Packit b1f7ae
Packit b1f7ae
function(add_man_page filename section function)
Packit b1f7ae
  set(input ${CMAKE_CURRENT_SOURCE_DIR}/${filename})
Packit b1f7ae
  set(output ${MAN_OUTPUT_DIRECTORY}/man${section}/${function}.${section})
Packit b1f7ae
Packit b1f7ae
  add_custom_command(
Packit b1f7ae
    OUTPUT ${output}
Packit b1f7ae
    COMMAND ${PANDOC} -s -f markdown -t man -o ${output} ${input}
Packit b1f7ae
    MAIN_DEPENDENCY ${filename}
Packit b1f7ae
  )
Packit b1f7ae
endfunction(add_man_page)
Packit b1f7ae
Packit b1f7ae
function(install_man_page section function)
Packit b1f7ae
  install(
Packit b1f7ae
    FILES ${MAN_OUTPUT_DIRECTORY}/man${section}/${function}.${section}
Packit b1f7ae
    DESTINATION ${CMAKE_INSTALL_MANDIR}/man${section}
Packit b1f7ae
  )
Packit b1f7ae
endfunction(install_man_page)
Packit b1f7ae
Packit b1f7ae
function(add_man_page_alias section function alias)
Packit b1f7ae
  set(output ${MAN_OUTPUT_DIRECTORY}/man${section}/${alias}.${section})
Packit b1f7ae
Packit b1f7ae
  file(WRITE ${output} ".so man${section}/${function}.${section}\n")
Packit b1f7ae
Packit b1f7ae
  install_man_page(${section} ${alias})
Packit b1f7ae
endfunction(add_man_page_alias)
Packit b1f7ae
Packit b1f7ae
set(MAN3_FUNCTIONS
Packit b1f7ae
  pt_library_version
Packit b1f7ae
  pt_config
Packit b1f7ae
  pt_packet
Packit b1f7ae
  pt_alloc_encoder
Packit b1f7ae
  pt_enc_get_offset
Packit b1f7ae
  pt_enc_get_config
Packit b1f7ae
  pt_pkt_alloc_decoder
Packit b1f7ae
  pt_pkt_sync_forward
Packit b1f7ae
  pt_pkt_get_offset
Packit b1f7ae
  pt_qry_alloc_decoder
Packit b1f7ae
  pt_qry_sync_forward
Packit b1f7ae
  pt_qry_get_offset
Packit b1f7ae
  pt_qry_cond_branch
Packit b1f7ae
  pt_qry_event
Packit b1f7ae
  pt_qry_time
Packit b1f7ae
  pt_image_alloc
Packit b1f7ae
  pt_image_add_file
Packit b1f7ae
  pt_image_remove_by_filename
Packit b1f7ae
  pt_image_set_callback
Packit b1f7ae
  pt_insn_alloc_decoder
Packit b1f7ae
  pt_insn_sync_forward
Packit b1f7ae
  pt_insn_get_offset
Packit b1f7ae
  pt_insn_get_image
Packit b1f7ae
  pt_insn_next
Packit b1f7ae
  pt_iscache_alloc
Packit b1f7ae
  pt_iscache_add_file
Packit b1f7ae
  pt_iscache_read
Packit b1f7ae
  pt_blk_alloc_decoder
Packit b1f7ae
  pt_blk_sync_forward
Packit b1f7ae
  pt_blk_get_offset
Packit b1f7ae
  pt_blk_next
Packit b1f7ae
)
Packit b1f7ae
Packit b1f7ae
foreach (function ${MAN3_FUNCTIONS})
Packit b1f7ae
  set(MAN_PAGES ${MAN_PAGES} ${MAN_OUTPUT_DIRECTORY}/man3/${function}.3)
Packit b1f7ae
Packit b1f7ae
  add_man_page(${function}.3.md 3 ${function})
Packit b1f7ae
  install_man_page(3 ${function})
Packit b1f7ae
endforeach ()
Packit b1f7ae
Packit b1f7ae
add_man_page_alias(3 pt_config pt_cpu_errata)
Packit b1f7ae
add_man_page_alias(3 pt_packet pt_enc_next)
Packit b1f7ae
add_man_page_alias(3 pt_packet pt_pkt_next)
Packit b1f7ae
add_man_page_alias(3 pt_alloc_encoder pt_free_encoder)
Packit b1f7ae
add_man_page_alias(3 pt_enc_get_offset pt_enc_sync_set)
Packit b1f7ae
add_man_page_alias(3 pt_enc_get_config pt_pkt_get_config)
Packit b1f7ae
add_man_page_alias(3 pt_enc_get_config pt_qry_get_config)
Packit b1f7ae
add_man_page_alias(3 pt_enc_get_config pt_insn_get_config)
Packit b1f7ae
add_man_page_alias(3 pt_enc_get_config pt_blk_get_config)
Packit b1f7ae
add_man_page_alias(3 pt_pkt_alloc_decoder pt_pkt_free_decoder)
Packit b1f7ae
add_man_page_alias(3 pt_pkt_sync_forward pt_pkt_sync_backward)
Packit b1f7ae
add_man_page_alias(3 pt_pkt_sync_forward pt_pkt_sync_set)
Packit b1f7ae
add_man_page_alias(3 pt_pkt_get_offset pt_pkt_get_sync_offset)
Packit b1f7ae
add_man_page_alias(3 pt_qry_alloc_decoder pt_qry_free_decoder)
Packit b1f7ae
add_man_page_alias(3 pt_qry_sync_forward pt_qry_sync_backward)
Packit b1f7ae
add_man_page_alias(3 pt_qry_sync_forward pt_qry_sync_set)
Packit b1f7ae
add_man_page_alias(3 pt_qry_get_offset pt_qry_get_sync_offset)
Packit b1f7ae
add_man_page_alias(3 pt_qry_cond_branch pt_qry_indirect_branch)
Packit b1f7ae
add_man_page_alias(3 pt_qry_time pt_qry_core_bus_ratio)
Packit b1f7ae
add_man_page_alias(3 pt_qry_time pt_insn_time)
Packit b1f7ae
add_man_page_alias(3 pt_qry_time pt_insn_core_bus_ratio)
Packit b1f7ae
add_man_page_alias(3 pt_qry_time pt_blk_time)
Packit b1f7ae
add_man_page_alias(3 pt_qry_time pt_blk_core_bus_ratio)
Packit b1f7ae
add_man_page_alias(3 pt_image_alloc pt_image_free)
Packit b1f7ae
add_man_page_alias(3 pt_image_alloc pt_image_name)
Packit b1f7ae
add_man_page_alias(3 pt_image_add_file pt_image_copy)
Packit b1f7ae
add_man_page_alias(3 pt_image_add_file pt_image_add_cached)
Packit b1f7ae
add_man_page_alias(3 pt_image_remove_by_filename pt_image_remove_by_asid)
Packit b1f7ae
add_man_page_alias(3 pt_insn_alloc_decoder pt_insn_free_decoder)
Packit b1f7ae
add_man_page_alias(3 pt_insn_sync_forward pt_insn_sync_backward)
Packit b1f7ae
add_man_page_alias(3 pt_insn_sync_forward pt_insn_sync_set)
Packit b1f7ae
add_man_page_alias(3 pt_insn_get_offset pt_insn_get_sync_offset)
Packit b1f7ae
add_man_page_alias(3 pt_insn_get_image pt_insn_set_image)
Packit b1f7ae
add_man_page_alias(3 pt_insn_get_image pt_blk_get_image)
Packit b1f7ae
add_man_page_alias(3 pt_insn_get_image pt_blk_set_image)
Packit b1f7ae
add_man_page_alias(3 pt_insn_next pt_insn)
Packit b1f7ae
add_man_page_alias(3 pt_iscache_alloc pt_iscache_free)
Packit b1f7ae
add_man_page_alias(3 pt_iscache_alloc pt_iscache_name)
Packit b1f7ae
add_man_page_alias(3 pt_blk_alloc_decoder pt_blk_free_decoder)
Packit b1f7ae
add_man_page_alias(3 pt_blk_sync_forward pt_blk_sync_backward)
Packit b1f7ae
add_man_page_alias(3 pt_blk_sync_forward pt_blk_sync_set)
Packit b1f7ae
add_man_page_alias(3 pt_blk_get_offset pt_blk_get_sync_offset)
Packit b1f7ae
add_man_page_alias(3 pt_blk_next pt_block)
Packit b1f7ae
Packit b1f7ae
add_custom_target(man ALL DEPENDS ${MAN_PAGES})