[PATCH] meson: update doc logic for Windows
    Varghese, Vipin 
    Vipin.Varghese at amd.com
       
    Mon Mar 28 05:02:53 CEST 2022
    
    
  
[AMD Official Use Only]
Hi Thomas,
<snipp>
Thank you for looking at this problem.
26/03/2022 03:59, Vipin Varghese:
> Support for shell scripts doxy-html-custom, generate_doxygen and 
> generate_examples are absent. The current patch address the same by 
> disabling document build notifying the user.
It should not prevent generating guides with sphinx.
We did get error from `doc/meson` stating ` echo command not available on windows` for both cmd and powershell for the line
```
run_target('doc', command: [echo, message, doc_target_names],
    depends: doc_targets)
```
> Steps to reproduce the error:
>  - Install dependencies doxygen & sphinix build on Windwos server 2019.
>  - Build DPDK with option enable_docs=true for API or User Guide.
>
> This produces error
> ```
> FAILED: doc/api/examples.dox
> sh -e dpdk/doc/api/generate_examples.sh dpdk/examples 
> doc/api/examples.dox ```
I suppose we could replace shell scripts with Python equivalent.
I am trying to minimize the changes as first step: fix the build error by disabling on windows`.
Next step we can convert to python to make it cross platform independent.
    
    
More information about the dev
mailing list