doc add: renormalize is not idempotent for CRCRLF
Bug report https://lore.kernel.org/git/AM0PR02MB56357CC96B702244F3271014E8DC9@AM0PR02MB5635.eurprd02.prod.outlook.com/ noted that a file containing /r/r/n needed renormalising twice. This is by design. Lone CR characters, not paired with an LF, are left unchanged. Note this limitation of the "clean" filter in the documentation. Renormalize was introduced at 9472935d81e (add: introduce "--renormalize", Torsten Bögershausen, 2017-11-16) Signed-off-by: Philip Oakley <philipoakley@iee.email> Reviewed-by: Torsten Bögershausen <tboegi@web.de> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Philip Oakley committed
Aug 10, 2022 at 15:44 UTC
efae7ce6921d3ff9b3c6951d0da3efc9518027fc
1 file changed
+3
-1
Documentation/git-add.txt
+3
-1
@@ -188,7 +188,9 @@ for "git add --no-all <pathspec>...", i.e. ignored removed files.
188
forcibly add them again to the index. This is useful after
189
changing `core.autocrlf` configuration or the `text` attribute
190
in order to correct files added with wrong CRLF/LF line endings.
191
- This option implies `-u`.
191
+ This option implies `-u`. Lone CR characters are untouched, thus
192
+ while a CRLF cleans to LF, a CRCRLF sequence is only partially
193
+ cleaned to CRLF.
194
195
--chmod=(+|-)x::
196
Override the executable bit of the added files. The executable