poxy 0.19.3__py3-none-any.whl → 0.19.5__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,590 +1,599 @@
1
- Metadata-Version: 2.1
2
- Name: poxy
3
- Version: 0.19.3
4
- Summary: Documentation generator for C++.
5
- Author-email: Mark Gillard <mark.gillard@outlook.com.au>
6
- License: MIT
7
- Project-URL: Source, https://github.com/marzer/poxy
8
- Project-URL: Tracker, https://github.com/marzer/poxy/issues
9
- Project-URL: Funding, https://github.com/sponsors/marzer
10
- Keywords: c++,doxygen,documentation
11
- Classifier: Development Status :: 4 - Beta
12
- Classifier: License :: OSI Approved :: MIT License
13
- Classifier: Programming Language :: C++
14
- Classifier: Topic :: Documentation
15
- Classifier: Topic :: Software Development :: Code Generators
16
- Classifier: Topic :: Software Development :: Documentation
17
- Classifier: Topic :: Utilities
18
- Requires-Python: >=3.7
19
- Description-Content-Type: text/markdown
20
- License-File: LICENSE.txt
21
- Requires-Dist: misk>=0.8.1
22
- Requires-Dist: bs4
23
- Requires-Dist: jinja2
24
- Requires-Dist: pygments
25
- Requires-Dist: html5lib
26
- Requires-Dist: lxml
27
- Requires-Dist: tomli
28
- Requires-Dist: schema!=0.7.5
29
- Requires-Dist: requests
30
- Requires-Dist: trieregex
31
- Requires-Dist: colorama
32
-
33
- # poxy
34
-
35
- Documentation generator for C++ based on Doxygen and [mosra/m.css](https://mcss.mosra.cz/).
36
-
37
- [![Sponsor](https://img.shields.io/static/v1?label=sponsor&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86&style=flat-square)][sponsor]
38
- [![Gitter](https://badges.gitter.im/marzer/poxy.svg)][gitter]
39
-
40
- - [Overview](#overview)
41
- - [Example](#example)
42
- - [Installation](#installation)
43
- - [Usage](#usage)
44
- - [Config file options](#config-file-options)
45
- - [Migrating from Doxygen](#migrating-from-doxygen)
46
- - [Why the name "Poxy"?](#why-the-name-poxy)
47
- - [License and Attribution](#license-and-attribution)
48
-
49
- <br><br>
50
-
51
- ## Overview
52
-
53
- [mosra/m.css] is a Doxygen-based documentation generator that significantly improves on Doxygen's default output
54
- by controlling some of Doxygen's more unruly options, supplying it's own slick HTML+CSS generation and adding
55
- a fantastic live search feature. **Poxy** builds upon both by:
56
-
57
- - Moving the configuration out into a TOML file
58
- - Preprocessing the Doxygen XML to fix a bunch of Doxygen _~~bugs~~_ quirks
59
- - Postprocessing the generated HTML to improve syntax highlighting and add a few other improvements
60
- - Allowing source, image and example directories to be recursive or shallow on a per-directory basis
61
- - Automatically defining C++ language feature macros based on your project's target C++ version
62
- - Automatically integrating the cppreference.com doxygen tagfile
63
- - Providing a number of additional built-in doxygen `@alias` commands
64
- - Giving more control over the HTML inline using square-bracket `[tags][/tags]`
65
- - Adding a switchable light theme
66
- - Adding support for C++20 concepts
67
- - Self-hosting fonts to reduce external HTTP requests
68
- - Inlining SVGs so they can take advantage of [`currentColor`]
69
- - Quite a bit more!
70
-
71
- <br><br>
72
-
73
- ## Example
74
-
75
- The homepage + documentation for [toml++] is built using poxy:
76
-
77
- - homepage: [marzer.github.io/tomlplusplus](https://marzer.github.io/tomlplusplus/)
78
- - config file: [`poxy.toml`](https://github.com/marzer/tomlplusplus/blob/master/docs/poxy.toml)
79
-
80
- <br><br>
81
-
82
- ## Installation
83
-
84
- ### Prerequisites:
85
-
86
- - Python 3.7+
87
- - Doxygen 1.8.20+ (must be visible on system path)
88
-
89
- ### Then:
90
-
91
- ```
92
- pip install poxy
93
- ```
94
-
95
- <br><br>
96
-
97
- ## Usage
98
-
99
- Poxy is a command-line application.
100
-
101
- ```
102
- usage: poxy [-h] [-v] [--html | --no-html] [--ppinclude <regex>] [--ppexclude <regex>]
103
- [--theme {light,dark,custom}] [--threads N] [--version] [--xml | --no-xml]
104
- [--werror | --no-werror] [--bug-report] [--git-tags]
105
- [--squash-patches | --no-squash-patches] [--min-version <version>]
106
- [config]
107
-
108
- _ __ _____ ___ _
109
- | '_ \ / _ \ \/ / | | |
110
- | |_) | (_) > <| |_| |
111
- | .__/ \___/_/\_\\__, |
112
- | | __/ |
113
- |_| |___/ v0.17.0 - github.com/marzer/poxy
114
-
115
- Generate fancy C++ documentation.
116
-
117
- positional arguments:
118
- config path to poxy.toml or a directory containing it (default: .)
119
-
120
- options:
121
- -h, --help show this help message and exit
122
- -v, --verbose enable very noisy diagnostic output
123
- --html, --no-html specify whether HTML output is required
124
- --ppinclude <regex> pattern matching HTML file names to post-process (default: all)
125
- --ppexclude <regex> pattern matching HTML file names to exclude from post-processing (default: None)
126
- --theme {light,dark,custom}
127
- sets the default visual theme (default: read from config)
128
- --threads N set the number of threads to use (default: automatic)
129
- --version print the version and exit
130
- --xml, --no-xml specify whether XML output is required
131
- --werror, --no-werror
132
- treat warnings as errors (default: read from config)
133
- --bug-report captures all output in a zip file for easier bug reporting.
134
- --git-tags add git-tag-based semver version switcher to the generated HTML
135
- --squash-patches, --no-squash-patches
136
- when using --git-tags and two version tags differ by a patch number,
137
- generate docs for the highest one only (default: True)
138
- --min-version <version>
139
- sets the minimum version number to emit when using --git-tags,
140
- or a negative integer to mean "the last N versions". (default: None)
141
- ```
142
-
143
- The basic three-step to using Poxy is similar to Doxygen:
144
-
145
- 1. Create your `poxy.toml` (Poxy's answer to the `Doxyfile`)
146
- 2. Invoke Poxy on it: `poxy path/to/poxy.toml` (or simply `poxy` if the cwd contains the config file)
147
- 3. See your HTML documentation `<cwd>/html`
148
-
149
- <br><br>
150
-
151
- ## Config file options
152
-
153
- For a self-contained `poxy.toml` example to copy and paste from,
154
- see [the one used by toml++](https://github.com/marzer/tomlplusplus/blob/master/docs/poxy.toml).
155
-
156
- For a full list of options, with full descriptions, schemas and usage examples, see the [Configuration options] wiki page.
157
-
158
- <br><br>
159
-
160
- ## Migrating from Doxygen
161
-
162
- Generally the relevant `Doxyfile` options will have a corresponding `poxy.toml` option
163
- (or be replaced by something more specific) so migration is largely a transcription and box-ticking exercise,
164
- though there are a few gotchas:
165
-
166
- #### **⚠&#xFE0F; The majority of Doxygen's options are controlled by Poxy**
167
-
168
- Many of Doxygen's various knobs and switches are manually overridden by Poxy, and are not configurable.
169
- **This is intentional!** Doxygen tends to break in hilarious and fantastic ways from one release to the next;
170
- reducing it to a very 'locked-down' back-end minimizes the damage future regressions can do, allowing me to
171
- keep most debugging python-side.
172
-
173
- If there is some Doxygen feature you would like exposed in Poxy, please create a [feature request].
174
-
175
- #### **⚠&#xFE0F; All relative input paths are relative to the config file, _not_ CWD**
176
-
177
- This is in contrast to Doxygen, which has all paths be relative to the Doxygen process' current working directory
178
- regardless of where the Doxyfile was. I've always personally found that to be nothing but a source of error,
179
- so Poxy does away with it.
180
-
181
- #### **⚠&#xFE0F; Output is always emitted to CWD**
182
-
183
- Poxy always emits HTML to `<cwd>/html` and XML to `<cwd>/xml`. You cannot use your config file to specify where any
184
- output will be placed - use your command-line environment for this purpose instead by changing the CWD.
185
- This is to eliminate nasty surprises brought on by goofy config file decisions and help with portability.
186
-
187
- #### **⚠&#xFE0F; Poxy config files are self-contained**
188
-
189
- There is no equivalent to Doxygen's `@INCLUDE`. If your project is structured in such a way that a
190
- multi-level Doxyfile hierarchy is necessary, Poxy isn't for you.
191
-
192
- <br><br>
193
-
194
- ## Why the name "Poxy"?
195
-
196
- Originally it was simply called "dox", but there's already a C++ documentation project with that name,
197
- so I smashed "python" and "dox" together and this is what I came up with.
198
-
199
- Also "poxy" can be slang for cheap, inferior, poor quality, etc., which I thought was funny.
200
-
201
- <br><br>
202
-
203
- ## License and Attribution
204
-
205
- This project is published under the terms of the [MIT license](https://github.com/marzer/poxy/blob/main/LICENSE.txt).
206
-
207
- Significant credit must go to Vladimír Vondruš ([mosra]) and his amazing [m.css] Doxygen theme.
208
- Poxy bundles a fork of m.css, used per the [MIT/Expat license](https://github.com/marzer/poxy/blob/main/poxy/data/m.css/COPYING)
209
- (which can also be found in the installed python package).
210
-
211
- [m.css]: https://mcss.mosra.cz/documentation/doxygen/
212
- [mosra]: https://github.com/mosra
213
- [mosra/m.css]: https://mcss.mosra.cz/documentation/doxygen/
214
- [toml++]: https://marzer.github.io/tomlplusplus/
215
- [c++ feature test macros]: https://en.cppreference.com/w/cpp/feature_test
216
- [configuration options]: https://github.com/marzer/poxy/wiki/Configuration-options
217
- [feature request]: https://github.com/marzer/poxy/issues/new
218
- [`currentcolor`]: https://gomakethings.com/currentcolor-and-svgs
219
- [gitter]: https://gitter.im/marzer/poxy
220
- [sponsor]: https://github.com/sponsors/marzer
221
-
222
- # Changelog
223
-
224
- ## v0.19.3 - 2024-11-11
225
-
226
- - fixed crash with nested C-style enums without a name (#39) (@tim-janik)
227
- - fixed `POXY_IMPLEMENTATION_DETAIL_IMPL` appearing in HTML in some circumstances
228
-
229
- ## v0.19.1 - 2024-10-30
230
-
231
- - fixed `ModuleNotFoundError` error in Python 3.12 (#38) (@dekinet)
232
-
233
- ## v0.19.0 - 2024-09-15
234
-
235
- - fixed crash when using simple type specifiers in friend declarations (#37) (@benjaminulmer)
236
- - added workaround for [this issue](https://github.com/mosra/m.css/issues/239) introduced in Doxygen 1.9.7
237
- - added auto-linking for various cppreference.com pages
238
- - made `--bug-report` keep a copy of the original (pre-pre-processed?) XML
239
- - updated m.css
240
-
241
- ## v0.18.0 - 2024-08-03
242
-
243
- - added config option `excluded_symbols` (a.k.a. Doxygen's `EXCLUDE_SYMBOLS`) (#36) (@Guekka)
244
-
245
- ## v0.17.2 - 2024-06-16
246
-
247
- - fixed qualified return types appearing squashed together without whitespace in some circumstances
248
- - fixed performance regression in post-process step
249
- - updated m.css
250
- - minor style fixes
251
-
252
- ## v0.17.1 - 2024-06-14
253
-
254
- - fixed `'tuple' object has no attribute 'week'` error on Python &lt;= 3.8
255
-
256
- ## v0.17.0 - 2024-04-21
257
-
258
- - added arguments `--min-version` and `--squash-patches` for more control over `--git-tags` mode
259
-
260
- ## v0.16.0 - 2024-01-28
261
-
262
- - added multi-version mode argument `--git-tags`
263
- - added colour to output
264
-
265
- ## v0.15.0 - 2023-12-08
266
-
267
- - added config option `main_page` (a.k.a. `USE_MDFILE_AS_MAINPAGE`)
268
- - fixed searching for `CHANGELOG` too far up the directory heirarchy (now stops when a `.git` folder is encountered)
269
-
270
- ## v0.14.0 - 2023-11-25
271
-
272
- - added the use of `*` wildcards in `implementation_headers`
273
-
274
- ## v0.13.9 - 2023-09-10
275
-
276
- - fixed crash on Doxygen &lt;= 1.8.17 (#33) (@tim-janik)
277
-
278
- ## v0.13.8 - 2023-09-09
279
-
280
- - fixed regression for Python &lt;= 3.8 (#32) (@tim-janik)
281
-
282
- ## v0.13.7 - 2023-08-17
283
-
284
- - fixed minor syntax highlighting issues
285
-
286
- ## v0.13.6 - 2023-08-10
287
-
288
- - update m.css to fix libgs.so lookup (#31) (@wroyca, @mosra)
289
-
290
- ## v0.13.5 - 2023-08-09
291
-
292
- - fixed `--bug-report` regression (#29) (@wroyca)
293
-
294
- ## v0.13.4 - 2023-08-06
295
-
296
- - fixed excessive `template<>` noise in details views
297
-
298
- ## v0.13.3 - 2023-08-01
299
-
300
- - fixed floating TOCs sometimes clipping off the bottom of the screen when the viewport was vertically narrow
301
-
302
- ## v0.13.2 - 2023-07-31
303
-
304
- - fixed doxygen's `@ref` links to `#id` anchors on the same page being treated as external links
305
- - added auto-linking for C++ [named requirements](https://en.cppreference.com/w/cpp/named_req)
306
- - minor style fixes
307
-
308
- ## v0.13.1 - 2023-07-29
309
-
310
- - fixed crash regression with Doxygen 1.9.7
311
- - fixed issues with \[tag\] substitution
312
- - minor style fixes
313
-
314
- ## v0.13.0 - 2023-07-28
315
-
316
- - migrated to `pyproject.toml`
317
- - fixed footer being off-center (#24) (@wroyca)
318
- - fixed redundant `auto` in trailing return types (#26) (@wroyca)
319
- - added config option `sponsor`
320
- - added config option `twitter`
321
-
322
- ## v0.12.7 - 2023-07-27
323
-
324
- - allowed the use of square-bracket \[tags\] in more places
325
-
326
- ## v0.12.6 - 2023-07-25
327
-
328
- - fixed overlong `template<>` lines in summary views
329
- - fixed function parameter names greedily wrapping in details tables
330
-
331
- ## v0.12.5 - 2023-07-20
332
-
333
- - fixed overlong `template<>` lines in page headers (they now wrap)
334
-
335
- ## v0.12.4 - 2023-03-23
336
-
337
- - fixed changelog not auto-linking with some versions of Doxygen
338
-
339
- ## v0.12.3 - 2023-02-09
340
-
341
- - fixed backwards-incompatible use of a newer `argparse` feature on Python &lt;= 3.8 (#20) (@fwerner)
342
-
343
- ## v0.12.2 - 2023-02-08
344
-
345
- - switched default TOML lib to `tomli`
346
-
347
- ## v0.12.1 - 2022-11-22
348
-
349
- - fixed `github` and `gitlab` config options not accepting periods (`.`)
350
-
351
- ## v0.12.0 - 2022-11-13
352
-
353
- - fixed `AttributeError` during XML post-processing (#17) (@wroyca)
354
- - added command-line option `--bug-report`
355
- - improved diagnostic text in some areas
356
-
357
- ## v0.11.1 - 2022-10-23
358
-
359
- - fixed crash when using `<a>` tags in navbar
360
-
361
- ## v0.11.0 - 2022-10-21
362
-
363
- - added syntax highlighting for functions
364
- - improved syntax highlighting of typenames
365
-
366
- ## v0.10.2 - 2022-10-16
367
-
368
- - fixed crash when tagfile is disabled
369
- - fixed a few syntax highlighting edge-cases
370
- - fixed non-determinism in XML output formatting
371
- - improved performance of syntax highlighting post-process
372
- - minor style fixes
373
-
374
- ## v0.10.1 - 2022-10-15
375
-
376
- - minor style fixes
377
-
378
- ## v0.10.0 - 2022-10-14
379
-
380
- - fixed `static` keyword sometimes appearing twice on variables
381
- - fixed `constexpr` keyword sometimes leaking into variable type
382
- - fixed newer versions of pygments adding unnecessary markup to whitespace
383
- - fixed malformed trailing return types in some circumstances
384
- - fixed changelog page sometimes not having a table-of-contents
385
- - added support for C++20's `constinit`
386
- - added fallback to `tomllib` or `tomli` if `pytomlpp` is not available
387
- - added command-line options `--html`, `--no-html`
388
- - added command-line options `--xml`, `--no-xml`
389
- - added command-line option `--no-werror`
390
- - added `CHANGES` to the set of candidate changelog filenames
391
- - deprecated command-line option `--xmlonly`
392
- - removed command-line option `--doxygen`
393
-
394
- ## v0.9.1 - 2022-10-04
395
-
396
- - fixed SVG inlining not preserving original image class attributes
397
- - fixed `ValueError` when reading some SVG files
398
- - fixed `navbar` option allowing duplicates
399
- - fixed custom navbar items always being transformed to lowercase
400
- - fixed navbar generating links to empty pages
401
- - added `concepts` to the default set of links in `navbar`
402
- - added `navbar` values `all` and `default`
403
- - reduced I/O churn during HTML post-processing
404
- - removed command-line option `--dry`
405
-
406
- ## v0.9.0 - 2022-10-03
407
-
408
- - added support for C++20 concepts
409
-
410
- ## v0.8.2 - 2022-10-01
411
-
412
- - added post-process to inline all local SVGs
413
- - minor style fixes
414
-
415
- ## v0.8.1 - 2022-09-30
416
-
417
- - minor style fixes
418
-
419
- ## v0.8.0 - 2022-09-29
420
-
421
- - added config option `gitlab` (#13) (@wroyca)
422
- - added ixx module extension in source patterns (#11) (@wroyca)
423
- - added support for multi-codepoint emojis
424
- - improved `doxygen.exe` location discovery on Windows
425
- - improved `CHANGELOG` location discovery
426
- - moved all poxy assets in the generated HTML to `html/poxy`
427
- - self-hosted google fonts in generated HTML (instead of requiring additional HTTP requests on page load) (#6)
428
- - removed ability to override m.css implementation
429
- - removed legacy support for reading config options from neighbouring Doxyfiles
430
- - overhauled the light theme
431
- - many minor style fixes and tweaks
432
-
433
- ## v0.7.1 - 2022-08-17
434
-
435
- - fixed crash on python &lt;= 3.8 (#9) (@wroyca)
436
-
437
- ## v0.7.0 - 2022-08-16
438
-
439
- - fixed some `<link>`, `<meta>` and `<script>` tags not being included in `<head>` when a file was excluded from post-processing
440
- - added `theme` command-line option
441
- - added `html_header` config option option
442
- - added automatic generation of github links in changelog when config option `github` is set
443
- - added new light theme
444
- - added dynamic switch for dark/light theme
445
- - removed text from github icon on navbar (#5) (@wroyca)
446
- - removed excessive spacing between article sections (#5) (@wroyca)
447
- - many minor style fixes and tweaks
448
-
449
- ## v0.6.1 - 2022-08-16
450
-
451
- - fixed multi-row navbar occluding page content (#3) (@wroyca)
452
-
453
- ## v0.6.0 - 2022-08-14
454
-
455
- - fixed malformed error messages in some circumstances
456
- - added builtin C++ standard macros for C++23
457
- - added `changelog` config option
458
- - updated cppreference.com tagfile
459
-
460
- ## v0.5.7 - 2022-05-17
461
-
462
- - fixed being able to pass >= 33 threads to Doxygen's `NUM_PROC_THREADS`
463
-
464
- ## v0.5.6 - 2022-05-14
465
-
466
- - fixed path error when using `--dry`
467
- - fixed `friend` keyword sometimes leaking into function return types
468
- - added additional language code block aliases
469
- - added `--nocleanup` to `--help` output
470
- - added support for C++20's `consteval` keyword
471
-
472
- ## v0.5.5 - 2022-04-16
473
-
474
- - fixed C++20 concepts causing a crash in m.css (they are now skipped with a warning) (#1) (@jake-arkinstall)
475
-
476
- ## v0.5.4 - 2022-04-15
477
-
478
- - updated m.css
479
- - updated emoji database
480
-
481
- ## v0.5.3 - 2021-12-12
482
-
483
- - fixed Doxygen bug that would sometimes treat keywords like `friend` as part of a function's return type
484
- - Blacklisted schema 0.7.5 because [it's broken](https://github.com/keleshev/schema/issues/272)
485
-
486
- ## v0.5.2 - 2021-11-02
487
-
488
- - fixed over-eager link-replacement for internal `#anchor` links
489
- - added command-line options `--ppinclude` and `--ppexclude`
490
-
491
- ## v0.5.1 - 2021-10-09
492
-
493
- - fixed over-eager link replacement causing text to be deleted
494
-
495
- ## v0.5.0 - 2021-09-11
496
-
497
- - fixed a crash during HTML post-processing
498
- - fixed `implementation_headers` not working when paths use backslashes
499
- - added warnings when `implementation_headers` doesn't match anything
500
-
501
- ## v0.4.5 - 2021-06-08
502
-
503
- - added command-line option `--xmlonly`
504
-
505
- ## v0.4.3 - 2021-05-31
506
-
507
- - fixed regression in `[code_blocks]` functionality
508
- - fixed minor issues in syntax highlighter
509
- - added symbols from doxygen tagfiles to the syntax highlighter
510
- - minor style tweaks
511
-
512
- ## v0.4.1 - 2021-05-30
513
-
514
- - fixed `.dirs` being glommed as source paths
515
- - added config option `scripts`
516
- - added config option `stylesheets`
517
- - added config option `jquery`
518
- - added `custom` theme
519
- - added ability to use `HOME.md` as main page
520
- - added additional fix for inline `<code>` blocks
521
- - added `.poxy-toc` to table-of-contents elements
522
- - added floating page table-of-contents
523
- - removed m.css favicon fallback
524
- - made improvements to the `light` and `dark` themes
525
- - updated C++ doxygen tagfile
526
-
527
- ## v0.4.0 - 2021-05-29
528
-
529
- - added config option `theme`
530
- - added version number to CSS and javascript filenames to prevent browser cache issues
531
- - added `POXY_IMPLEMENTATION_DETAIL(...)` magic macro
532
- - added `POXY_IGNORE(...)` magic macro
533
- - fixed alignment of nested images inside detail blocks
534
-
535
- ## v0.3.4 - 2021-05-28
536
-
537
- - added basic `using` alias detection to syntax highlighter
538
- - added missing badges for C++23, 26 and 29
539
-
540
- ## v0.3.3 - 2021-05-23
541
-
542
- - fixed sorting of namespace and group members
543
- - fixed m.css failing with new versions of doxygen due to `Doxyfile.xml`
544
- - added google structured data to `\pages`
545
-
546
- ## v0.3.2 - 2021-05-19
547
-
548
- - fixed formatting of `<meta>` tags
549
- - added config option `author`
550
- - added config option `robots`
551
- - added markup tag `[p]`
552
- - added markup tag `[center]`
553
-
554
- ## v0.3.1 - 2021-05-13
555
-
556
- - added config option `macros`
557
- - added command-line option `--version`
558
-
559
- ## v0.3.0 - 2021-05-09
560
-
561
- - Improved handling of m.css and Doxygen warnings and errors
562
- - added command-line option `--doxygen`
563
- - added command-line option `--werror`
564
- - added markup tag `[set_parent_class]`
565
- - added markup tag `[add_parent_class]`
566
- - added markup tag `[remove_parent_class]`
567
- - added config option `images`
568
- - added config option `examples`
569
- - added ability to specify tagfiles as URIs
570
-
571
- ## v0.2.1 - 2021-05-07
572
-
573
- - fixed some minor autolinking issues
574
-
575
- ## v0.2.0 - 2021-05-06
576
-
577
- - added config option `source_patterns`
578
-
579
- ## v0.1.2 - 2021-05-02
580
-
581
- - fixed the Z-order of the nav bar being higher than the search overlay
582
- - added `NDEBUG` to the default set of defines
583
-
584
- ## v0.1.1 - 2021-04-26
585
-
586
- - added an additional cleanup step to the HTML postprocessor
587
-
588
- ## v0.1.0 - 2021-04-26
589
-
590
- First public release :tada:
1
+ Metadata-Version: 2.4
2
+ Name: poxy
3
+ Version: 0.19.5
4
+ Summary: Documentation generator for C++.
5
+ Author-email: Mark Gillard <mark.gillard@outlook.com.au>
6
+ License-Expression: MIT
7
+ Project-URL: Source, https://github.com/marzer/poxy
8
+ Project-URL: Tracker, https://github.com/marzer/poxy/issues
9
+ Project-URL: Funding, https://github.com/sponsors/marzer
10
+ Keywords: c++,doxygen,documentation
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Programming Language :: C++
13
+ Classifier: Topic :: Documentation
14
+ Classifier: Topic :: Software Development :: Code Generators
15
+ Classifier: Topic :: Software Development :: Documentation
16
+ Classifier: Topic :: Utilities
17
+ Requires-Python: >=3.7
18
+ Description-Content-Type: text/markdown
19
+ License-File: LICENSE.txt
20
+ Requires-Dist: misk>=0.8.1
21
+ Requires-Dist: bs4
22
+ Requires-Dist: jinja2
23
+ Requires-Dist: pygments
24
+ Requires-Dist: html5lib
25
+ Requires-Dist: lxml
26
+ Requires-Dist: tomli
27
+ Requires-Dist: schema!=0.7.5
28
+ Requires-Dist: requests
29
+ Requires-Dist: trieregex
30
+ Requires-Dist: colorama
31
+ Dynamic: license-file
32
+
33
+ # poxy
34
+
35
+ Documentation generator for C++ based on Doxygen and [mosra/m.css](https://mcss.mosra.cz/).
36
+
37
+ [![Sponsor](https://img.shields.io/static/v1?label=sponsor&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86&style=flat-square)][sponsor]
38
+ [![Gitter](https://badges.gitter.im/marzer/poxy.svg)][gitter]
39
+
40
+ - [Overview](#overview)
41
+ - [Example](#example)
42
+ - [Installation](#installation)
43
+ - [Usage](#usage)
44
+ - [Config file options](#config-file-options)
45
+ - [Migrating from Doxygen](#migrating-from-doxygen)
46
+ - [Why the name "Poxy"?](#why-the-name-poxy)
47
+ - [License and Attribution](#license-and-attribution)
48
+
49
+ <br><br>
50
+
51
+ ## Overview
52
+
53
+ [mosra/m.css] is a Doxygen-based documentation generator that significantly improves on Doxygen's default output
54
+ by controlling some of Doxygen's more unruly options, supplying it's own slick HTML+CSS generation and adding
55
+ a fantastic live search feature. **Poxy** builds upon both by:
56
+
57
+ - Moving the configuration out into a TOML file
58
+ - Preprocessing the Doxygen XML to fix a bunch of Doxygen _~~bugs~~_ quirks
59
+ - Postprocessing the generated HTML to improve syntax highlighting and add a few other improvements
60
+ - Allowing source, image and example directories to be recursive or shallow on a per-directory basis
61
+ - Automatically defining C++ language feature macros based on your project's target C++ version
62
+ - Automatically integrating the cppreference.com doxygen tagfile
63
+ - Providing a number of additional built-in doxygen `@alias` commands
64
+ - Giving more control over the HTML inline using square-bracket `[tags][/tags]`
65
+ - Adding a switchable light theme
66
+ - Adding support for C++20 concepts
67
+ - Self-hosting fonts to reduce external HTTP requests
68
+ - Inlining SVGs so they can take advantage of [`currentColor`]
69
+ - Quite a bit more!
70
+
71
+ <br><br>
72
+
73
+ ## Example
74
+
75
+ The homepage + documentation for [toml++] is built using poxy:
76
+
77
+ - homepage: [marzer.github.io/tomlplusplus](https://marzer.github.io/tomlplusplus/)
78
+ - config file: [`poxy.toml`](https://github.com/marzer/tomlplusplus/blob/master/docs/poxy.toml)
79
+
80
+ <br><br>
81
+
82
+ ## Installation
83
+
84
+ ### Prerequisites:
85
+
86
+ - Python 3.7+
87
+ - Doxygen 1.8.20+ (must be visible on system path)
88
+ - Linux only: `sudo apt install dvisvgm`
89
+
90
+ ### Then:
91
+
92
+ ```
93
+ pip install poxy
94
+ ```
95
+
96
+ <br><br>
97
+
98
+ ## Usage
99
+
100
+ Poxy is a command-line application.
101
+
102
+ ```
103
+ usage: poxy [-h] [-v] [--html | --no-html] [--ppinclude <regex>] [--ppexclude <regex>]
104
+ [--theme {light,dark,custom}] [--threads N] [--version] [--xml | --no-xml]
105
+ [--werror | --no-werror] [--bug-report] [--git-tags]
106
+ [--squash-patches | --no-squash-patches] [--min-version <version>]
107
+ [config]
108
+
109
+ _ __ _____ ___ _
110
+ | '_ \ / _ \ \/ / | | |
111
+ | |_) | (_) > <| |_| |
112
+ | .__/ \___/_/\_\\__, |
113
+ | | __/ |
114
+ |_| |___/ v0.17.0 - github.com/marzer/poxy
115
+
116
+ Generate fancy C++ documentation.
117
+
118
+ positional arguments:
119
+ config path to poxy.toml or a directory containing it (default: .)
120
+
121
+ options:
122
+ -h, --help show this help message and exit
123
+ -v, --verbose enable very noisy diagnostic output
124
+ --html, --no-html specify whether HTML output is required
125
+ --ppinclude <regex> pattern matching HTML file names to post-process (default: all)
126
+ --ppexclude <regex> pattern matching HTML file names to exclude from post-processing (default: None)
127
+ --theme {light,dark,custom}
128
+ sets the default visual theme (default: read from config)
129
+ --threads N set the number of threads to use (default: automatic)
130
+ --version print the version and exit
131
+ --xml, --no-xml specify whether XML output is required
132
+ --werror, --no-werror
133
+ treat warnings as errors (default: read from config)
134
+ --bug-report captures all output in a zip file for easier bug reporting.
135
+ --git-tags add git-tag-based semver version switcher to the generated HTML
136
+ --squash-patches, --no-squash-patches
137
+ when using --git-tags and two version tags differ by a patch number,
138
+ generate docs for the highest one only (default: True)
139
+ --min-version <version>
140
+ sets the minimum version number to emit when using --git-tags,
141
+ or a negative integer to mean "the last N versions". (default: None)
142
+ ```
143
+
144
+ The basic three-step to using Poxy is similar to Doxygen:
145
+
146
+ 1. Create your `poxy.toml` (Poxy's answer to the `Doxyfile`)
147
+ 2. Invoke Poxy on it: `poxy path/to/poxy.toml` (or simply `poxy` if the cwd contains the config file)
148
+ 3. See your HTML documentation `<cwd>/html`
149
+
150
+ <br><br>
151
+
152
+ ## Config file options
153
+
154
+ For a self-contained `poxy.toml` example to copy and paste from,
155
+ see [the one used by toml++](https://github.com/marzer/tomlplusplus/blob/master/docs/poxy.toml).
156
+
157
+ For a full list of options, with full descriptions, schemas and usage examples, see the [Configuration options] wiki page.
158
+
159
+ <br><br>
160
+
161
+ ## Migrating from Doxygen
162
+
163
+ Generally the relevant `Doxyfile` options will have a corresponding `poxy.toml` option
164
+ (or be replaced by something more specific) so migration is largely a transcription and box-ticking exercise,
165
+ though there are a few gotchas:
166
+
167
+ #### **⚠&#xFE0F; The majority of Doxygen's options are controlled by Poxy**
168
+
169
+ Many of Doxygen's various knobs and switches are manually overridden by Poxy, and are not configurable.
170
+ **This is intentional!** Doxygen tends to break in hilarious and fantastic ways from one release to the next;
171
+ reducing it to a very 'locked-down' back-end minimizes the damage future regressions can do, allowing me to
172
+ keep most debugging python-side.
173
+
174
+ If there is some Doxygen feature you would like exposed in Poxy, please create a [feature request].
175
+
176
+ #### **⚠&#xFE0F; All relative input paths are relative to the config file, _not_ CWD**
177
+
178
+ This is in contrast to Doxygen, which has all paths be relative to the Doxygen process' current working directory
179
+ regardless of where the Doxyfile was. I've always personally found that to be nothing but a source of error,
180
+ so Poxy does away with it.
181
+
182
+ #### **⚠&#xFE0F; Output is always emitted to CWD**
183
+
184
+ Poxy always emits HTML to `<cwd>/html` and XML to `<cwd>/xml`. You cannot use your config file to specify where any
185
+ output will be placed - use your command-line environment for this purpose instead by changing the CWD.
186
+ This is to eliminate nasty surprises brought on by goofy config file decisions and help with portability.
187
+
188
+ #### **⚠&#xFE0F; Poxy config files are self-contained**
189
+
190
+ There is no equivalent to Doxygen's `@INCLUDE`. If your project is structured in such a way that a
191
+ multi-level Doxyfile hierarchy is necessary, Poxy isn't for you.
192
+
193
+ <br><br>
194
+
195
+ ## Why the name "Poxy"?
196
+
197
+ Originally it was simply called "dox", but there's already a C++ documentation project with that name,
198
+ so I smashed "python" and "dox" together and this is what I came up with.
199
+
200
+ Also "poxy" can be slang for cheap, inferior, poor quality, etc., which I thought was funny.
201
+
202
+ <br><br>
203
+
204
+ ## License and Attribution
205
+
206
+ This project is published under the terms of the [MIT license](https://github.com/marzer/poxy/blob/main/LICENSE.txt).
207
+
208
+ Significant credit must go to Vladimír Vondruš ([mosra]) and his amazing [m.css] Doxygen theme.
209
+ Poxy bundles a fork of m.css, used per the [MIT/Expat license](https://github.com/marzer/poxy/blob/main/poxy/data/m.css/COPYING)
210
+ (which can also be found in the installed python package).
211
+
212
+ [m.css]: https://mcss.mosra.cz/documentation/doxygen/
213
+ [mosra]: https://github.com/mosra
214
+ [mosra/m.css]: https://mcss.mosra.cz/documentation/doxygen/
215
+ [toml++]: https://marzer.github.io/tomlplusplus/
216
+ [c++ feature test macros]: https://en.cppreference.com/w/cpp/feature_test
217
+ [configuration options]: https://github.com/marzer/poxy/wiki/Configuration-options
218
+ [feature request]: https://github.com/marzer/poxy/issues/new
219
+ [`currentcolor`]: https://gomakethings.com/currentcolor-and-svgs
220
+ [gitter]: https://gitter.im/marzer/poxy
221
+ [sponsor]: https://github.com/sponsors/marzer
222
+
223
+ # Changelog
224
+
225
+ ## v0.19.5 - 2025-06-28
226
+
227
+ - fixed code blocks losing their file type with some versions of doxygen
228
+
229
+ ## v0.19.4 - 2024-12-24
230
+
231
+ - fixed minor issues on Python 3.8
232
+
233
+ ## v0.19.3 - 2024-11-11
234
+
235
+ - fixed crash with nested C-style enums without a name (#39) (@tim-janik)
236
+ - fixed `POXY_IMPLEMENTATION_DETAIL_IMPL` appearing in HTML in some circumstances
237
+
238
+ ## v0.19.1 - 2024-10-30
239
+
240
+ - fixed `ModuleNotFoundError` error in Python 3.12 (#38) (@dekinet)
241
+
242
+ ## v0.19.0 - 2024-09-15
243
+
244
+ - fixed crash when using simple type specifiers in friend declarations (#37) (@benjaminulmer)
245
+ - added workaround for [this issue](https://github.com/mosra/m.css/issues/239) introduced in Doxygen 1.9.7
246
+ - added auto-linking for various cppreference.com pages
247
+ - made `--bug-report` keep a copy of the original (pre-pre-processed?) XML
248
+ - updated m.css
249
+
250
+ ## v0.18.0 - 2024-08-03
251
+
252
+ - added config option `excluded_symbols` (a.k.a. Doxygen's `EXCLUDE_SYMBOLS`) (#36) (@Guekka)
253
+
254
+ ## v0.17.2 - 2024-06-16
255
+
256
+ - fixed qualified return types appearing squashed together without whitespace in some circumstances
257
+ - fixed performance regression in post-process step
258
+ - updated m.css
259
+ - minor style fixes
260
+
261
+ ## v0.17.1 - 2024-06-14
262
+
263
+ - fixed `'tuple' object has no attribute 'week'` error on Python &lt;= 3.8
264
+
265
+ ## v0.17.0 - 2024-04-21
266
+
267
+ - added arguments `--min-version` and `--squash-patches` for more control over `--git-tags` mode
268
+
269
+ ## v0.16.0 - 2024-01-28
270
+
271
+ - added multi-version mode argument `--git-tags`
272
+ - added colour to output
273
+
274
+ ## v0.15.0 - 2023-12-08
275
+
276
+ - added config option `main_page` (a.k.a. `USE_MDFILE_AS_MAINPAGE`)
277
+ - fixed searching for `CHANGELOG` too far up the directory heirarchy (now stops when a `.git` folder is encountered)
278
+
279
+ ## v0.14.0 - 2023-11-25
280
+
281
+ - added the use of `*` wildcards in `implementation_headers`
282
+
283
+ ## v0.13.9 - 2023-09-10
284
+
285
+ - fixed crash on Doxygen &lt;= 1.8.17 (#33) (@tim-janik)
286
+
287
+ ## v0.13.8 - 2023-09-09
288
+
289
+ - fixed regression for Python &lt;= 3.8 (#32) (@tim-janik)
290
+
291
+ ## v0.13.7 - 2023-08-17
292
+
293
+ - fixed minor syntax highlighting issues
294
+
295
+ ## v0.13.6 - 2023-08-10
296
+
297
+ - update m.css to fix libgs.so lookup (#31) (@wroyca, @mosra)
298
+
299
+ ## v0.13.5 - 2023-08-09
300
+
301
+ - fixed `--bug-report` regression (#29) (@wroyca)
302
+
303
+ ## v0.13.4 - 2023-08-06
304
+
305
+ - fixed excessive `template<>` noise in details views
306
+
307
+ ## v0.13.3 - 2023-08-01
308
+
309
+ - fixed floating TOCs sometimes clipping off the bottom of the screen when the viewport was vertically narrow
310
+
311
+ ## v0.13.2 - 2023-07-31
312
+
313
+ - fixed doxygen's `@ref` links to `#id` anchors on the same page being treated as external links
314
+ - added auto-linking for C++ [named requirements](https://en.cppreference.com/w/cpp/named_req)
315
+ - minor style fixes
316
+
317
+ ## v0.13.1 - 2023-07-29
318
+
319
+ - fixed crash regression with Doxygen 1.9.7
320
+ - fixed issues with \[tag\] substitution
321
+ - minor style fixes
322
+
323
+ ## v0.13.0 - 2023-07-28
324
+
325
+ - migrated to `pyproject.toml`
326
+ - fixed footer being off-center (#24) (@wroyca)
327
+ - fixed redundant `auto` in trailing return types (#26) (@wroyca)
328
+ - added config option `sponsor`
329
+ - added config option `twitter`
330
+
331
+ ## v0.12.7 - 2023-07-27
332
+
333
+ - allowed the use of square-bracket \[tags\] in more places
334
+
335
+ ## v0.12.6 - 2023-07-25
336
+
337
+ - fixed overlong `template<>` lines in summary views
338
+ - fixed function parameter names greedily wrapping in details tables
339
+
340
+ ## v0.12.5 - 2023-07-20
341
+
342
+ - fixed overlong `template<>` lines in page headers (they now wrap)
343
+
344
+ ## v0.12.4 - 2023-03-23
345
+
346
+ - fixed changelog not auto-linking with some versions of Doxygen
347
+
348
+ ## v0.12.3 - 2023-02-09
349
+
350
+ - fixed backwards-incompatible use of a newer `argparse` feature on Python &lt;= 3.8 (#20) (@fwerner)
351
+
352
+ ## v0.12.2 - 2023-02-08
353
+
354
+ - switched default TOML lib to `tomli`
355
+
356
+ ## v0.12.1 - 2022-11-22
357
+
358
+ - fixed `github` and `gitlab` config options not accepting periods (`.`)
359
+
360
+ ## v0.12.0 - 2022-11-13
361
+
362
+ - fixed `AttributeError` during XML post-processing (#17) (@wroyca)
363
+ - added command-line option `--bug-report`
364
+ - improved diagnostic text in some areas
365
+
366
+ ## v0.11.1 - 2022-10-23
367
+
368
+ - fixed crash when using `<a>` tags in navbar
369
+
370
+ ## v0.11.0 - 2022-10-21
371
+
372
+ - added syntax highlighting for functions
373
+ - improved syntax highlighting of typenames
374
+
375
+ ## v0.10.2 - 2022-10-16
376
+
377
+ - fixed crash when tagfile is disabled
378
+ - fixed a few syntax highlighting edge-cases
379
+ - fixed non-determinism in XML output formatting
380
+ - improved performance of syntax highlighting post-process
381
+ - minor style fixes
382
+
383
+ ## v0.10.1 - 2022-10-15
384
+
385
+ - minor style fixes
386
+
387
+ ## v0.10.0 - 2022-10-14
388
+
389
+ - fixed `static` keyword sometimes appearing twice on variables
390
+ - fixed `constexpr` keyword sometimes leaking into variable type
391
+ - fixed newer versions of pygments adding unnecessary markup to whitespace
392
+ - fixed malformed trailing return types in some circumstances
393
+ - fixed changelog page sometimes not having a table-of-contents
394
+ - added support for C++20's `constinit`
395
+ - added fallback to `tomllib` or `tomli` if `pytomlpp` is not available
396
+ - added command-line options `--html`, `--no-html`
397
+ - added command-line options `--xml`, `--no-xml`
398
+ - added command-line option `--no-werror`
399
+ - added `CHANGES` to the set of candidate changelog filenames
400
+ - deprecated command-line option `--xmlonly`
401
+ - removed command-line option `--doxygen`
402
+
403
+ ## v0.9.1 - 2022-10-04
404
+
405
+ - fixed SVG inlining not preserving original image class attributes
406
+ - fixed `ValueError` when reading some SVG files
407
+ - fixed `navbar` option allowing duplicates
408
+ - fixed custom navbar items always being transformed to lowercase
409
+ - fixed navbar generating links to empty pages
410
+ - added `concepts` to the default set of links in `navbar`
411
+ - added `navbar` values `all` and `default`
412
+ - reduced I/O churn during HTML post-processing
413
+ - removed command-line option `--dry`
414
+
415
+ ## v0.9.0 - 2022-10-03
416
+
417
+ - added support for C++20 concepts
418
+
419
+ ## v0.8.2 - 2022-10-01
420
+
421
+ - added post-process to inline all local SVGs
422
+ - minor style fixes
423
+
424
+ ## v0.8.1 - 2022-09-30
425
+
426
+ - minor style fixes
427
+
428
+ ## v0.8.0 - 2022-09-29
429
+
430
+ - added config option `gitlab` (#13) (@wroyca)
431
+ - added ixx module extension in source patterns (#11) (@wroyca)
432
+ - added support for multi-codepoint emojis
433
+ - improved `doxygen.exe` location discovery on Windows
434
+ - improved `CHANGELOG` location discovery
435
+ - moved all poxy assets in the generated HTML to `html/poxy`
436
+ - self-hosted google fonts in generated HTML (instead of requiring additional HTTP requests on page load) (#6)
437
+ - removed ability to override m.css implementation
438
+ - removed legacy support for reading config options from neighbouring Doxyfiles
439
+ - overhauled the light theme
440
+ - many minor style fixes and tweaks
441
+
442
+ ## v0.7.1 - 2022-08-17
443
+
444
+ - fixed crash on python &lt;= 3.8 (#9) (@wroyca)
445
+
446
+ ## v0.7.0 - 2022-08-16
447
+
448
+ - fixed some `<link>`, `<meta>` and `<script>` tags not being included in `<head>` when a file was excluded from post-processing
449
+ - added `theme` command-line option
450
+ - added `html_header` config option option
451
+ - added automatic generation of github links in changelog when config option `github` is set
452
+ - added new light theme
453
+ - added dynamic switch for dark/light theme
454
+ - removed text from github icon on navbar (#5) (@wroyca)
455
+ - removed excessive spacing between article sections (#5) (@wroyca)
456
+ - many minor style fixes and tweaks
457
+
458
+ ## v0.6.1 - 2022-08-16
459
+
460
+ - fixed multi-row navbar occluding page content (#3) (@wroyca)
461
+
462
+ ## v0.6.0 - 2022-08-14
463
+
464
+ - fixed malformed error messages in some circumstances
465
+ - added builtin C++ standard macros for C++23
466
+ - added `changelog` config option
467
+ - updated cppreference.com tagfile
468
+
469
+ ## v0.5.7 - 2022-05-17
470
+
471
+ - fixed being able to pass >= 33 threads to Doxygen's `NUM_PROC_THREADS`
472
+
473
+ ## v0.5.6 - 2022-05-14
474
+
475
+ - fixed path error when using `--dry`
476
+ - fixed `friend` keyword sometimes leaking into function return types
477
+ - added additional language code block aliases
478
+ - added `--nocleanup` to `--help` output
479
+ - added support for C++20's `consteval` keyword
480
+
481
+ ## v0.5.5 - 2022-04-16
482
+
483
+ - fixed C++20 concepts causing a crash in m.css (they are now skipped with a warning) (#1) (@jake-arkinstall)
484
+
485
+ ## v0.5.4 - 2022-04-15
486
+
487
+ - updated m.css
488
+ - updated emoji database
489
+
490
+ ## v0.5.3 - 2021-12-12
491
+
492
+ - fixed Doxygen bug that would sometimes treat keywords like `friend` as part of a function's return type
493
+ - Blacklisted schema 0.7.5 because [it's broken](https://github.com/keleshev/schema/issues/272)
494
+
495
+ ## v0.5.2 - 2021-11-02
496
+
497
+ - fixed over-eager link-replacement for internal `#anchor` links
498
+ - added command-line options `--ppinclude` and `--ppexclude`
499
+
500
+ ## v0.5.1 - 2021-10-09
501
+
502
+ - fixed over-eager link replacement causing text to be deleted
503
+
504
+ ## v0.5.0 - 2021-09-11
505
+
506
+ - fixed a crash during HTML post-processing
507
+ - fixed `implementation_headers` not working when paths use backslashes
508
+ - added warnings when `implementation_headers` doesn't match anything
509
+
510
+ ## v0.4.5 - 2021-06-08
511
+
512
+ - added command-line option `--xmlonly`
513
+
514
+ ## v0.4.3 - 2021-05-31
515
+
516
+ - fixed regression in `[code_blocks]` functionality
517
+ - fixed minor issues in syntax highlighter
518
+ - added symbols from doxygen tagfiles to the syntax highlighter
519
+ - minor style tweaks
520
+
521
+ ## v0.4.1 - 2021-05-30
522
+
523
+ - fixed `.dirs` being glommed as source paths
524
+ - added config option `scripts`
525
+ - added config option `stylesheets`
526
+ - added config option `jquery`
527
+ - added `custom` theme
528
+ - added ability to use `HOME.md` as main page
529
+ - added additional fix for inline `<code>` blocks
530
+ - added `.poxy-toc` to table-of-contents elements
531
+ - added floating page table-of-contents
532
+ - removed m.css favicon fallback
533
+ - made improvements to the `light` and `dark` themes
534
+ - updated C++ doxygen tagfile
535
+
536
+ ## v0.4.0 - 2021-05-29
537
+
538
+ - added config option `theme`
539
+ - added version number to CSS and javascript filenames to prevent browser cache issues
540
+ - added `POXY_IMPLEMENTATION_DETAIL(...)` magic macro
541
+ - added `POXY_IGNORE(...)` magic macro
542
+ - fixed alignment of nested images inside detail blocks
543
+
544
+ ## v0.3.4 - 2021-05-28
545
+
546
+ - added basic `using` alias detection to syntax highlighter
547
+ - added missing badges for C++23, 26 and 29
548
+
549
+ ## v0.3.3 - 2021-05-23
550
+
551
+ - fixed sorting of namespace and group members
552
+ - fixed m.css failing with new versions of doxygen due to `Doxyfile.xml`
553
+ - added google structured data to `\pages`
554
+
555
+ ## v0.3.2 - 2021-05-19
556
+
557
+ - fixed formatting of `<meta>` tags
558
+ - added config option `author`
559
+ - added config option `robots`
560
+ - added markup tag `[p]`
561
+ - added markup tag `[center]`
562
+
563
+ ## v0.3.1 - 2021-05-13
564
+
565
+ - added config option `macros`
566
+ - added command-line option `--version`
567
+
568
+ ## v0.3.0 - 2021-05-09
569
+
570
+ - Improved handling of m.css and Doxygen warnings and errors
571
+ - added command-line option `--doxygen`
572
+ - added command-line option `--werror`
573
+ - added markup tag `[set_parent_class]`
574
+ - added markup tag `[add_parent_class]`
575
+ - added markup tag `[remove_parent_class]`
576
+ - added config option `images`
577
+ - added config option `examples`
578
+ - added ability to specify tagfiles as URIs
579
+
580
+ ## v0.2.1 - 2021-05-07
581
+
582
+ - fixed some minor autolinking issues
583
+
584
+ ## v0.2.0 - 2021-05-06
585
+
586
+ - added config option `source_patterns`
587
+
588
+ ## v0.1.2 - 2021-05-02
589
+
590
+ - fixed the Z-order of the nav bar being higher than the search overlay
591
+ - added `NDEBUG` to the default set of defines
592
+
593
+ ## v0.1.1 - 2021-04-26
594
+
595
+ - added an additional cleanup step to the HTML postprocessor
596
+
597
+ ## v0.1.0 - 2021-04-26
598
+
599
+ First public release :tada: