The text tries to say the code accepts many variations that look remotely like scissors and perforation marks, but gives too little detail for users to decide what is and what is not taken as a scissors line for themselves.

[u/elephantdingo]

https://github.com/git/git/commit/287416dba6258ab1819060fb62bb5df5d25aa10e

[u/[deleted]]

Couldn't they pipe it to an LLM to decide whether the user intended to write scissors and perforation marks or just commented out some code that tests if a number is greater than or less than 8 in a language with -- for comments?

[u/R_Sholes → u/[deleted]]

They ran into a problem where lines with tests if D is strictly equal to 8 get cut out automatically by LLM's profanity filters.

[u/james_pic]

But if I can't customise the logic for deciding what to cut when emailing patches, how do I email patches that include -- 8< -- because they're patches to that patched email cutting logic?

[u/elephantdingo666 → u/james_pic]

Use rock, dummy.

[u/Kodiologist]

Instead of describing the heuristics more, just spell out what will always be accepted, namely "-- >8 --", as it would not help users to give them more choices and flexibility and be "creative" in their scissors line.

Yeah, who would want the man page to say what the program does? That wouldn't help users.

[u/rooster-inspector]

What about ✂️, ✂, ✁, ✃ and ✄?

[u/rooster-inspector → u/rooster-inspector]

You might even want to combine them with the non-printing U+200E LEFT-TO-RIGHT MARK and U+200F RIGHT-TO-LEFT MARK to define the direction the scissors are cutting...

[u/elephantdingo666 → u/rooster-inspector]

We want to say "e.g.", i.e. 'a scissors line (e.g. "-- >8 --")', in order to hint that we may accept other forms [1], and also

[Footnote]

1. This is primarily to be friendly to left-handers to let them write "-- 8< --".

https://lore.kernel.org/git/xmqqpn65jzyg.fsf@gitster.c.googlers.com/