git-am - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

git-am - Áp dụng một loạt các bản vá từ hộp thư

SYNOPSIS

git am [--signoff] [--keep] [- [no-] keep-cr] [- [no-] utf8]
[- [no-] 3way] [--interactive] [--committer-date-is-author-date]
[--ignore-date] [--ignore-space-change | - khoảng trắng lớn]
[--whitespace = ] [-NS ] [-P ] [--directory = ]
[--exclude = ] [--include = ] [--reject] [-q | --Yên lặng]
[- [không-] kéo] [-S [ ]] [--patch-format = ]
[( | ) ...]
git am (--tiếp tục | --bỏ qua | --abort)

MÔ TẢ

Tách các thư trong hộp thư thành thông báo nhật ký cam kết, thông tin về quyền tác giả và
các bản vá và áp dụng chúng cho nhánh hiện tại.

LỰA CHỌN

( | ) ...
Danh sách các tệp hộp thư để đọc các bản vá lỗi. Nếu bạn không cung cấp đối số này,
lệnh đọc từ đầu vào chuẩn. Nếu bạn cung cấp các thư mục, chúng sẽ
được coi là Người đưa thư.

-s, --signoff
Thêm một dòng đã ký tên: vào thông báo cam kết, sử dụng danh tính người cam kết của
chính bạn. Xem tùy chọn đăng nhập trong git-cam kết(1) để biết thêm thông tin.

-k, - giữ
Chuyển cờ -k cho git thông tin thư (xem thông tin git-mail(1)).

--giữ-không-vá
Chuyển cờ -b cho git thông tin thư (xem thông tin git-mail(1)).

- [no-] keep-cr
Với --keep-cr, hãy gọi git chia thư (xem git-mailsplit(1)) với cùng một tùy chọn, để
ngăn nó tước CR ở cuối dòng. biến cấu hình am.keepcr
có thể được sử dụng để chỉ định hành vi mặc định. --no-keep-cr rất hữu ích để ghi đè
sáng.keepcr.

-c, --scissors
Loại bỏ tất cả mọi thứ trên cơ thể trước một đường kéo (xem thông tin git-mail(1)). Có thể
được kích hoạt theo mặc định bằng biến cấu hình mailinfo.scissors.

- không kéo
Bỏ qua các đường kéo (xem thông tin git-mail(1)).

-m, --message-id
Chuyển cờ -m tới git thông tin thư (xem thông tin git-mail(1)), để tiêu đề ID thông báo
được thêm vào thông báo cam kết. Biến cấu hình am.messageid có thể được sử dụng để
chỉ định hành vi mặc định.

--no-message-id
Không thêm tiêu đề Message-ID vào thông báo cam kết. no-message-id hữu ích cho
ghi đè am.messageid.

-q, --quiet
Hãy yên lặng. Chỉ in thông báo lỗi.

-u, --utf8
Chuyển cờ -u cho git thông tin thư (xem thông tin git-mail(1)). Thông báo nhật ký cam kết được đề xuất
lấy từ e-mail được mã hóa lại thành mã hóa UTF-8 (biến cấu hình
i18n.commitencoding có thể được sử dụng để chỉ định mã hóa ưu tiên của dự án nếu nó không phải là
UTF-8).

Đây là tùy chọn trong các phiên bản trước của git, nhưng bây giờ nó là mặc định. Bạn có thể dùng
--no-utf8 để ghi đè điều này.

--no-utf8
Chuyển cờ -n cho git thông tin thư (xem thông tin git-mail(1)).

-3, --3way, - không-3way
Khi bản vá không áp dụng một cách sạch sẽ, hãy quay lại hợp nhất 3 chiều nếu bản vá ghi lại
danh tính của các đốm màu mà nó phải áp dụng và chúng tôi có sẵn những đốm màu đó
tại địa phương. --no-3way có thể được sử dụng để ghi đè biến cấu hình am.threeWay. Vì
thêm thông tin, xem am.threeWay trong git-config(1).

--ignore-space-change, --ignore-whitespace, --whitespace = , -NS , -P ,
--directory = , --exclude = , - bao gồm = , --Từ chối
Các cờ này được chuyển đến git ứng dụng (xem áp dụng git(1)) chương trình áp dụng
vá.

--định dạng bản vá
Theo mặc định, lệnh sẽ cố gắng phát hiện định dạng bản vá tự động. Tùy chọn này
cho phép người dùng bỏ qua tính năng phát hiện tự động và chỉ định định dạng bản vá
(các) bản vá phải được hiểu là. Các định dạng hợp lệ là mbox, stgit, stgit-series
và hg.

-i, - tương tác
Chạy tương tác.

--committer-date-is-author-date
Theo mặc định, lệnh ghi lại ngày từ thông điệp e-mail với tư cách là tác giả cam kết
ngày, và sử dụng thời gian tạo cam kết làm ngày cam kết. Điều này cho phép người dùng
nói dối về ngày của người cam kết bằng cách sử dụng cùng một giá trị với ngày của tác giả.

