Skip to content

Commit

Permalink
Update extra-vapis repo link in FAQ
Browse files Browse the repository at this point in the history
  • Loading branch information
colinkiama committed May 8, 2024
1 parent 28c3911 commit 679e1cf
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion source/faq.rst
Original file line number Diff line number Diff line change
Expand Up @@ -276,6 +276,6 @@ Perhaps the most significant advantage is that it is possible that the "upgraded

Probably the biggest disadvantage is that you will not automatically benefit from backwards-compatible fixes and improvements that happen in bindings over time. It is quite common for updated bindings to fix bugs (most prominently memory leaks), and if you use a local copy of the binding you will not benefit from such changes until you update the copy of the bindings your software uses.

Of course, sometimes it isn't really feasible to depend on the system-wide binding because there isn't one installed. While we generally prefer for Vala bindings to be distributed with the project they bind, or with Vala itself for some popular libraries, third-party bindings generally aren't installed system-wide and including a local copy is considered the preferred method of use. For example, the `vala-extra-vapis <https://github.com/nemequ/vala-extra-vapis>`_ repository (which contains many third-party bindings) is intended to be usable as a git submodule or subtree.
Of course, sometimes it isn't really feasible to depend on the system-wide binding because there isn't one installed. While we generally prefer for Vala bindings to be distributed with the project they bind, or with Vala itself for some popular libraries, third-party bindings generally aren't installed system-wide and including a local copy is considered the preferred method of use. For example, the `vala-extra-vapis <https://gitlab.gnome.org/GNOME/vala-extra-vapis>`_ repository (which contains many third-party bindings) is intended to be usable as a git submodule or subtree.

One more thing to consider is that using a local copy of bindings can make `<https://valadoc.org>`_ less useful. Typically, valadoc.org content tracks the latest stable version, if you're using a current Linux distribution, is likely the same version you have on your system. If you make a local copy of the bindings you use they will often be older versions which don't match what `valadoc.org <https://valadoc.org>`_ says.

0 comments on commit 679e1cf

Please sign in to comment.