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
FeRD (Frank Dana)
59acec21d4
docs/input-handling: A few more <kbd> wrappings
...
- Format a few missed keypresses/combos using <kbd>
- Switch to semantic newlines for those (paragraphs, bullet points)
2023-05-14 16:20:33 -04:00
FeRD (Frank Dana)
9b1026886b
docs/input-handling: Don't leave reader hanging
...
Strangely, the document's last sentence ended with a colon,
giving the impression there's missing text that should follow.
There is not.
Even more strange, it's _always_ ended with a colon,
ever since the file was converted from XML
(in commit 10cd539104
).
BUT, the XML file it was converted _from_ ended that same sentence
with a period! I have no idea where the colon came from.
2023-05-14 05:29:18 -04:00
Matthias Clasen
f99fbab24f
docs: Mention the current build options
...
Some of these got renamed recently.
2023-05-13 21:56:29 -04:00
Matthias Clasen
9bd9847b3f
switch: Expand the docs
...
Add more text and explanation around active vs state,
since people seem easily confused by it.
2023-05-01 15:15:53 -04:00
Matthias Clasen
b310ab7304
Merge branch 'matthiasc/for-main' into 'main'
...
docs: Migration guide updates
See merge request GNOME/gtk!5899
2023-04-30 22:39:57 +00:00
Matthias Clasen
cdbd931dba
docs: Migration guide updates
...
Mention various widget size apis going away.
2023-04-30 18:21:46 -04:00
Daniel Boles
060992aeba
migrating-3to4: Fix unescaped ptr * used as italic
2023-04-30 16:55:31 +01:00
Matthias Clasen
30b12ff890
docs: Mention baselines
...
Add a paragraph about baselines to the coordinates overview.
2023-04-29 13:48:03 -04:00
Daniel Boles
7bea2685e1
migrating-3to4: Don't mention removed Box method &
...
donʼt mention its renamed successor either, as that has its own section
later. We could have another sentence paragraph like ‘In the case of
GtkBox, the pack methods have been renamed to X and lost the trailing
arguments Y’, but that wonʼt help people prepare still on GTK3, which is
the point in the affected section… so just remove the misleading relic.
2023-04-28 21:14:37 +01:00
Daniel Boles
abd4a57031
3to4: Fix we said we replace doubles with doubles,
...
when what we are replacing are ints!
2023-04-26 21:30:10 +01:00
Matthias Clasen
e84ebfbf29
docs: Document new environment variables
...
Add GSK_MAX_TEXTURE_SIZE and GDK_DEBUG=gl-fractional
to the docs.
2023-04-02 13:52:56 -04:00
Matthias Clasen
ce86ec5599
CODING-STYLE: Updates
...
We switched to using #pragma once in headers,
document that.
2023-03-31 20:17:12 -04:00
Matthias Clasen
a9e37c6f2c
Incorporate review feedback
2023-03-25 16:22:45 -04:00
Matthias Clasen
3d35b848d1
docs: Use our own box model illustration
...
This one has a dark mode too.
2023-03-25 16:16:34 -04:00
Matthias Clasen
de3b37d80c
Tweak
2023-03-25 15:29:55 -04:00
Matthias Clasen
1e5dd5db71
Tweak
2023-03-25 15:27:23 -04:00
Matthias Clasen
7bd0fbb47e
More review feedback
2023-03-25 15:26:33 -04:00
Matthias Clasen
2e26932925
docs: Apply review feedback
...
Clarify some points in the coordinate overview.
2023-03-25 15:05:28 -04:00
Matthias Clasen
0b3c979719
Docs: Cosmetics
...
Align section heading better. Now they all follow
the "Using GTK..." pattern.
2023-03-25 12:17:20 -04:00
Matthias Clasen
63ed2a13bf
docs: Add a section about coordinate systems
2023-03-25 12:10:58 -04:00
Matthias Clasen
f0a2d77e0f
docs: Improve markup for keys
...
Consistently use <kbd>x</kbd> to render keys in the docs
and use + for key combinations.
2023-03-24 10:30:07 -04:00
Matthias Clasen
ce983c9495
docs: Some updates
...
Fix some links ot point to docs.gtk.org.
2023-03-24 08:56:06 -04:00
Matthias Clasen
9a7bf66ed4
docs: Tweaks
...
Tweak the wording in the list widget overview to
fix some typos and make things read more smoothly.
2023-03-18 10:25:58 -04:00
Matthias Clasen
31ec095ec7
docs: Update broadway docs
...
Using Broadway without broadwayd hasn't worked since 2013...
Fixes : #5662
2023-03-17 09:00:10 -04:00
Matthias Clasen
cc7d996a5c
Merge branch 'add_visited_state' into 'main'
...
a11y: Add GTK_ACCESSIBLE_STATE_VISITED
See merge request GNOME/gtk!5616
2023-03-15 01:24:18 +00:00
Matthias Clasen
83d14bfa98
CODING-STYLE: Drop mention of g_slice
2023-03-14 14:56:42 -04:00
Lukáš Tyrychtr
9517d3d135
a11y: Add GTK_ACCESSIBLE_STATE_VISITED
...
This state is used for visited link-like widgets.
It has no ARIA equivalent, e. g. can not be set programmatically, but it
exists in the browser environment as well.
2023-03-08 09:24:08 +01:00
Emmanuele Bassi
cd10e5dd1a
Verbiage Change
2023-02-27 16:32:35 +00:00
Bobby Neal
f11d647aa4
Update docs/reference/gtk/getting_started.md
2023-02-26 17:04:17 +00:00
Matthias Clasen
a9f03be588
builder-tool: Try harder to find template parents
...
This will make it work (in some cases) to add extra
libraries via LD_PRELOAD.
Based on work by Julian Sparber,
https://gitlab.gnome.org/GNOME/gtk/-/merge_requests/5084
Fixes : #5232
2023-02-19 18:17:34 -05:00
Matthias Clasen
cd0fe13dae
faq: Add a question about parallel UIs
2023-02-13 08:54:36 -05:00
Matthias Clasen
3dcea74e85
faq: Don't number questions
...
The numbering makes it unnecessarily hard to add
and remove questions, and does not really seem
necessary. Just use bullets.
2023-02-13 08:52:04 -05:00
Matthias Clasen
537c2f6c7a
faq: Some updates
...
Miscellaneous tweaks and changes, after reading
the whole thing.
2023-02-13 08:52:03 -05:00
Matthias Clasen
dfb019509d
docs: Document new build options
2023-02-12 20:36:13 -05:00
Matthias Clasen
157ef1d395
Deprecate GtkVolumeButton
...
Too specialized.
2023-02-12 09:48:49 -05:00
Matthias Clasen
1ff8dad8ec
Deprecate GtkLockButton
...
This is a very specialized widget, and should really just
live with the applications where it is used.
2023-02-02 08:39:25 +01:00
Matthias Clasen
d8cb11ec4a
Deprecate GtkStatusbar
...
The design patterns using statusbar are no longer popular,
and it is pretty easy to make a statusbar yourself with boxes
and labels, if you need one. The only thing special about
GtkStatusbar was its window resize handle, but that has
been gone for a long time.
2023-02-02 08:39:24 +01:00
Matthias Clasen
bf4b40f17e
docs: Update deprecations for gtk_show_uri
...
We have a better replacement now.
2023-01-14 17:39:28 -05:00
Corey Berla
e418656a04
docs: Fix dependency names
...
When gi-docgen added the "related" key, it also began checking
that the dependencies were actually dependencies otherwise they aren't
listed as dependencies. The capitalization needs to match the
namespace.
2023-01-13 14:24:33 -08:00
Matthias Clasen
815b54f3df
Update the build documentation
2023-01-13 07:15:15 -05:00
Matthias Clasen
66c947b86b
Merge branch 'swap-3-4' into 'main'
...
docs: Place example-{3,4} in numerical order
See merge request GNOME/gtk!5319
2023-01-06 18:06:55 +00:00
Matthias Clasen
47b5d0d546
Merge branch 'no-more-installed-tests' into 'main'
...
build: Drop the install-tests option
See merge request GNOME/gtk!5352
2022-12-20 05:33:56 +00:00
Matthias Clasen
3121f88265
build: Drop the install-tests option
...
We no longer use installed tests in CI,
so lets reap the benefit and simplify
our build setup for tests.
2022-12-19 23:12:47 -05:00
Nirbheek Chauhan
4346a33a63
meson: Require gi-docgen when gtk_doc is required
...
Fixes build with only `-Dgtk_doc=true` without
`-Dintrospection=enabled`:
Program gi-docgen found: NO
Configuring gdk4.toml using configuration
docs/reference/gdk/meson.build:13:2: ERROR: Tried to use not-found external program in "command"
`introspection` is `auto` by default.
The rest of the docs build is only contingent on
`if get_option('gtk_doc')` so we should use the same restriction here.
We check for `build_gir` below already, and the gi-docgen subproject
itself does not need gobject-introspection so it's fine to do it like
this.
2022-12-20 09:27:48 +05:30
Nirbheek Chauhan
cd77936265
meson: Fix find_program and subproject usage
...
Dummy dependencies are not required to execute a subproject
automatically for providing a program, nor do you need to explicitly
call subproject() to do that.
A `[provide]` section in the wrap file is enough.
2022-12-19 03:09:11 +05:30
andy5995
99d6eb9cb4
docs: Emphasize requirement to give filenames as arguments
...
(related to #5430 )
2022-12-12 23:40:07 -06:00
andy5995
9fd4b215ee
docs: Place example-{3,4} in numerical order
2022-12-10 17:39:09 -06:00