--bỏ qua ngày
Theo mặc định, lệnh ghi lại ngày từ thông điệp e-mail với tư cách là tác giả cam kết
ngày, và sử dụng thời gian tạo cam kết làm ngày cam kết. Điều này cho phép người dùng
nói dối về ngày của tác giả bằng cách sử dụng cùng một giá trị với ngày của người cam kết.

--nhảy
Bỏ qua bản vá hiện tại. Điều này chỉ có ý nghĩa khi khởi động lại một bản vá bị hủy bỏ.

-NS[ ], --gpg-sign [= ]
GPG-sign cam kết. Đối số keyid là tùy chọn và mặc định cho trình cam kết
xác thực; nếu được chỉ định, nó phải được dán vào tùy chọn không có khoảng trắng.

- tiếp tục, -r, - đã giải quyết
Sau khi bản vá lỗi (ví dụ: cố gắng áp dụng bản vá xung đột), người dùng đã
đã áp dụng nó bằng tay và tệp chỉ mục lưu trữ kết quả của ứng dụng. Làm một
cam kết sử dụng quyền tác giả và nhật ký cam kết được trích xuất từ ​​thông điệp e-mail và
tệp chỉ mục hiện tại và tiếp tục.

--resolvemsg =
Khi một bản vá lỗi xảy ra, sẽ được in ra màn hình trước khi thoát ra. Cái này
ghi đè thông báo chuẩn thông báo cho bạn sử dụng - tiếp tục hoặc - bỏ qua để xử lý
thất bại. Điều này chỉ dành cho mục đích sử dụng nội bộ giữa git nổi loạn và git am.

--Huỷ bỏ
Khôi phục nhánh gốc và hủy thao tác vá.

THẢO LUẬN

Tên tác giả cam kết được lấy từ dòng "Từ:" của thông báo và tác giả cam kết
ngày được lấy từ dòng "Ngày:" của tin nhắn. Dòng "Chủ đề:" được sử dụng làm
tiêu đề của cam kết, sau khi loại bỏ tiền tố chung "[PATCH ]". Môn học-chủ đề, vấn đề: "
dòng được cho là mô tả chính xác nội dung của cam kết trong một dòng văn bản.

Các dòng "Từ:" và "Chủ đề:" bắt đầu phần nội dung ghi đè tác giả cam kết tương ứng
giá trị tên và tiêu đề được lấy từ tiêu đề.

Thông báo cam kết được hình thành bởi tiêu đề lấy từ "Chủ đề:", một dòng trống và
nội dung thông báo cho đến nơi bắt đầu vá. Khoảng trắng thừa ở cuối mỗi
dòng tự động bị loại bỏ.

Bản vá dự kiến ​​sẽ được nội tuyến, trực tiếp sau thông báo. Bất kỳ dòng nào thuộc
hình thức:

· Ba dấu gạch ngang và cuối dòng, hoặc

· Một dòng bắt đầu bằng "diff -", hoặc

· Một dòng bắt đầu bằng "Chỉ mục:"

được coi là phần mở đầu của một bản vá và thông báo nhật ký cam kết được kết thúc trước khi
sự xuất hiện đầu tiên của một dòng như vậy.

Khi lần đầu gọi git am, bạn cung cấp cho nó tên của các hộp thư cần xử lý. Trên
thấy bản vá đầu tiên không áp dụng được, nó bị hủy ở giữa. Bạn có thể phục hồi từ
điều này theo một trong hai cách:

1. bỏ qua bản vá hiện tại bằng cách chạy lại lệnh với --nhảy tùy chọn.

2. giải quyết xung đột trong thư mục làm việc và cập nhật tệp chỉ mục để mang lại
nó chuyển sang trạng thái mà lẽ ra bản vá đã tạo ra. Sau đó, chạy lệnh với
--tiếp tục tùy chọn.

Lệnh từ chối xử lý các hộp thư mới cho đến khi hoạt động hiện tại kết thúc, vì vậy
nếu bạn quyết định bắt đầu lại từ đầu, hãy chạy git am --abort trước khi chạy lệnh
với tên hộp thư.

Trước khi bất kỳ bản vá nào được áp dụng, ORIG_HEAD được đặt thành phần đầu của nhánh hiện tại. Đây là
hữu ích nếu bạn gặp sự cố với nhiều cam kết, như chạy git am trên nhánh sai
hoặc một lỗi trong các cam kết có thể dễ dàng sửa hơn bằng cách thay đổi hộp thư (ví dụ: lỗi
trong các dòng "Từ:").

SÁCH

Lệnh này có thể chạy các hook applypatch-msg, pre-applypatch và post-applypatch. Nhìn thấy
githook(5) để biết thêm thông tin.

Sử dụng git-am trực tuyến bằng các dịch vụ onworks.net