> Вот о том же индексе aka staging area подумать - если в
> терминах версий и хранимого кода - вообще не понять, что это.
> А если в терминах изменений - то вот именно изменения, готовые
> для сохранения в репозитории, индекс и хранит, всё сразу становится прозрачным. Это должно быть, в таком случае, написано везде большими красными буквами. Но вот мы читаем git-push(1):
git-push - Update remote refs along with associated objects
Ну что это за хрень? Какие refs? Какие objects?
Это первая строка man страницы, из неё должно быть понятно неофиту о чём речь. Возьмём sed(1):
sed - stream editor for filtering and transforming text
Всё чётко - фильтрация и преобразования текста.
Читаем описание git-push(1) - Description:
Updates remote refs using local refs, while sending objects necessary to complete the given refs.
You can make interesting things happen to a repository every time you push into it, by setting up hooks there. See documentation for git-receive-pack(1).
Опять масло-маслянное (первая строка). Вторая же написана в стиле "цирк уехал, а клоуны остались". Теперь берём тот же sed(1):
Sed is a stream editor. A stream editor is used to perform basic text transformations on an input stream (a file or input from a pipeline). While in some ways similar to an editor which permits scripted edits (such as ed), sed works by making only one pass over the input(s), and is consequently more efficient. But it is sed's ability to filter text in a pipeline which particularly distinguishes it from other types of editors.
Опять таки понятно, что он делает - нормальная аннотация к программе.
