Skip to content

Commit

Permalink
Changes to vma doc generation
Browse files Browse the repository at this point in the history
  • Loading branch information
expipiplus1 committed Oct 21, 2023
1 parent 2ebeb76 commit 2051853
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 9 deletions.
15 changes: 7 additions & 8 deletions generate-new/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,14 +32,13 @@ In an environment with `doxygen` (`nix-shell -p doxygen`), in the
`VulkanMemoryAllocator/VulkanMemoryAllocator` directory.

```bash
(cd src &&
sed -i -e 's|^GENERATE_DOCBOOK.*|GENERATE_DOCBOOK=YES|' \
-e 's|^BRIEF_MEMBER_DESC.*|BRIEF_MEMBER_DESC=NO|' \
-e 's|^PREDEFINED *=|PREDEFINED = VMA_STATS_STRING_ENABLED=1 |' \
-e 's|^PREDEFINED *=|PREDEFINED = VMA_EXTENDS_VK_STRUCT(s)=s |' \
-e 's|@CMAKE_SOURCE_DIR@/||' \
Doxyfile &&
doxygen Doxyfile)
sed -i -e 's|^GENERATE_DOCBOOK.*|GENERATE_DOCBOOK=YES|' \
-e 's|^BRIEF_MEMBER_DESC.*|BRIEF_MEMBER_DESC=NO|' \
-e 's|^PREDEFINED *=|PREDEFINED = VMA_STATS_STRING_ENABLED=1 |' \
-e 's|^PREDEFINED *=|PREDEFINED = VMA_EXTENDS_VK_STRUCT(s)=s |' \
-e 's|@CMAKE_SOURCE_DIR@/||' \
Doxyfile
nix-shell -p doxygen --run 'doxygen Doxyfile'
```

The docbook documentation will be in `docs/docbook`.
Expand Down
4 changes: 3 additions & 1 deletion scripts/regenerate.sh
Original file line number Diff line number Diff line change
Expand Up @@ -40,8 +40,10 @@ echo "Generating VMA documentation" &&
sed -i -e 's|^GENERATE_DOCBOOK.*|GENERATE_DOCBOOK=YES|' \
-e 's|^BRIEF_MEMBER_DESC.*|BRIEF_MEMBER_DESC=NO|' \
-e 's|^PREDEFINED *=|PREDEFINED = VMA_STATS_STRING_ENABLED=1 |' \
-e 's|^PREDEFINED *=|PREDEFINED = VMA_EXTENDS_VK_STRUCT(s)=s |' \
-e 's|@CMAKE_SOURCE_DIR@/||' \
Doxyfile &&
nix-shell -p cmake vulkan-headers vulkan-loader doxygen --run 'cmake . -DBUILD_DOCUMENTATION=ON && cmake --build . --target doc_doxygen' )
nix-shell -p doxygen --run 'doxygen Doxyfile')

echo "Generating Vulkan-Docs headers"
(cd generate-new/Vulkan-Docs/xml &&
Expand Down

0 comments on commit 2051853

Please sign in to comment.