1@ECHO OFF
2
3REM Command file for Sphinx documentation
4
5if "%SPHINXBUILD%" == "" (
6	set SPHINXBUILD=sphinx-build
7)
8set BUILDDIR=_build
9set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .
10set I18NSPHINXOPTS=%SPHINXOPTS% .
11if NOT "%PAPER%" == "" (
12	set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
13	set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
14)
15
16if "%1" == "" goto help
17
18if "%1" == "help" (
19	:help
20	echo.Please use `make ^<target^>` where ^<target^> is one of
21	echo.  html       to make standalone HTML files
22	echo.  dirhtml    to make HTML files named index.html in directories
23	echo.  singlehtml to make a single large HTML file
24	echo.  pickle     to make pickle files
25	echo.  json       to make JSON files
26	echo.  htmlhelp   to make HTML files and a HTML help project
27	echo.  qthelp     to make HTML files and a qthelp project
28	echo.  devhelp    to make HTML files and a Devhelp project
29	echo.  epub       to make an epub
30	echo.  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
31	echo.  text       to make text files
32	echo.  man        to make manual pages
33	echo.  texinfo    to make Texinfo files
34	echo.  gettext    to make PO message catalogs
35	echo.  changes    to make an overview over all changed/added/deprecated items
36	echo.  linkcheck  to check all external links for integrity
37	echo.  doctest    to run all doctests embedded in the documentation if enabled
38	goto end
39)
40
41if "%1" == "clean" (
42	for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
43	del /q /s %BUILDDIR%\*
44	goto end
45)
46
47if "%1" == "html" (
48	%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
49	if errorlevel 1 exit /b 1
50	echo.
51	echo.Build finished. The HTML pages are in %BUILDDIR%/html.
52	goto end
53)
54
55if "%1" == "dirhtml" (
56	%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
57	if errorlevel 1 exit /b 1
58	echo.
59	echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
60	goto end
61)
62
63if "%1" == "singlehtml" (
64	%SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
65	if errorlevel 1 exit /b 1
66	echo.
67	echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
68	goto end
69)
70
71if "%1" == "pickle" (
72	%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
73	if errorlevel 1 exit /b 1
74	echo.
75	echo.Build finished; now you can process the pickle files.
76	goto end
77)
78
79if "%1" == "json" (
80	%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
81	if errorlevel 1 exit /b 1
82	echo.
83	echo.Build finished; now you can process the JSON files.
84	goto end
85)
86
87if "%1" == "htmlhelp" (
88	%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
89	if errorlevel 1 exit /b 1
90	echo.
91	echo.Build finished; now you can run HTML Help Workshop with the ^
92.hhp project file in %BUILDDIR%/htmlhelp.
93	goto end
94)
95
96if "%1" == "qthelp" (
97	%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
98	if errorlevel 1 exit /b 1
99	echo.
100	echo.Build finished; now you can run "qcollectiongenerator" with the ^
101.qhcp project file in %BUILDDIR%/qthelp, like this:
102	echo.^> qcollectiongenerator %BUILDDIR%\qthelp\llvm.qhcp
103	echo.To view the help file:
104	echo.^> assistant -collectionFile %BUILDDIR%\qthelp\llvm.ghc
105	goto end
106)
107
108if "%1" == "devhelp" (
109	%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
110	if errorlevel 1 exit /b 1
111	echo.
112	echo.Build finished.
113	goto end
114)
115
116if "%1" == "epub" (
117	%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
118	if errorlevel 1 exit /b 1
119	echo.
120	echo.Build finished. The epub file is in %BUILDDIR%/epub.
121	goto end
122)
123
124if "%1" == "latex" (
125	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
126	if errorlevel 1 exit /b 1
127	echo.
128	echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
129	goto end
130)
131
132if "%1" == "text" (
133	%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
134	if errorlevel 1 exit /b 1
135	echo.
136	echo.Build finished. The text files are in %BUILDDIR%/text.
137	goto end
138)
139
140if "%1" == "man" (
141	%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
142	if errorlevel 1 exit /b 1
143	echo.
144	echo.Build finished. The manual pages are in %BUILDDIR%/man.
145	goto end
146)
147
148if "%1" == "texinfo" (
149	%SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
150	if errorlevel 1 exit /b 1
151	echo.
152	echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
153	goto end
154)
155
156if "%1" == "gettext" (
157	%SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
158	if errorlevel 1 exit /b 1
159	echo.
160	echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
161	goto end
162)
163
164if "%1" == "changes" (
165	%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
166	if errorlevel 1 exit /b 1
167	echo.
168	echo.The overview file is in %BUILDDIR%/changes.
169	goto end
170)
171
172if "%1" == "linkcheck" (
173	%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
174	if errorlevel 1 exit /b 1
175	echo.
176	echo.Link check complete; look for any errors in the above output ^
177or in %BUILDDIR%/linkcheck/output.txt.
178	goto end
179)
180
181if "%1" == "doctest" (
182	%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
183	if errorlevel 1 exit /b 1
184	echo.
185	echo.Testing of doctests in the sources finished, look at the ^
186results in %BUILDDIR%/doctest/output.txt.
187	goto end
188)
189
190:end
191