differentiate metavariables and literals in target syntax

[dmwit]

In the description of target syntax for cabal v2-build, it's not super clear which bits of the syntax are variables that the user should replace with their own text, and which are literal strings that should be copied verbatim into a target string. I think it's this way:

• variables: package, ctype, ctypes, component
• literals: all, lib, libs, libraries, flib, flibs, foreign-libraries, exe, exes, executables, test, tests, bench, benches, benchmarks, :

Some text describing which is which would help a lot; but I think even better would be distinguishing them typographically, e.g. by making variables italic or similar.

[DanielG]

This is the section you're talking about, right?

https://github.com/haskell/cabal/blob/0ad0ac0b4c434b32794e03ac8f0e15801c59775c/Cabal/doc/nix-local-build.rst#L331-L389

[dmwit]

That's the one.

[damienlog]

-