Reference to cairocffi unclear

[page200]

An comma in the README after a nonessential clause might be missing, distorting the meaning. Without the comma, the sentence syntax can be parsed as follows:

"If Pycairo is not what you need, have a look at cairocffi, which is an API compatible package using {{{cffi or Qahirah}}}, which is using ctypes and provides a more "pythonic" API with less focus on matching the cairo C API."

By adding a comma after "cffi":

"If Pycairo is not what you need, have a look at {{{cairocffi, which is an API compatible package using cffi}}}, or {{{Qahirah, which is using ctypes and provides a more "pythonic" API with less focus on matching the cairo C API.}}}"

Is that what is meant? Better yet, make a bullet list of the alternatives.

Moreover, it is unclear what the pros and cons of using cffi are, i.e. the pros and cons of cairocffi. In what cases may Pycairo be "not what you need" as the README says, whereas cairocffi is?

Thanks!

[lazka]

An comma in the README after a nonessential clause might be missing, distorting the meaning. Without the comma, the sentence syntax can be parsed as follows:

"If Pycairo is not what you need, have a look at cairocffi, which is an API compatible package using {{{cffi or Qahirah}}}, which is using ctypes and provides a more "pythonic" API with less focus on matching the cairo C API."

By adding a comma after "cffi":

"If Pycairo is not what you need, have a look at {{{cairocffi, which is an API compatible package using cffi}}}, or {{{Qahirah, which is using ctypes and provides a more "pythonic" API with less focus on matching the cairo C API.}}}"

Is that what is meant? Better yet, make a bullet list of the alternatives.

yes, thanks.

Moreover, it is unclear what the pros and cons of using cffi are, i.e. the pros and cons of cairocffi. In what cases may Pycairo be "not what you need" as the README says, whereas cairocffi is?

Fair point. I didn't want to compare them too much back then as I was biased. I'll try to make this clearer.

[lazka]

I've moved the text to the bottom of https://pycairo.readthedocs.io/en/latest/ now and rewrote it.

Feedback welcome

[stuaxo]

Reads clearly to me, explains what it is + the benefits. 👍