summaryrefslogtreecommitdiff
Commit message (Collapse)AuthorAgeFilesLines
...
| * | | | | Updates for 1.33gtk-doc-for-gtk4Matthias Clasen2020-10-012-1/+11
| | | | | |
| * | | | | scangobj: Use plain C types for some typesMatthias Clasen2020-10-011-6/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Use char, int, float, double, instead of their g-prefixed counterparts. This follows the GTK4 api style changes.
| * | | | | css: Treat informal tables like tablesMatthias Clasen2020-10-011-12/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | gtk-doc uses informaltable elements for formatting the function listings in reference pages, while pandoc-generated docbook uses informaltable elements for regular tables. Thankfully, they end up with different border attributes in the html, so we can use that to style them differently.
| * | | | | Recognize the GTK variants of G_DECLARE_Matthias Clasen2020-10-011-3/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | GTK 4 added its own variant of G_DECLARE_ under the name of GDK_DECLARE_INTERNAL_TYPE. Recognize it.
| * | | | | Don't print abstract titlesMatthias Clasen2020-10-011-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The "Abstract" looks irritating in the otherwise very minimal output we produce. Just leave it out.
| * | | | | Add tests to mkdb.pyMatthias Clasen2020-10-011-0/+34
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add tests for signal, property and action syntax as symbols in doc comments. And make the remaining tests robust enough to survive the addition.
| * | | | | Better index entries for actionsMatthias Clasen2020-10-011-0/+13
| | | | | |
| * | | | | Add actions to the navigation headerMatthias Clasen2020-10-011-0/+7
| | | | | |
| * | | | | mkdb: Generate sections for actionsMatthias Clasen2020-10-011-4/+186
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This is building on the work in the previous commit. The syntax chosen for doc comments is Class|action. We also need to allow periods in symbols, since those are commonly used to separate prefixes in action names. Here is a typical doc comment for an action: /** * GtkColorChooserWidget|color.select: * @red: the red value, between 0 and 1 * @green: the green value, between 0 and 1 * @blue: the blue value, between 0 and 1 * @alpha: the alpha value, between 0 and 1 * * Emits the #GtkColorChooser::color-activated signal for * the given color. */
| * | | | | scangobj: Introspect GTK4 actionsMatthias Clasen2020-10-011-0/+73
|/ / / / / | | | | | | | | | | | | | | | | | | | | GTK4 can define actions for widget classes. Write these out to a .actions file.
* | | | | Merge branch 'wip/smcv/qsort-null' into 'master'Matthias Clasen2020-10-011-2/+4
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | scangobj: Don't sort an absence of signals/properties Closes #125 See merge request GNOME/gtk-doc!53
| * | | | | scangobj: Don't sort an absence of signals/propertieswip/smcv/qsort-nullSimon McVittie2020-08-211-2/+4
| |/ / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | qsort (NULL, 0, ...) is formally considered to be undefined behaviour, and is diagnosed as such by the undefined behaviour sanitizer. Resolves: #125 Signed-off-by: Simon McVittie <smcv@debian.org>
* | | | | Merge branch 'wip/smcv/mkhtml2-typo' into 'master'Matthias Clasen2020-10-011-1/+1
|\ \ \ \ \ | |_|/ / / |/| | | | | | | | | | | | | | mkhtml2: Fix apparent typo "os.getcmd()" See merge request GNOME/gtk-doc!50
| * | | | mkhtml2: Fix apparent typo "os.getcmd()"wip/smcv/mkhtml2-typoSimon McVittie2020-08-131-1/+1
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | os.getcwd() would make sense here. This call isn't actually reached in practice, because the gtkdoc-mkhtml2 script entry point always passes something for options.output_dir, even if it's ".". Signed-off-by: Simon McVittie <smcv@debian.org>
* | | | Merge branch 'wip/smcv/dist-meson-build' into 'master'Xavier Claessens2020-08-2522-3/+90
|\ \ \ \ | |_|_|/ |/| | | | | | | | | | | | | | | | | | | build: Distribute more files from git in official release tarballs Closes #109 See merge request GNOME/gtk-doc!55
| * | | CI: Check that Meson tests can pass from an Autotools dist tarballwip/smcv/dist-meson-buildSimon McVittie2020-08-211-0/+24
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This allows the Autotools dist tarball to continue to be used as the official release artifact, while still allowing distributors to try Meson builds. To help to debug this if it fails, the meson-build step records a list of all files in git (ideally we'd use 'meson dist' but the container image doesn't currently include git, so this is the next best thing), while the meson-from-tarball step records a list of all files in the tarball. They are in a normalized order that can be diff'ed. Tests: #109 Signed-off-by: Simon McVittie <smcv@debian.org>
| * | | CI: Collect logs from meson build as artifactsSimon McVittie2020-08-211-0/+4
| | | | | | | | | | | | | | | | Signed-off-by: Simon McVittie <smcv@debian.org>
| * | | build: Distribute more files from git in official release tarballsSimon McVittie2020-08-2121-3/+62
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Many of these are necessary for the Meson build, and some merely seem potentially useful. Resolves: #109 Signed-off-by: Simon McVittie <smcv@debian.org>
* | | | Merge branch 'wip/smcv/ci-meson-tests' into 'master'Xavier Claessens2020-08-2116-2/+70
|\ \ \ \ | |/ / / | | | | | | | | | | | | Run tests under Meson again See merge request GNOME/gtk-doc!52
| * | | Revert "Ignore failing test swith meson for now"Simon McVittie2020-08-211-1/+1
| | | | | | | | | | | | | | | | This reverts commit 1f0a7303b5158f811cea29fedd0832d333367deb.
| * | | tests: Copy -sections.txt to build directory where neededSimon McVittie2020-08-212-0/+12
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Two tests rely on symbols in <SUBSECTION Private> and <SUBSECTION Standard> being ignored. The Autotools build automatically copies -sections.txt into the build directory where gtk-doc will find it, but the Meson build does not, resulting in gtk-doc generating a new -sections.txt that does not know which symbols to ignore, and complaining that the private symbols are now undocumented. Signed-off-by: Simon McVittie <smcv@debian.org>
| * | | tests: Generate gtkdocentities.xml during Meson buildSimon McVittie2020-08-2115-1/+57
| |/ / | | | | | | | | | | | | | | | Otherwise tests will fail when we can't load external entities from it. Signed-off-by: Simon McVittie <smcv@debian.org>
* | | Merge branch 'wip/smcv/meson' into 'master'Xavier Claessens2020-08-212-20/+30
|\ \ \ | |/ / |/| | | | | | | | Install the same files with Meson as with Autotools See merge request GNOME/gtk-doc!48
| * | meson: Use the same name for the manual as in AutotoolsSimon McVittie2020-05-061-1/+1
| | | | | | | | | | | | Signed-off-by: Simon McVittie <smcv@debian.org>
| * | meson: Install no-xslt variants of Autotools Makefile fragmentSimon McVittie2020-05-061-19/+29
|/ / | | | | | | | | | | | | Previously, these were installed when building with Autotools but not when building with Meson. Signed-off-by: Simon McVittie <smcv@debian.org>
* | Updated Czech help translationMarek Černocký2020-03-081-564/+438
| |
* | Merge branch 'fix_es' into 'master'Daniel Mustieles García2020-03-071-2/+2
|\ \ | | | | | | | | | | | | | | | | | | es: do not translate '<_:example-1/>' Closes #115 See merge request GNOME/gtk-doc!46
| * | es: do not translate '<_:example-1/>'Christian Rauch2020-03-071-2/+2
|/ /
* | Fix broken markup in Gujarati help translationAndre Klapper2020-03-071-1/+1
| |
* | Updated Spanish translationDaniel Mustieles2020-02-121-6902/+6853
|/
* Fix broken markup in Spanish help translationAndre Klapper2020-02-011-6902/+6902
| | | | Fixes #115
* Merge branch 'DeprecatedStructMember' into 'master'Stefan Sauer2020-01-272-2/+27
|\ | | | | | | | | scan: support deprecated struct members See merge request GNOME/gtk-doc!43
| * scan: support deprecated struct membersJason Crain2020-01-262-2/+27
|/ | | | | | | | | | | | | | | | | | gcc allows deprecating members of structs. For example: struct data { int x G_GNUC_DEPRECATED_FOR(replacement); }; However, this currently causes the entire struct to be marked as deprecated and confuses mkdb because it doesn't understand the G_GNUC_DEPRECATED_FOR symbol. Fix this by having the whole struct only be marked as deprecated if the '_DEPRECATED' is after the closing bracket of the struct, similar to how it already does for enums, and having scan automatically remove all G_GNUC_* decorators from struct members, similar to how it already does for functions.
* Merge branch 'gnuc_ignore_deprecation' into 'master'Stefan Sauer2020-01-252-14/+23
|\ | | | | | | | | Fixes to build latest glib See merge request GNOME/gtk-doc!42
| * Ignore failing test swith meson for nowXavier Claessens2020-01-031-1/+1
| |
| * typedef can be followed by decoratorXavier Claessens2020-01-031-13/+17
| |
| * Skip G_GNUC_(BEGIN|END)_IGNORE_DEPRECATIONS linesXavier Claessens2020-01-021-0/+5
| | | | | | | | | | For some reason, glib has to put empty line before and after each of these lines otherwise the symbol following it is undeclared.
* | Updated Spanish translationDaniel Mustieles2020-01-231-58/+103
| |
* | Updated Spanish translationDaniel Mustieles2020-01-221-26/+39
|/
* Merge branch 'wip/swilmet/scangobj-fix-warnings' into 'master'Stefan Sauer2019-12-231-3/+3
|\ | | | | | | | | scangobj: fix -Wdouble-promotion warnings See merge request GNOME/gtk-doc!41
| * scangobj: fix -Wdouble-promotion warningsSébastien Wilmet2019-12-181-3/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | If a project passes the -Wdouble-promotion CFLAG when compiling the generated *scan.c file, then it emits some warnings. For example in the Devhelp project: ``` Building documentation for devhelp-3 devhelp-3-scan.c: In function ‘describe_double_constant’: devhelp-3-scan.c:595:39: warning: implicit conversion from ‘float’ to ‘gdouble’ {aka ‘double’} to match other operand of binary expression [-Wdouble-promotion] 595 | #define GTKDOC_COMPARE_FLOAT(x, y) (x <= y && x >= y | ^~ devhelp-3-scan.c:608:12: note: in expansion of macro ‘GTKDOC_COMPARE_FLOAT’ 608 | else if (GTKDOC_COMPARE_FLOAT (value, G_MAXFLOAT)) | ^~~~~~~~~~~~~~~~~~~~ [...] ``` An example where the -Wdouble-promotion CFLAG is used is with the AX_COMPILER_FLAGS Autotools macro, part of autoconf-archive. ----- In the diff, the `value` variable is of type gdouble.
* | Merge branch 'python3-dev' into 'master'Stefan Sauer2019-12-231-3/+0
|\ \ | | | | | | | | | | | | Remove unused libpython3 dependency See merge request GNOME/gtk-doc!39
| * | Remove unused libpython3 dependencyXavier Claessens2019-12-131-3/+0
| |/ | | | | | | | | | | gtk-doc only requires the interpreter, and Meson itself already depends on python3 >= 3.5, so that check we useless and breaks build on CI docker that doesn't contain libpython3-dev.
* | mkdb: ensure deterministic index files.Stefan Sauer2019-12-231-1/+1
| |
* | mkhtml2: add a fake resolver to improve speedStefan Sauer2019-12-231-4/+18
| | | | | | | | | | This is a workaround for missing dtd caching in libxml2 that turns into extrem overhead for documents with many xincludes.
* | Merge branch 'reproducible-output-946331' into 'master'Stefan Sauer2019-12-231-1/+1
|\ \ | | | | | | | | | | | | Please make the output reproducible See merge request GNOME/gtk-doc!37
| * | Please make the output reproducibleChris Lamb2019-12-071-1/+1
| |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Whilst working on the Reproducible Builds effort [0] we noticed that gtk-doc generates unreproducible output. There will likely be more issues but this one is at least fairly simple in that it iterates over a set structure when printing some .devhelp2 headers, for example: │ │ │ │ - <sub name="Index of new API in 0.99.5" link="api-index-0-99-5.html"/> │ │ │ │ - <sub name="Index of new API in 0.9.22" link="api-index-0-9-22.html"/> │ │ │ │ <sub name="Index of new API in 0.9.0" link="api-index-0-9-0.html"/> │ │ │ │ - <sub name="Index of new API in 0.9.1" link="api-index-0-9-1.html"/> │ │ │ │ + <sub name="Index of new API in 0.9.19" link="api-index-0-9-19.html"/> │ │ │ │ <sub name="Index of new API in 0.99.8" link="api-index-0-99-8.html"/> │ │ │ │ + <sub name="Index of new API in 0.99.5" link="api-index-0-99-5.html"/> │ │ │ │ <sub name="Index of new API in 1.0" link="api-index-1-0.html"/> │ │ │ │ - <sub name="Index of new API in 0.9.19" link="api-index-0-9-19.html"/> │ │ │ │ <sub name="Index of new API in 0.9.2" link="api-index-0-9-2.html"/> │ │ │ │ + <sub name="Index of new API in 0.9.1" link="api-index-0-9-1.html"/> │ │ │ │ + <sub name="Index of new API in 0.9.22" link="api-index-0-9-22.html"/> This was originally filed in Debian as #946311 [1]. [0] https://reproducible-builds.org/ [1] https://bugs.debian.org/946331 Signed-off-by: Chris Lamb <lamby@debian.org>
* | Merge branch 'tests' into 'master'Stefan Sauer2019-12-234-18/+22
|\ \ | |/ |/| | | | | meson: Fix running tests See merge request GNOME/gtk-doc!40
| * meson: Fix running testsXavier Claessens2019-12-234-18/+22
|/
* Updated Spanish translationDaniel Mustieles2019-10-021-416/+448
|