Emmanuele Bassi
7b145f72dc
Apply review feedback fixes
2024-04-23 11:40:51 +02:00
Lukáš Tyrychtr
bd43a9e868
Document the new property
2024-04-23 11:40:51 +02:00
Alice Mikhaylenko
76421847a5
cssselector: Support :root
...
This will be useful for defining global variables.
2024-04-22 18:55:35 +04:00
Matthias Clasen
b5c9b6aa25
docs: Some updates to the render tool manpage
...
List all supported output formats and fix a few typos.
2024-04-21 11:03:31 -04:00
Matthias Clasen
86924c2f9a
docs: Add some metadata to man pages
...
It would be nice to include the version here, but that is trickier.
2024-04-21 11:03:14 -04:00
Matthias Clasen
af0f5e3f30
build: Fix docs build
...
There was an overlooked used of a dropped option here.
2024-04-21 10:15:06 -04:00
Matthias Clasen
0fb1f44eec
gdk: Add a debug flag to allow non-dmabuf offload
...
This is useful for debugging offloading without having to rely
on gstreamer giving us dmabufs. To use it, set
GDK_DEBUG=force-offload
in the environment.
2024-04-15 19:53:46 -04:00
Matthias Clasen
96160ea5dc
docs: Update some links
...
Use docs.gtk.org for all the documentation that is hosted there.
2024-04-09 20:00:00 -04:00
Andre Klapper
89fca57e68
Docs / README: Fix issue tracker URL
...
Link to public Issues overview page instead of a 404 New Issue page
when you are not already logged into GNOME GitLab.
2024-04-02 10:10:11 +02:00
Matthias Clasen
2c1590001f
Sync cursor images with Adwaita
...
Several cursor metaphors were changes in Adwaita. Update our docs
and the Cursors demo to match.
2024-03-20 13:19:12 -04:00
Matthias Clasen
90956b15d9
docs: Small tweaks
2024-03-16 20:52:15 -04:00
Matthias Clasen
1cbdf88b0f
Merge branch 'debug-cleanup' into 'main'
...
gsk: Fix a typo
See merge request GNOME/gtk!7039
2024-03-16 14:41:16 +00:00
Matthias Clasen
b1fb7cd4ae
gsk: Drop unused debug flags
...
The 'surface', 'sync' and 'opengl' flags are not used anywhere.
2024-03-16 09:44:57 -04:00
Matthias Clasen
33ffe28236
docs: Clarify GSK_DEBUG=vulkan
...
Make it clearer what this debug flag does.
2024-03-16 09:44:57 -04:00
Benjamin Otte
43373e6350
gpu: Rename env var GSK_GPU_SKIP to GSK_GPU_DISABLE
...
See previous commits.
2024-03-16 14:11:08 +01:00
Benjamin Otte
afd5ea53d8
vulkan: Rename env var from GDK_VULKAN_SKIP to GDK_VULKAN_DISABLE
...
It's a better name.
2024-03-16 14:03:36 +01:00
Benjamin Otte
f725bdad25
gl: Move GL_ARB_base_instance check
...
It's a GLContext feature check, not a GpuRenderer thing.
So put it there.
2024-03-16 13:52:28 +01:00
Benjamin Otte
4e453acd4f
gl: Remove the BGRA feature
...
Nobody is using it anymore now that we have format tracking for all
formats.
2024-03-16 13:44:02 +01:00
Benjamin Otte
3a04542146
gl: Add GDK_GL_DISABLE env var
...
This allows disabling certain GL features for testing, same as with
Vulkan.
2024-03-16 13:44:02 +01:00
Kirill Primak
3eacf8bd39
docs/iconcache.txt: fix ICON_FLAGS
...
The documented icon flags didn't match the actual constants used by GTK when
reading and updating icon theme cache files. Fix the values of flags in the
documentation.
Closes: https://gitlab.gnome.org/GNOME/gtk/-/issues/6489
2024-03-08 18:42:11 +03:00
Matthias Clasen
c9c6b7bb2a
rendernode tool: Add a compare command
...
This command can be used to compare the rendering of a node
to a reference image. It can also be used to compare the
renderings of two nodes, or to compare two images.
2024-02-21 22:27:32 -05:00
Matthias Clasen
da227386ad
Drop ffmpeg support
...
The experimental ffmpeg media backend hasn't been building for a
year, and nobody showed up with a patch to make it build again.
Fixes : #5581
2024-02-09 22:32:58 -05:00
Matthias Clasen
e861ea4bd2
gpu: Add a knob for cache GC
...
Read the GSK_CACHE_TIMEOUT environment variable to override the
default 15s timeout for cache gc. This is mainly meant for debugging.
Since we don't really need two knobs, reuse the gc timeout value
for the max age of items too.
2024-01-28 10:49:57 -05:00
Matthias Clasen
f90e77d173
gdk: Enable fractional scaling for GL by default
...
The ngl renderer has good support for fractional scaling, so we
can enable this by default now.
If you are using the gl renderer, you can disable fractional
scaling with the
GDK_DEBUG=gl-no-fractional
environment variable.
2024-01-25 14:41:04 -05:00
Maximiliano Sandoval
6f2d33369b
docs: Add favicons
...
Requires gi-docgen main.
2024-01-25 17:06:24 +01:00
Emmanuele Bassi
b8057b088e
docs: Clean up the note on nVidia on Windows
...
Turn the URL to the nVidia forums into an actual link, and put the whole
paragraph into an aside.
2024-01-16 20:14:21 +00:00
Benjamin Otte
24ceb47cbc
tools: Add the new benchmark command to the docs
2024-01-13 17:22:57 +01:00
Matthias Clasen
22a5447039
docs: Document new node-editor options
2024-01-12 21:13:51 -05:00
Matthias Clasen
0ed43f66a9
docs: Beef up the node-editor man page
...
Mention the GTK_SOURCE_DIR environment variable in the man page.
2024-01-10 21:10:36 -05:00
Matthias Clasen
59578c6d18
Fix typos throughout
...
These were pointed out by codespell.
2024-01-07 20:44:05 -05:00
Matthias Clasen
c0d49f296e
Update docs
...
Update the docs for environment variables that we parse to include
GDK_VULKAN_SKIP and GSK_GPU_SKIP.
2024-01-07 07:22:53 +01:00
Matthias Clasen
d595aff52d
coding style: Mention the available stack size
2023-11-26 09:07:38 -05:00
Emmanuele Bassi
48ea2ecac3
docs: Add content_base_url
...
Newer versions of gi-docgen support linking the rendered content files
to its source inside the repository, just like a symbol docblock.
2023-11-24 16:50:41 +00:00
Emmanuele Bassi
6d0b31128b
docs: Update the user support information
...
The IRC channel is on Libera and there's a Matrix room.
2023-11-24 16:50:41 +00:00
Emmanuele Bassi
0b519bc353
docs: Clarify title of the Initialization content file
2023-11-24 16:50:41 +00:00
Emmanuele Bassi
bb756b35a2
docs: Remove duplicate titles
2023-11-24 16:50:41 +00:00
Emmanuele Bassi
7ba7ab1e3d
docs: Fix links to the 2.x to 4 migration guide
...
The GTK3 migration guide is on docs.gtk.org, these days; and the
3.x to 4 migration guide is in the same location as this file.
2023-11-24 16:50:41 +00:00
Emmanuele Bassi
f73a7e29ca
docs: Use consistent style for content metadata
2023-11-24 16:50:41 +00:00
Emmanuele Bassi
2eb6e3d4c5
docs: Clean up the key value content file
...
Use a more descriptive title, add links to the API, add code elements,
and align the text a bit better.
2023-11-24 16:50:41 +00:00
Matthias Clasen
2dcec44714
Drop the nograbs debug value
...
This was only used in the x11 backend, and I haven't seen it
actively recommended for debugging anything in ages.
2023-11-20 08:02:03 -05:00
Matthias Clasen
f04c819439
Drop the gl-legacy debug value
...
The consensus is that we can do without this.
2023-11-20 08:02:02 -05:00
Matthias Clasen
025b846fce
Add a debug value to prefer desktop GL
...
This will be used in the next commit, when we change the default
preference to be GLES.
2023-11-19 08:07:02 -05:00
Matthias Clasen
fcdbab3f69
gl: Tweak debug values for GL api selection
...
Replace GDK_DEBUG=gl-gles with GDK_DEBUG=gl-disable-gl, and add
a GDK_DEBUG=gl-disable-gles to match.
2023-11-19 08:07:02 -05:00
Matthias Clasen
0e0bf8ed47
gsk: Add a debug flag for graphics offload
...
Add GSK_DEBUG=offload-disable to disable graphics offload via
attaching of dmabufs to subsurfaces. This is not used anywhere yet.
2023-11-13 22:17:35 +01:00
Matthias Clasen
efe1415429
gdk: Add a debug flag for subsurfaces
...
You can now use GDK_DEBUG=offload to get debug spew about
subsurfaces and graphics offload.
2023-11-13 22:17:35 +01:00
Robert Ancell
cf86cc1184
docs: Use gtk_window_present instead of gtk_widget_set_visible
2023-11-01 10:54:33 +13:00
Robert Ancell
8aef682079
docs: Replace deprecated gtk_widget_show with gtk_widget_set_visible
2023-10-31 13:27:26 +13:00
Benjamin Otte
76007c4d09
rendernode-tool: Add --undecorated to show command
...
This is to get exactly just the rendernode drawn when testing, and not
any extra drawing code.
2023-10-31 00:36:27 +01:00
Matthias Clasen
59641b3c7b
docs: Sync the list of debug flags
...
Make the docs for GDK_DEBUG match current reality.
2023-10-15 12:00:23 -04:00
kramo
0b2cebe3d8
docs: Update cursor images
2023-09-21 19:51:11 +02:00
Matthias Clasen
ad474a60c0
path-tool: Update docs
2023-09-03 23:47:10 +02:00
Matthias Clasen
dcbca3f0d7
path-tool: Add a reverse command
...
It does what it says.
2023-08-28 00:27:29 -04:00
Matthias Clasen
cfaa31eeb8
Expand docs for GskPathMeasure
2023-08-25 20:23:08 -04:00
Matthias Clasen
3283157352
Bring arc_to back as convenience API
...
It is our main use of conics, so make it an API,
and use it internally.
2023-08-25 09:31:19 -04:00
Matthias Clasen
25e6231a88
path: Switch back to conics
...
Arcs were appealing, but they have a fatal flaw: we can't
split our arcs without changing the ellipse they trace.
That could be fixed by adding an extra parameter, but then
it is no longer any better than conics.
So switch back to conics, which have the advantage that they
are used elsewhere.
2023-08-25 07:33:16 -04:00
Matthias Clasen
5dc0cbc20f
Expand the path docs a bit
2023-08-24 15:00:14 -04:00
Matthias Clasen
d873643407
path docs: Add another illustration
2023-08-24 11:09:28 -04:00
Matthias Clasen
8a789d0234
path docs: Cosmetics
2023-08-24 10:54:23 -04:00
Matthias Clasen
3c5efbc77e
Merge branch 'wip/matthiasc/arcs' into 'main'
...
path: Add arcs
See merge request GNOME/gtk!6313
2023-08-23 19:17:01 +00:00
Matthias Clasen
d33ed4f9ab
path: Add elliptical arcs
...
Add a new curve type for elliptical arcs
and use it for rounded rectangles and circles.
We use the 'E' command to represent elliptical
arcs in serialized paths.
2023-08-23 12:43:52 -04:00
Matthias Clasen
a63af177a4
docs: Fix gsk->gtk links
...
gi-docgen can't handle these, since we don't have
a dependency.
2023-08-23 11:38:13 -04:00
Matthias Clasen
79e132ab7b
path-tool: Reorganize options
...
Put fill and stroke options into their own group.
This helps produce understandable --help output.
2023-08-22 09:56:43 -04:00
Matthias Clasen
b3fe68ca95
docs: Tweaks
2023-08-22 07:56:27 -04:00
Matthias Clasen
486674927a
Make sure stroke bounds are big enough
...
Our standard 'empty path' in gtk4-node-editor
was getting its pointy corners cut off.
2023-08-21 23:59:08 -04:00
Matthias Clasen
acf9612ed8
docs: Start a section on paths
2023-08-21 23:59:08 -04:00
Matthias Clasen
2b4e577b53
docs: Add more illustrations
...
Add illustrations to the various curve_to methods
of GskPathBuilder.
2023-08-20 22:28:06 -07:00
Matthias Clasen
5cf9a09c07
gsk: Add more details to the docs
2023-08-15 12:38:24 -04:00
Matthias Clasen
081f504ae4
Tweak the directions illustration
...
Still not 100% happy with it, but it is better.
2023-08-14 16:09:27 -04:00
Matthias Clasen
a85ab3585e
Revise gsk_path_point_get_tangent
...
Update the directions enum to allow all four
tangents to be obtained. Add an illustration
to the docs for clarity.
Update all callers.
2023-08-14 14:58:22 -04:00
Matthias Clasen
8bf7187b89
path-tool: Make the docs match
...
We've removed various things from the tool,
and forgot to keep the docs up-to-date.
2023-08-12 19:29:27 -04:00
Matthias Clasen
62176a3bd0
tools: Add gtk4-path-tool
...
This comes in handy for testing, among other things.
For now, this supports decomposing, reversing, rendering,
info and preview.
2023-08-12 16:34:19 -04:00
Matthias Clasen
47ddc742fc
path: Some documentation improvements
...
Among other things, add a quick summary of
SVG path syntax, and add a few illustrations.
2023-08-11 12:09:12 -04:00
Hari Rana
544320a961
section-accessibility: Close tag
2023-08-05 12:25:23 -04:00
Matthias Clasen
6af55a31d7
build: Rename docs build options
...
Rename gtk_doc to documentation and update_screenshots
to screenshots. The old names are still accepted.
2023-08-04 22:30:13 -04:00
Matthias Clasen
d30adc48d4
RELEASE-HOWTO: Some updates
2023-08-02 20:07:00 +00:00
Thomas Lange
51e617daf3
docs: Fix typo
2023-08-01 23:51:34 +00:00
Benjamin Otte
cf39c80fe2
docs: Update for recent rendernode-tool changes
2023-07-31 16:51:03 +02:00
Matthias Clasen
96145ae8ed
tools: Update the docs
...
Mention that the render command can produce png or tiff
images.
2023-07-28 09:06:14 +03:00
Jordan Petridis
0e5f2cd6f6
docs: getting_started: Update links to some guides
2023-07-26 15:37:13 +03:00
Matthias Clasen
0751f59ee8
Drop GTK_DEBUG_TOUCHSCREEN
...
This flag was never doing much, and is only raising
the wrong expectations. Remove it.
Fixes : #5893
2023-07-22 16:43:20 -04:00
Daniel Boles
6260a33e8e
Merge branch 'dboles/PopoverMenu-png' into 'main'
...
Fix broken image menu.png in Gtk.PopoverMenu intro
See merge request GNOME/gtk!6187
2023-07-22 08:43:25 +00:00
Matthias Clasen
601011ccc0
Add a gtk4-rendernode-tool
...
This is meant to work with serialized render nodes.
2023-07-21 06:26:11 -04:00
Daniel Boles
9fbd582951
Fix broken image menu.png in Gtk.PopoverMenu intro
...
The previous menu.png appears to be just a wide transparent box. Let's
just replace it with a snip of a popover menu from the widget-factory.
2023-07-16 09:33:07 +01:00
Daniel Boles
d5ea376e7b
docs/list-widget: links, DirList, correct Sections
...
* Add links to various symbols.
* Mention DirectoryList in the "ready-made choices available" section.
* Don't say that GridView can display headers: it makes no attempt to.
2023-07-05 12:02:08 +01:00
Matthias Clasen
33fc4d6495
buildertool: Make render an alias for screenshot
...
Its a more neutral name and will align better with
other tools.
2023-06-26 10:58:35 -04:00
Daniel Boles
2d648f84a9
docs/ref/gtk/running: Mention GDK_DEBUG=no-portals
...
It was omitted from !5336
2023-06-23 14:24:47 +01:00
Matthias Clasen
1066374909
docs: Mention GtkAccessibleRange
...
In the accessibility docs about custom widgets,
mention GtkAccessibleRange as the best way to
implement custom range widgets.
2023-06-21 22:15:59 -04:00
Matthias Clasen
315ded687c
Docs: update
2023-06-19 18:38:58 -04:00
Matthias Clasen
c2d6f900d9
window: Use application as accessible role
...
ARIA deems the window role to be abstract,
so lets use the application role instead.
Update affected tests.
2023-06-19 18:38:58 -04:00
Matthias Clasen
f2a2e97004
docs: Add guidance on container roles
...
Provide some guidance on whether group or generic
is a more suitable role for containers.
2023-06-19 11:17:47 -04:00
Matthias Clasen
53503e3f19
Merge branch 'a11y-computed-name' into 'main'
...
atcontext: Update name computation
See merge request GNOME/gtk!6088
2023-06-16 16:30:51 +00:00
Daniel Boles
8106dc0f46
reference/gtk/coordinates: Fix typos of “widget’s”
2023-06-15 17:40:08 +01:00
Matthias Clasen
9831632fbd
a11y docs: Some updates
...
Clarify what UI properties go into the name computation,
and mention the inspector tools for accessiblity.
2023-06-13 14:12:16 -04:00
Daniel Boles
0f6219c9ca
docs/reference/gtk/running: Incl GDK_DEBUG=portals
...
Fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/5871
2023-06-12 16:29:52 +01:00
Matthias Clasen
534f11e317
Improve section model docs
...
Mention sections in the list widget overview,
and document the list models that support sections.
2023-05-21 19:20:08 -04:00
Arjan Molenaar
d9ec27ab29
Fix typo in CSS docs
2023-05-21 12:11:19 +02:00
Matthias Clasen
edfd37dfe2
docs: Mention pixbufs in the migration guide
2023-05-15 23:05:52 -04:00
Matthias Clasen
18b8baaf25
Merge branch 'input-doc-fixes' into 'main'
...
GTK reference docs: Some fixes
See merge request GNOME/gtk!5969
2023-05-14 21:49:10 +00:00
FeRD (Frank Dana)
c01be6cac7
doc/actions: Fix end-of-file :
...
The actions document ended with a : where there used to be a period,
seemingly a bug in the conversion from XML. Replace that : with a
period, and remove another spurious : inserted during the conversion.
2023-05-14 17:01:38 -04:00
FeRD (Frank Dana)
8b4e7a638c
docs/input: <kbd>␣</kbd> => <kbd>Space</kbd>
...
- Switch to semantic newlines, where adding <kbd> caused wrapped text
to grow wider than 80 characters on some lines.
2023-05-14 16:23:41 -04:00