Краткая инструкция по Fossil: различия между версиями
Содержимое удалено Содержимое добавлено
м Ivan Shmakov переименовал страницу Fossil в Краткая инструкция по Fossil: Слишком общее название. |
Использована разметка MediaWiki (была: HTML); исправления орфографии и типографики. |
||
Строка 1:
Этот краткий документ объясняет базовые fossil команды достаточные для работы одного пользователя. Данный документ не описывает совместную работу с другими пользователями, не описывает синхронизацию с удаленным репозитарием, и не описывает разветвления / порождения.
== Создать новое хранилище (репозитарий) ==
fossil new C:\test.repo
cd C:\Temp\test.fossil
fossil open C:\test.repo
Эта команда проведёт последнюю ревизию всех файлов в хранилище, если таковые имеются, в текущей директории. Кроме того, данная команда создаст бинарный файл <code>_FOSSIL_</code> в котором будут отслеживаються изменения (на отличных от Windows-системах этот файл называется <code>.fslckout</code>).
== Добавить новые файлы ==
fossil add .
Fossil пометит новые файлы на добавление в хранилище, но реально добавлены в репозитарий они будут после выполнения команды <code>commit</code>. При использовании точки «<code>.</code>», fossil добавит все файлы текущей директории рекурсивно, включая все файлы во всех подкаталогах.
Примечание: вот так можно fossil-у сказать игнорировать некоторые расширения:
fossil settings ignore-glob "*.o,*.obj,*.exe" --global
Удалить файлы, которые еще не были закоммичены:
fossil delete myfile.c
или
fossil rm myfile.c
Это команда просто удалит файл <code>myfile.c</code> из списка файлов, которые были добавлены ранее через команду <code>fossil add</code>.
Файлы которые были добавлены в репозитарий ранее, тоже можно удалить этими командами. Имена файлов содержащих символы пробела или интернациональные символы следует брать в двойные кавычки. Пример:
fossil rm "Фото моей тёти.jpg"
== Проверить текущее состояние ==
Это команда показывает список изменений, которые будут совершены, когда вы запустите <code>fossil commit</code>. Это полезная команда для запуска перед комитом, чтобы проверить все ли в порядке.
== Фиксация изменений ==
Чтобы действительно применить намеченные изменения в репозитории, например: новые файлы помеченные для добавления, извлеченные файлы, которые были отредактированы и должны быть проверены и т. д.
Если имена файлов не введены в командной линии, то все изменения будут зарегистрированы, в противном случае будет проведён commit для перечисленных файлов.
== Сравнение двух ревизий файла. ==
Если вы хотите сравнить последнюю версию файла в репозитарии c его версией в вашем рабочем каталоге наберите:
fossil gdiff myfile.c
Если вы хотите сравнить две разных ревизий одного файла в репозиторий:
fossil finfo myfile
Примечание: обратите внимание на первый хэш UUID фиксации, когда файл был закоммичен.
fossil gdiff --from UUID#1 --to UUID#2 myfile.c
== Отменить изменения и вернуться к предыдущей версии ==
fossil revert myfile.c
Fossil не спрашивает, когда возвращает файл. Он просто напоминает пользователю об отмене команды, на всякий случай.
== Закрыть репозитарий ==
fossil close
Это команда просто удалит файл <code>_FOSSIL_</code> в корневом каталоге, рабочие файлы в рабочем каталоге останутся без изменений. После этой команды, любое использование команды <code>fossil</code> вызовет ошибку, так как больше не никаких связей.
== Fossil в Windows 7 ==
Не следует помещать <code>fossil.exe</code> в <code>system32</code>, так как потом почему-то не работает команда <code>fossil ui</code>
== Распространение изменений ==
Чтобы обновить изменения на удалённом репозитарии:
fossil push URL
Чтобы обновить локальный репозитарий из удалённого:
fossil pull URL
Синхронизировать локальный и удалённый репозитарий — аналог двух выполненных команд <code>push</code> и <code>pull</code>:
fossil sync URL
Чтоб изменения из удалённых репозитария устанавливались в виде отдельной ветки выполните
fossil update VERSION
fossil undo
Иногда пользователи не хотят делится изменениями в своём репозитарии. Для этого нужно запускать:
fossil commit --private
Если вы почистили свою папку с исходниками и удалили кучу файлов, то fossil при commit будет ругаться. Эту проблему можно решить так — направить вывод ошибок в файл. Затем отредактировать созданный файл добавив в начало каждой строчке <code>fossil rm </code>⟨''имя файла''⟩. Запустить и проверить.
fossil commit 2> 4delete.sh
vim 4delete.sh
(Последней командой добавляем в начало каждой строчки <code>fossil rm</code>.)
|