1
1
mirror of https://github.com/wez/wezterm.git synced 2024-12-25 06:12:16 +03:00
wezterm/deps/cairo/pixman
Wez Furlong 58a2a30623
Add vendored cairo-sys-rs crate
I'm experimenting with using cairo's 2D graphics for glyph related
drawing operations, and perhaps more stuff in the UI in the future.

The challenge is that no one has yet encapsulated its build in a
cargo-friendly way.

This commit is that attempt.

The strategy is this:

* `deps/cairo` is ostensibly the same thing as https://github.com/gtk-rs/gtk-rs-core/tree/master/cairo/sys
  which is the cairo-sys-rs crate
* Its build.rs has been replaced with a version that builds from the C
  sources that are found in-tree; it will never look for the system
  cairo library
* A pair of scripts to import pixman (a required dep of cairo) and
  cairo itself in a repeatable way are include, for if/when we need
  to update the vendored sources
  Cairo is a mature library and doesn't release very often.
* The workspace sets a patch for crates.io so that cairo-rs has
  its cairo-sys-rs dep redirected to the local build.

I'm not planning to upstream this stuff to gtk-rs-core as full cairo
depends on a lot more things than are dealt with here, so it would be a
PITA to handle that generally.

This vendoring strips out things that are not used, so the cairo
library that remains:

* Is not internally thread safe; no TLS or mutex support is enabled
  in either of them. That's fine because the high level cairo-rs
  wrapper is not Send+Sync, which means that rust will only allow
  it to be used single threaded anyway.
* Only has the basic recording and image surfaces
* No platform support for win32/xlib/xcb and so on
2023-08-20 14:59:29 -07:00
..
pixman Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
a64-neon-test.S Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
arm-simd-test.S Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
AUTHORS Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
ChangeLog Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
config.h.in Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
COPYING Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
depcomp Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
INSTALL Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
install-sh Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
Makefile.am Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
Makefile.in Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
Makefile.win32 Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
Makefile.win32.common Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
meson_options.txt Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
meson.build Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
missing Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
neon-test.S Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
NEWS Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
pixman-1-uninstalled.pc.in Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
pixman-1.pc.in Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
README Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00
test-driver Add vendored cairo-sys-rs crate 2023-08-20 14:59:29 -07:00

Pixman
======

Pixman is a library that provides low-level pixel manipulation
features such as image compositing and trapezoid rasterization.

Questions should be directed to the pixman mailing list:

    https://lists.freedesktop.org/mailman/listinfo/pixman

You can also file bugs at

    https://gitlab.freedesktop.org/pixman/pixman/-/issues/new

or submit improvements in form of a Merge Request via

    https://gitlab.freedesktop.org/pixman/pixman/-/merge_requests

For real time discussions about pixman, feel free to join the IRC
channels #cairo and #xorg-devel on the FreeNode IRC network.


Contributing
------------

In order to contribute to pixman, you will need a working knowledge of
the git version control system. For a quick getting started guide,
there is the "Everyday Git With 20 Commands Or So guide"

    https://www.kernel.org/pub/software/scm/git/docs/everyday.html

from the Git homepage. For more in depth git documentation, see the
resources on the Git community documentation page:

    https://git-scm.com/documentation

Pixman uses the infrastructure from the freedesktop.org umbrella
project. For instructions about how to use the git service on
freedesktop.org, see:

    https://www.freedesktop.org/wiki/Infrastructure/git/Developers

The Pixman master repository can be found at:

    https://gitlab.freedesktop.org/pixman/pixman


Sending patches
---------------

Patches should be submitted in form of Merge Requests via Gitlab.

You will first need to create a fork of the main pixman repository at

    https://gitlab.freedesktop.org/pixman/pixman

via the Fork button on the top right. Once that is done you can add your
personal repository as a remote to your local pixman development git checkout:

    git remote add my-gitlab git@gitlab.freedesktop.org:YOURUSERNAME/pixman.git

    git fetch my-gitlab

Make sure to have added ssh keys to your gitlab profile at

    https://gitlab.freedesktop.org/profile/keys

Once that is set up, the general workflow for sending patches is to create a
new local branch with your improvements and once it's ready push it to your
personal pixman fork:

    git checkout -b fix-some-bug
    ...
    git push my-gitlab

The output of the `git push` command will include a link that allows you to
create a Merge Request against the official pixman repository.

Whenever you make changes to your branch (add new commits or fix up commits)
you push them back to your personal pixman fork:

    git push -f my-gitlab

If there is an open Merge Request Gitlab will automatically pick up the
changes from your branch and pixman developers can review them anew.

In order for your patches to be accepted, please consider the
following guidelines:

 - At each point in the series, pixman should compile and the test
   suite should pass.

   The exception here is if you are changing the test suite to
   demonstrate a bug. In this case, make one commit that makes the
   test suite fail due to the bug, and then another commit that fixes
   the bug.

   You can run the test suite with 

        make check

   if you built pixman with autotools or

       meson test -C builddir

   if you built pixman with meson.

   It will take around two minutes to run on a modern PC.

 - Follow the coding style described in the CODING_STYLE file

 - For bug fixes, include an update to the test suite to make sure
   the bug doesn't reappear.

 - For new features, add tests of the feature to the test
   suite. Also, add a program demonstrating the new feature to the
   demos/ directory.

 - Write descriptive commit messages. Useful information to include:
        - Benchmark results, before and after
	- Description of the bug that was fixed
	- Detailed rationale for any new API
	- Alternative approaches that were rejected (and why they
          don't work)
	- If review comments were incorporated, a brief version
          history describing what those changes were.

 - For big patch series, write an introductory post with an overall
   description of the patch series, including benchmarks and
   motivation. Each commit message should still be descriptive and
   include enough information to understand why this particular commit
   was necessary.

Pixman has high standards for code quality and so almost everybody
should expect to have the first versions of their patches rejected.

If you think that the reviewers are wrong about something, or that the
guidelines above are wrong, feel free to discuss the issue. The purpose
of the guidelines and code review is to ensure high code quality; it is
not an exercise in compliance.