colorspace: improve/rewrite documentation of pl_color_repr_decode

The comments were egregiously outdated. Inverted conversions *are*
supported, and so are hue/sat adjustments for everything.
12 jobs for master in 7 minutes and 50 seconds (queued for 2 seconds)
Status Name Job ID Coverage
  Compile
passed aarch64 #609465
docker aarch64

00:00:08

passed linux #609461
docker amd64

00:00:10

passed macos #609466
catalina amd64

00:00:07

passed scan #609467
docker amd64

00:00:34

passed static #609462
docker amd64

00:00:09

passed win32 #609463
docker amd64

00:00:10

passed win64 #609464
docker amd64

00:00:10

 
  Test
passed gpu #609469
gpu

00:01:45

79.0975%
passed llvmpipe #609468
docker amd64

00:00:27

 
  Sanitize
passed asan #609470
gpu

00:01:54

passed msan #609471
gpu

00:01:40

passed ubsan #609472
gpu

00:01:53