search

KhronosGroup / Vulkan-Docs

The Vulkan API Specification and related tools
Other
2.77k stars 465 forks source link

Remove single-page refpage target from Makefile and document only the separate pages are supported at present #949

Closed sl1pkn07 closed 5 years ago

sl1pkn07 commented 5 years ago

Hi

i'm not sure if i do the correct steps for build the docs, but when build with 

./makeAllExts html styleguide registry manhtml \
  OUTDIR="${pkgdir}/usr/share/doc/vulkan" \
  HTMLDIR='$(OUTDIR)'

i get

python3 scripts/genvk.py -feature VK_VERSION_1_0 -feature VK_VERSION_1_1 -extension VK_AMD_buffer_marker -extension VK_AMD_display_native_hdr -extension VK_AMD_draw_indirect_count -extension VK_AMD_gcn_shader -extension VK_AMD_gpu_shader_half_float -extension VK_AMD_gpu_shader_int16 -extension VK_AMD_memory_overallocation_behavior -extension VK_AMD_mixed_attachment_samples -extension VK_AMD_negative_viewport_height -extension VK_AMD_rasterization_order -extension VK_AMD_shader_ballot -extension VK_AMD_shader_core_properties -extension VK_AMD_shader_explicit_vertex_parameter -extension VK_AMD_shader_fragment_mask -extension VK_AMD_shader_image_load_store_lod -extension VK_AMD_shader_info -extension VK_AMD_shader_trinary_minmax -extension VK_AMD_texture_gather_bias_lod -extension VK_ANDROID_external_memory_android_hardware_buffer -extension VK_EXT_acquire_xlib_display -extension VK_EXT_astc_decode_mode -extension VK_EXT_blend_operation_advanced -extension VK_EXT_buffer_device_address -extension VK_EXT_calibrated_timestamps -extension VK_EXT_conditional_rendering -extension VK_EXT_conservative_rasterization -extension VK_EXT_debug_marker -extension VK_EXT_debug_report -extension VK_EXT_debug_utils -extension VK_EXT_depth_clip_enable -extension VK_EXT_depth_range_unrestricted -extension VK_EXT_descriptor_indexing -extension VK_EXT_direct_mode_display -extension VK_EXT_discard_rectangles -extension VK_EXT_display_control -extension VK_EXT_display_surface_counter -extension VK_EXT_external_memory_dma_buf -extension VK_EXT_external_memory_host -extension VK_EXT_filter_cubic -extension VK_EXT_fragment_density_map -extension VK_EXT_full_screen_exclusive -extension VK_EXT_global_priority -extension VK_EXT_hdr_metadata -extension VK_EXT_host_query_reset -extension VK_EXT_image_drm_format_modifier -extension VK_EXT_inline_uniform_block -extension VK_EXT_memory_budget -extension VK_EXT_memory_priority -extension VK_EXT_metal_surface -extension VK_EXT_pci_bus_info -extension VK_EXT_pipeline_creation_feedback -extension VK_EXT_post_depth_coverage -extension VK_EXT_queue_family_foreign -extension VK_EXT_sample_locations -extension VK_EXT_sampler_filter_minmax -extension VK_EXT_scalar_block_layout -extension VK_EXT_separate_stencil_usage -extension VK_EXT_shader_stencil_export -extension VK_EXT_shader_subgroup_ballot -extension VK_EXT_shader_subgroup_vote -extension VK_EXT_shader_viewport_index_layer -extension VK_EXT_swapchain_colorspace -extension VK_EXT_transform_feedback -extension VK_EXT_validation_cache -extension VK_EXT_validation_features -extension VK_EXT_validation_flags -extension VK_EXT_vertex_attribute_divisor -extension VK_EXT_ycbcr_image_arrays -extension VK_FUCHSIA_imagepipe_surface -extension VK_GGP_frame_token -extension VK_GGP_stream_descriptor_surface -extension VK_GOOGLE_decorate_string -extension VK_GOOGLE_display_timing -extension VK_GOOGLE_hlsl_functionality1 -extension VK_IMG_filter_cubic -extension VK_IMG_format_pvrtc -extension VK_KHR_16bit_storage -extension VK_KHR_8bit_storage -extension VK_KHR_android_surface -extension VK_KHR_bind_memory2 -extension VK_KHR_create_renderpass2 -extension VK_KHR_dedicated_allocation -extension VK_KHR_depth_stencil_resolve -extension VK_KHR_descriptor_update_template -extension VK_KHR_device_group -extension VK_KHR_device_group_creation -extension VK_KHR_display -extension VK_KHR_display_swapchain -extension VK_KHR_draw_indirect_count -extension VK_KHR_driver_properties -extension VK_KHR_external_fence -extension VK_KHR_external_fence_capabilities -extension VK_KHR_external_fence_fd -extension VK_KHR_external_fence_win32 -extension VK_KHR_external_memory -extension VK_KHR_external_memory_capabilities -extension VK_KHR_external_memory_fd -extension VK_KHR_external_memory_win32 -extension VK_KHR_external_semaphore -extension VK_KHR_external_semaphore_capabilities -extension VK_KHR_external_semaphore_fd -extension VK_KHR_external_semaphore_win32 -extension VK_KHR_get_display_properties2 -extension VK_KHR_get_memory_requirements2 -extension VK_KHR_get_physical_device_properties2 -extension VK_KHR_get_surface_capabilities2 -extension VK_KHR_image_format_list -extension VK_KHR_incremental_present -extension VK_KHR_maintenance1 -extension VK_KHR_maintenance2 -extension VK_KHR_maintenance3 -extension VK_KHR_multiview -extension VK_KHR_push_descriptor -extension VK_KHR_relaxed_block_layout -extension VK_KHR_sampler_mirror_clamp_to_edge -extension VK_KHR_sampler_ycbcr_conversion -extension VK_KHR_shader_atomic_int64 -extension VK_KHR_shader_draw_parameters -extension VK_KHR_shader_float16_int8 -extension VK_KHR_shader_float_controls -extension VK_KHR_shared_presentable_image -extension VK_KHR_storage_buffer_storage_class -extension VK_KHR_surface -extension VK_KHR_surface_protected_capabilities -extension VK_KHR_swapchain -extension VK_KHR_swapchain_mutable_format -extension VK_KHR_variable_pointers -extension VK_KHR_vulkan_memory_model -extension VK_KHR_wayland_surface -extension VK_KHR_win32_keyed_mutex -extension VK_KHR_win32_surface -extension VK_KHR_xcb_surface -extension VK_KHR_xlib_surface -extension VK_MVK_ios_surface -extension VK_MVK_macos_surface -extension VK_NN_vi_surface -extension VK_NVX_device_generated_commands -extension VK_NVX_image_view_handle -extension VK_NVX_multiview_per_view_attributes -extension VK_NV_clip_space_w_scaling -extension VK_NV_compute_shader_derivatives -extension VK_NV_cooperative_matrix -extension VK_NV_corner_sampled_image -extension VK_NV_dedicated_allocation -extension VK_NV_dedicated_allocation_image_aliasing -extension VK_NV_device_diagnostic_checkpoints -extension VK_NV_external_memory -extension VK_NV_external_memory_capabilities -extension VK_NV_external_memory_win32 -extension VK_NV_fill_rectangle -extension VK_NV_fragment_coverage_to_color -extension VK_NV_fragment_shader_barycentric -extension VK_NV_framebuffer_mixed_samples -extension VK_NV_geometry_shader_passthrough -extension VK_NV_glsl_shader -extension VK_NV_mesh_shader -extension VK_NV_ray_tracing -extension VK_NV_representative_fragment_test -extension VK_NV_sample_mask_override_coverage -extension VK_NV_scissor_exclusive -extension VK_NV_shader_image_footprint -extension VK_NV_shader_subgroup_partitioned -extension VK_NV_shading_rate_image -extension VK_NV_viewport_array2 -extension VK_NV_viewport_swizzle -extension VK_NV_win32_keyed_mutex  -registry xml/vk.xml -o scripts vkapi.py
python3 scripts/genRef.py -log man/logfile chapters/devsandqueues.txt chapters/synchronization.txt chapters/textures.txt chapters/VK_EXT_validation_flags.txt chapters/copies.txt chapters/formats.txt chapters/resources.txt chapters/limits.txt chapters/VK_EXT_hdr_metadata.txt chapters/geometry.txt chapters/drawing.txt chapters/extensions.txt chapters/vertexpostproc.txt chapters/VK_EXT_debug_utils.txt chapters/renderpass.txt chapters/shaders.txt chapters/clears.txt chapters/memory.txt chapters/pipelines.txt chapters/fragmentdensitymapops.txt chapters/samplers.txt chapters/framebuffer.txt chapters/fxvertex.txt chapters/fragops.txt chapters/interfaces.txt chapters/VK_GGP_frame_token.txt chapters/queries.txt chapters/descriptorsets.txt chapters/VK_EXT_debug_marker.txt chapters/sparsemem.txt chapters/capabilities.txt chapters/VK_EXT_debug_report.txt chapters/tessellation.txt chapters/primsrast.txt chapters/VK_AMD_shader_info.txt chapters/introduction.txt chapters/VK_EXT_validation_features.txt chapters/features.txt chapters/debugging.txt chapters/initialization.txt chapters/dispatch.txt chapters/cmdbuffers.txt chapters/fundamentals.txt appendices/VK_KHR_shared_presentable_image.txt appendices/VK_KHR_driver_properties.txt appendices/VK_NV_fill_rectangle.txt appendices/VK_NV_fragment_shader_barycentric.txt appendices/VK_EXT_direct_mode_display.txt appendices/VK_EXT_scalar_block_layout.txt appendices/VK_AMD_shader_core_properties.txt appendices/VK_EXT_conservative_rasterization.txt appendices/VK_EXT_external_memory_dma_buf.txt appendices/VK_EXT_depth_range_unrestricted.txt appendices/VK_MVK_ios_surface.txt appendices/spirvenv.txt appendices/VK_EXT_calibrated_timestamps.txt appendices/VK_GOOGLE_decorate_string.txt appendices/VK_KHR_get_physical_device_properties2.txt appendices/VK_NV_viewport_swizzle.txt appendices/VK_NV_cooperative_matrix.txt appendices/VK_EXT_memory_priority.txt appendices/VK_EXT_buffer_device_address.txt appendices/VK_AMD_shader_explicit_vertex_parameter.txt appendices/VK_KHR_surface.txt appendices/VK_EXT_memory_budget.txt appendices/VK_KHR_shader_float16_int8.txt appendices/VK_NN_vi_surface.txt appendices/VK_KHR_incremental_present.txt appendices/VK_KHR_external_fence_win32.txt appendices/VK_NV_sample_mask_override_coverage.txt appendices/VK_EXT_validation_cache.txt appendices/VK_AMD_gcn_shader.txt appendices/VK_KHR_shader_draw_parameters.txt appendices/VK_KHR_win32_keyed_mutex.txt appendices/VK_KHR_external_fence_capabilities.txt appendices/VK_NV_compute_shader_derivatives.txt appendices/VK_KHR_device_group_creation.txt appendices/VK_EXT_global_priority.txt appendices/VK_EXT_full_screen_exclusive.txt appendices/VK_EXT_shader_subgroup_vote.txt appendices/invariance.txt appendices/VK_EXT_display_surface_counter.txt appendices/VK_KHR_external_memory_win32.txt appendices/VK_NV_shading_rate_image.txt appendices/VK_NV_win32_keyed_mutex.txt appendices/VK_EXT_debug_marker.txt appendices/VK_AMD_negative_viewport_height.txt appendices/VK_KHR_vulkan_memory_model.txt appendices/VK_NV_mesh_shader.txt appendices/VK_KHR_external_memory_capabilities.txt appendices/VK_AMD_gpu_shader_half_float.txt appendices/VK_EXT_blend_operation_advanced.txt appendices/VK_KHR_sampler_mirror_clamp_to_edge.txt appendices/VK_EXT_acquire_xlib_display.txt appendices/VK_KHR_external_fence.txt appendices/VK_KHR_android_surface.txt appendices/VK_KHR_external_semaphore_win32.txt appendices/VK_AMD_memory_overallocation_behavior.txt appendices/VK_KHR_get_memory_requirements2.txt appendices/VK_ANDROID_external_memory_android_hardware_buffer.txt appendices/VK_NV_external_memory_capabilities.txt appendices/VK_EXT_astc_decode_mode.txt appendices/VK_GOOGLE_hlsl_functionality1.txt appendices/VK_KHR_external_semaphore_capabilities.txt appendices/VK_EXT_pipeline_creation_feedback.txt appendices/VK_NV_glsl_shader.txt appendices/VK_EXT_fragment_density_map.txt appendices/VK_KHR_push_descriptor.txt appendices/VK_KHR_external_memory.txt appendices/VK_KHR_depth_stencil_resolve.txt appendices/VK_NV_ray_tracing.txt appendices/VK_KHR_swapchain_mutable_format.txt appendices/VK_AMD_gpu_shader_int16.txt appendices/VK_KHR_maintenance3.txt appendices/VK_EXT_image_drm_format_modifier.txt appendices/VK_EXT_sampler_filter_minmax.txt appendices/VK_NV_external_memory.txt appendices/VK_KHR_relaxed_block_layout.txt appendices/VK_KHR_external_semaphore.txt appendices/VK_EXT_queue_family_foreign.txt appendices/VK_KHR_external_fence_fd.txt appendices/VK_EXT_separate_stencil_usage.txt appendices/VK_EXT_debug_utils.txt appendices/compressedtex.txt appendices/VK_AMD_shader_image_load_store_lod.txt appendices/VK_KHR_device_group.txt appendices/VK_KHR_descriptor_update_template.txt appendices/VK_KHR_external_memory_fd.txt appendices/VK_EXT_hdr_metadata.txt appendices/VK_KHR_maintenance2.txt appendices/VK_EXT_shader_subgroup_ballot.txt appendices/VK_AMD_shader_trinary_minmax.txt appendices/VK_AMD_texture_gather_bias_lod.txt appendices/VK_NV_external_memory_win32.txt appendices/VK_KHR_wayland_surface.txt appendices/VK_EXT_sample_locations.txt appendices/VK_IMG_format_pvrtc.txt appendices/glossary.txt appendices/VK_KHR_maintenance1.txt appendices/VK_EXT_shader_stencil_export.txt appendices/VK_KHR_bind_memory2.txt appendices/versions.txt appendices/VK_KHR_storage_buffer_storage_class.txt appendices/VK_KHR_shader_float_controls.txt appendices/VK_EXT_ycbcr_image_arrays.txt appendices/VK_EXT_external_memory_host.txt appendices/VK_EXT_post_depth_coverage.txt appendices/VK_AMD_mixed_attachment_samples.txt appendices/VK_AMD_draw_indirect_count.txt appendices/VK_NV_dedicated_allocation_image_aliasing.txt appendices/VK_NV_representative_fragment_test.txt appendices/VK_NV_corner_sampled_image.txt appendices/boilerplate.txt appendices/VK_EXT_descriptor_indexing.txt appendices/VK_AMD_shader_fragment_mask.txt appendices/VK_NV_framebuffer_mixed_samples.txt appendices/VK_EXT_depth_clip_enable.txt appendices/VK_KHR_swapchain.txt appendices/VK_KHR_get_display_properties2.txt appendices/VK_EXT_pci_bus_info.txt appendices/VK_EXT_metal_surface.txt appendices/VK_KHR_surface_protected_capabilities.txt appendices/VK_KHR_variable_pointers.txt appendices/VK_EXT_inline_uniform_block.txt appendices/VK_NV_fragment_coverage_to_color.txt appendices/VK_EXT_host_query_reset.txt appendices/VK_KHR_create_renderpass2.txt appendices/VK_MVK_macos_surface.txt appendices/VK_NV_viewport_array2.txt appendices/VK_EXT_debug_report.txt appendices/VK_EXT_transform_feedback.txt appendices/VK_AMD_shader_info.txt appendices/VK_FUCHSIA_imagepipe_surface.txt appendices/VK_EXT_vertex_attribute_divisor.txt appendices/VK_KHR_get_surface_capabilities2.txt appendices/VK_NVX_multiview_per_view_attributes.txt appendices/VK_AMD_buffer_marker.txt appendices/VK_AMD_shader_ballot.txt appendices/VK_EXT_validation_features.txt appendices/VK_KHR_win32_surface.txt appendices/VK_KHR_external_semaphore_fd.txt appendices/VK_KHR_draw_indirect_count.txt appendices/VK_EXT_filter_cubic.txt appendices/VK_GOOGLE_display_timing.txt appendices/VK_KHR_display_swapchain.txt appendices/VK_AMD_rasterization_order.txt appendices/VK_EXT_display_control.txt appendices/VK_AMD_display_native_hdr.txt appendices/VK_KHR_xcb_surface.txt appendices/VK_EXT_validation_flags.txt appendices/VK_KHR_8bit_storage.txt appendices/VK_KHR_display.txt appendices/VK_NV_geometry_shader_passthrough.txt appendices/VK_NV_clip_space_w_scaling.txt appendices/VK_KHR_shader_atomic_int64.txt appendices/credits.txt appendices/VK_NV_scissor_exclusive.txt appendices/VK_KHR_sampler_ycbcr_conversion.txt appendices/VK_NVX_image_view_handle.txt appendices/VK_EXT_shader_viewport_index_layer.txt appendices/extensions.txt appendices/VK_IMG_filter_cubic.txt appendices/VK_EXT_conditional_rendering.txt appendices/VK_KHR_xlib_surface.txt appendices/VK_NV_device_diagnostic_checkpoints.txt appendices/VK_KHR_dedicated_allocation.txt appendices/memorymodel.txt appendices/VK_KHR_16bit_storage.txt appendices/VK_NV_shader_subgroup_partitioned.txt appendices/VK_EXT_swapchain_colorspace.txt appendices/VK_GGP_frame_token.txt appendices/VK_NV_shader_image_footprint.txt appendices/VK_KHR_multiview.txt appendices/VK_EXT_discard_rectangles.txt appendices/VK_NV_dedicated_allocation.txt appendices/VK_NVX_device_generated_commands.txt appendices/VK_GGP_stream_descriptor_surface.txt appendices/VK_KHR_image_format_list.txt chapters/VK_NV_mesh_shader/drawing.txt chapters/VK_NV_mesh_shader/mesh.txt chapters/VK_EXT_display_surface_counter/surface_capabilities.txt chapters/VK_EXT_display_control/swapchain_counters.txt chapters/VK_EXT_display_control/fence_events.txt chapters/VK_EXT_display_control/display_control.txt chapters/VK_NV_win32_keyed_mutex/keyed_mutex_submit.txt chapters/VK_MVK_macos_surface/platformCreateSurface_macos.txt chapters/VK_MVK_macos_surface/platformQuerySupport_macos.txt chapters/VK_NVX_device_generated_commands/generation.txt chapters/VK_NVX_device_generated_commands/indirectcommands.txt chapters/VK_NVX_device_generated_commands/objecttable.txt chapters/VK_NVX_device_generated_commands/generatedcommands.txt chapters/VK_KHR_wayland_surface/platformCreateSurface_wayland.txt chapters/VK_KHR_wayland_surface/platformQuerySupport_wayland.txt chapters/VK_GGP_stream_descriptor_surface/platformCreateSurface_streamdescriptor.txt chapters/VK_GGP_stream_descriptor_surface/platformQuerySupport_streamdescriptor.txt chapters/VK_KHR_shared_presentable_image/wsi.txt chapters/VK_FUCHSIA_imagepipe_surface/platformCreateSurface_imagepipe.txt chapters/VK_FUCHSIA_imagepipe_surface/platformQuerySupport_imagepipe.txt chapters/VK_KHR_android_surface/platformCreateSurface_android.txt chapters/VK_KHR_android_surface/platformQuerySupport_android.txt chapters/VK_AMD_buffer_marker/copies.txt chapters/VK_KHR_win32_surface/platformCreateSurface_win32.txt chapters/VK_KHR_win32_surface/platformQuerySupport_win32.txt chapters/VK_NV_external_memory_capabilities/external_image_format.txt chapters/VK_EXT_direct_mode_display/acquire_release_displays.txt chapters/VK_KHR_display/display.txt chapters/VK_KHR_xlib_surface/platformCreateSurface_xlib.txt chapters/VK_KHR_xlib_surface/platformQuerySupport_xlib.txt chapters/VK_MVK_ios_surface/platformCreateSurface_ios.txt chapters/VK_MVK_ios_surface/platformQuerySupport_ios.txt chapters/VK_EXT_pipeline_creation_feedback/pipelines.txt chapters/VK_NV_ray_tracing/raytracing-shaders.txt chapters/VK_NV_ray_tracing/raytracing-resources.txt chapters/VK_NV_ray_tracing/raytracing-descriptors.txt chapters/VK_NV_ray_tracing/raytracing.txt chapters/VK_NV_ray_tracing/raytracing-pipelines.txt chapters/VK_NV_clip_space_w_scaling/vertexpostproc.txt chapters/VK_KHR_xcb_surface/platformCreateSurface_xcb.txt chapters/VK_KHR_xcb_surface/platformQuerySupport_xcb.txt chapters/VK_NV_external_memory_win32/get_handle_win32.txt chapters/VK_NV_external_memory_win32/handle_permissions.txt chapters/VK_NV_external_memory_win32/import_memory_win32.txt chapters/VK_NV_external_memory/allocate_memory.txt chapters/VK_EXT_acquire_xlib_display/acquire_xlib_display.txt chapters/VK_KHR_surface/wsi.txt chapters/VK_GOOGLE_display_timing/queries.txt chapters/VK_GOOGLE_display_timing/PresentTimeInfo.txt chapters/VK_NN_vi_surface/platformCreateSurface_vi.txt chapters/VK_NN_vi_surface/platformQuerySupport_vi.txt chapters/VK_KHR_incremental_present/wsi.txt chapters/VK_KHR_swapchain/wsi.txt chapters/VK_EXT_blend_operation_advanced/advanced_blend.txt chapters/VK_EXT_validation_cache/shader-module-validation-cache.txt chapters/VK_NV_device_diagnostic_checkpoints/device_diagnostic_checkpoints.txt chapters/VK_NV_device_diagnostic_checkpoints/queue_checkpoint_properties.txt chapters/VK_EXT_metal_surface/platformCreateSurface_metal.txt chapters/VK_EXT_metal_surface/platformQuerySupport_metal.txt chapters/VK_KHR_display_swapchain/create_shared_swapchains.txt chapters/VK_KHR_display_swapchain/display_swapchain_present.txt chapters/VK_KHR_display_swapchain/queue_present_interactions.txt chapters/VK_KHR_display_swapchain/destroy_swapchain_interactions.txt
asciidoctor: ERROR: apispec.txt: line 995: include file not found: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/VkAndroidSurfaceCreateFlagsKHR.txt
asciidoctor: ERROR: apispec.txt: line 1013: include file not found: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/VkDebugUtilsMessengerCallbackDataFlagsEXT.txt
asciidoctor: ERROR: apispec.txt: line 1014: include file not found: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/VkDebugUtilsMessengerCreateFlagsEXT.txt
asciidoctor: ERROR: apispec.txt: line 1024: include file not found: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/VkDisplayModeCreateFlagsKHR.txt
asciidoctor: ERROR: apispec.txt: line 1026: include file not found: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/VkDisplaySurfaceCreateFlagsKHR.txt
asciidoctor: ERROR: apispec.txt: line 1042: include file not found: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/VkIOSSurfaceCreateFlagsMVK.txt
asciidoctor: ERROR: apispec.txt: line 1045: include file not found: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/VkImagePipeSurfaceCreateFlagsFUCHSIA.txt
asciidoctor: ERROR: apispec.txt: line 1050: include file not found: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/VkMacOSSurfaceCreateFlagsMVK.txt
asciidoctor: ERROR: apispec.txt: line 1055: include file not found: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/VkMetalSurfaceCreateFlagsEXT.txt
asciidoctor: ERROR: apispec.txt: line 1096: include file not found: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/VkStreamDescriptorSurfaceCreateFlagsGGP.txt
asciidoctor: ERROR: apispec.txt: line 1103: include file not found: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/VkViSurfaceCreateFlagsNN.txt
asciidoctor: ERROR: apispec.txt: line 1104: include file not found: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/VkWaylandSurfaceCreateFlagsKHR.txt
asciidoctor: ERROR: apispec.txt: line 1105: include file not found: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/VkWin32SurfaceCreateFlagsKHR.txt
asciidoctor: ERROR: apispec.txt: line 1106: include file not found: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/VkXcbSurfaceCreateFlagsKHR.txt
asciidoctor: ERROR: apispec.txt: line 1107: include file not found: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/VkXlibSurfaceCreateFlagsKHR.txt
asciidoctor: WARNING: <stdin>: SVG does not exist or cannot be read: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/images/primitive_topology_key_vertex.svg
asciidoctor: WARNING: <stdin>: SVG does not exist or cannot be read: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/images/primitive_topology_key_vertex_number.svg
asciidoctor: WARNING: <stdin>: SVG does not exist or cannot be read: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/images/primitive_topology_key_provoking_vertex.svg
asciidoctor: WARNING: <stdin>: SVG does not exist or cannot be read: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/images/primitive_topology_key_edge.svg
asciidoctor: WARNING: <stdin>: SVG does not exist or cannot be read: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/images/primitive_topology_key_adjacency_edge.svg
asciidoctor: WARNING: <stdin>: SVG does not exist or cannot be read: /tmp/makepkg/sl1-vulkan-git/src/Vulkan-Docs/man/images/primitive_topology_key_winding_order.svg

greetings

oddhack commented 5 years ago

We are no longer publishing the single-document version of the refpages (the one generated from man/apispec.txt), as it's actually longer than the corresponding Vulkan specification proper, so it's not surprising it's starting to accumulate problems. This ought to get reflected in the Makefile, so I'll make this issue into a tracker to address that.

The WARNINGs about SVGs are a different issue and fixing them will require some changes to the core spec markup and the Makefile. I have an internal tracker already open about that but it's pretty low priority.

oddhack commented 5 years ago

For an interim workaround, you can use 'manhtmlpages' instead of 'manhtml'.

oddhack commented 5 years ago

I've made the docs/Makefile update described above in the 1.1.107 spec update, so closing this.

If you are actively using the single-document refpage build, we will likely accept PRs for fixes, but as noted we're not planning to maintain it ourselves.