Как я могу получить diff, чтобы остановить искажение функции docblocks?

Question

Если я добавлю функцию к своему коду, мой diff будет выглядеть так:

 }

 /**
+ * My new function docblock.
+ */
+function my_function($foo) { }
+
+/**
  * The next function's docblock.
  *

Есть ли способ, чтобы не помешать diff это искажать?

Я попробовал git's --patienceфлаг, но это дает тот же результат.

Answer 1

Вам нужен инструмент, который сравнивает программные структуры, а не «строки текста».

См. Наши SmartDifferencer инструменты, которые сравнивают исходный текст программ, используя структуруязык программирования в качестве руководства.Существует SmartDifferencer для многих языков (C ++, C #, Java, COBOL, ...)

Для примера OP следует просто отметить, что функция (и ее докблок) были добавлены.

Answer 2

Если то, что вы ожидаете, будет лучше различий, который "поймет" присутствие в сравнении блока комментариев и выровнит разность таким образом, чтобы не разбивать эти блоки, вы в настоящий момент отключены.

Внутренний алгоритм «diff» автоматически выравнивает блок по строке с наибольшим числом, для которого разница все еще «истинна».Например, вместо

 }

+/**
+ * My new function docblock.
+ */
+function my_function($foo) { }
+
 /**
  * The next function's docblock.
  *

Diff всегда будет возвращать результат, который вы описали в своем вопросе.Многие инструменты, основанные на GNU diff, страдают от этой проблемы.