Say why the family argument in bindings does not reach the slice wrappers
This commit is contained in:
parent
5a1c2745b0
commit
dec4bcb88b
12
vendor/raylib/raylib.flan
vendored
12
vendor/raylib/raylib.flan
vendored
@ -875,7 +875,17 @@
|
|||||||
;; hole exactly where the next caller looks, which is the argument this file
|
;; hole exactly where the next caller looks, which is the argument this file
|
||||||
;; already makes about ConfigFlags, and the eleven are one family — there is
|
;; already makes about ConfigFlags, and the eleven are one family — there is
|
||||||
;; no line to draw between DrawSplineLinear and DrawSplineBasis that a reader
|
;; no line to draw between DrawSplineLinear and DrawSplineBasis that a reader
|
||||||
;; would predict. They sit together here rather than each in its own section
|
;; would predict.
|
||||||
|
;;
|
||||||
|
;; `bindings` makes the opposite argument a few lines above its own list —
|
||||||
|
;; that hand-writing the variants of a family "would widen the half that has
|
||||||
|
;; to be maintained by hand for nothing the examples ask for" — and it is
|
||||||
|
;; right there and does not reach here. That paragraph is about hand-written
|
||||||
|
;; `declare-c` lines, which are exactly the half a header change can falsify.
|
||||||
|
;; None of these eleven is one: each is a `name` directive, so the generated
|
||||||
|
;; declaration keeps the C symbol and its checked signature and gives up only
|
||||||
|
;; its Flan name. The hand-maintained half does not widen at all — what is
|
||||||
|
;; written below is Flan calling Flan, and it cannot disagree with raylib. They sit together here rather than each in its own section
|
||||||
;; for the same reason: the justification above is one argument about a shape
|
;; for the same reason: the justification above is one argument about a shape
|
||||||
;; that cuts across Shapes, Images and 3D, and splitting the family would
|
;; that cuts across Shapes, Images and 3D, and splitting the family would
|
||||||
;; mean writing it three times or leaving two thirds of it unexplained.
|
;; mean writing it three times or leaving two thirds of it unexplained.
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user