19.2.1.1. Отправляйте заплаты, а не целые архивы или файлы

19.2.1.1. Отправляйте заплаты, а не целые архивы или файлы

Если изменения включают в себя новый файл, который отсутствует в коде, то, естественно, приходится отправлять данный файл целиком. Однако если изменяются только уже существующие файлы, отправлять их полностью не следует. Вместо этого следует отправить diff-файл, а именно вывод команды diff(1), выполненной для сравнения основной распространяемой версии с модифицированной.

Команда diff(1) и обратная ей команда patch(1) являются основными инструментами разработки открытого исходного кода. Diff-файлы лучше, чем целые файлы, поскольку разработчик, которому отсылается заплата, мог изменить основной код с момента получения копии создателем заплаты. Отправляя разработчику diff-файл, создатель заплаты предотвращает дополнительную работу по разделению изменений, которую придется выполнить разработчику, и демонстрирует таким образом, что он ценит его время.

Данный текст является ознакомительным фрагментом.



Поделитесь на страничке

Следующая глава >

Похожие главы из других книг:

Глава 20 Заплаты, разработка и сообщество

Из книги автора

Глава 20 Заплаты, разработка и сообщество Одно из самых больших преимуществ операционной системы Linux — это связанное с ней большое сообщество пользователей и разработчиков. Сообщество предоставляет множество глаз для проверки кода и множество пользователей для


Архивы

Из книги автора

Архивы Многие из читателей наверняка знают, что такое архивы, и сталкивались с ними еще до знакомства с Интернетом, однако не лишним будет напомнить, что архив – это файл, содержащий в себе один или несколько файлов в сжатом виде. Впоследствии из архива можно извлечь все


19.2.1.2. Отправляйте исправления к текущей версии кода

Из книги автора

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


19.2.1.3. Не следует включать заплаты для генерируемых файлов

Из книги автора

19.2.1.3. Не следует включать заплаты для генерируемых файлов Прежде чем отправить заплату, необходимо просмотреть ее и удалить все диапазоны кода, предназначенные для файлов, которые должны генерироваться автоматически после применения куратором исправлений и


19.2.1.4. Не отправляйте заплат, которые только убирают $-идентификаторы систем RCS или SCCS

Из книги автора

19.2.1.4. Не отправляйте заплат, которые только убирают $-идентификаторы систем RCS или SCCS Некоторые разработчики вносят специальные метки в свои исходные файлы, распространяемые с помощью системы контроля версий, когда возвращают отредактированные файлы, например,


19.2.1.6. Сопровождайте заплаты документацией

Из книги автора

19.2.1.6. Сопровождайте заплаты документацией Данный момент очень важен. Если заплата вносит заметные пользователям дополнения или изменяет функции программы, то необходимо включить данные изменения в соответствующие man-страницы и другие файлы документации к заплате. Не


19.2.1.1. Отправляйте заплаты, а не целые архивы или файлы

Из книги автора

19.2.1.1. Отправляйте заплаты, а не целые архивы или файлы Если изменения включают в себя новый файл, который отсутствует в коде, то, естественно, приходится отправлять данный файл целиком. Однако если изменяются только уже существующие файлы, отправлять их полностью не


19.2.1.2. Отправляйте исправления к текущей версии кода

Из книги автора

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


19.2.1.3. Не следует включать заплаты для генерируемых файлов

Из книги автора

19.2.1.3. Не следует включать заплаты для генерируемых файлов Прежде чем отправить заплату, необходимо просмотреть ее и удалить все диапазоны кода, предназначенные для файлов, которые должны генерироваться автоматически после применения куратором исправлений и


19.2.1.4. Не отправляйте заплат, которые только убирают $-идентификаторы систем RCS или SCCS

Из книги автора

19.2.1.4. Не отправляйте заплат, которые только убирают $-идентификаторы систем RCS или SCCS Некоторые разработчики вносят специальные метки в свои исходные файлы, распространяемые с помощью системы контроля версий, когда возвращают отредактированные файлы, например,


19.2.1.6. Сопровождайте заплаты документацией

Из книги автора

19.2.1.6. Сопровождайте заплаты документацией Данный момент очень важен. Если заплата вносит заметные пользователям дополнения или изменяет функции программы, то необходимо включить данные изменения в соответствующие man-страницы и другие файлы документации к заплате. Не


9.1.2. Архивы

Из книги автора

9.1.2. Архивы В архиве программы распространяются редко, но иногда такое случается. Может быть, разработчикам программы было лень собирать пакет, может, была и какая-нибудь другая причина. Но в большинстве случаев в архивах распространяется исходный код программы,


2.4.1 Целые Константы

Из книги автора

2.4.1 Целые Константы Целая константа, состоящая из последовательности цифр, считается восьмиричной, если она начинается с 0 (цифры ноль), и десятичной в противном случае. Цифры 8 и 9 не являются восьмиричными цифрами. Последовательность цифр, которой прешествует 0х или 0Х,


3.7.1. ZIP-архивы

Из книги автора

3.7.1. ZIP-архивы Обращение к архиватору, создающему zip-архивы, происходит из окна Finder. Чтобы заархивировать файл, необходимо выделить его, а затем выбрать команду Сжать «имя файла» (Compress file’s пате) из меню Файл (File) или из контекстного меню. Архив создается в этой же папке с


3.7.3. RAR-архивы

Из книги автора

3.7.3. RAR-архивы Несмотря на обилие архиваторов, входящих в состав операционной системы Mac OS X, довольно часто нам требуется работать с RAR-архивами, которые являются распространенными в системе Windows. Архиваторы, работающие с такими архивами, приходится приобретать