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

CHƯƠNG TRÌNH:

TÊN

git-blu - Hiển thị bản sửa đổi nào và tác giả đã sửa đổi lần cuối từng dòng của tệp

SYNOPSIS

git đổ lỗi cho [-c] [-b] [-l] [--root] [-t] [-f] [-n] [-s] [-e] [-p] [-w] [--incremental]
[-L ] [-NS ] [-M] [-C] [-C] [-C] [--since = ]
[--abbrev = ] [ | - nội dung | --đảo ngược ] [-]

MÔ TẢ

Chú thích từng dòng trong tệp đã cho với thông tin từ bản sửa đổi mới nhất
đã sửa đổi dòng. Theo tùy chọn, bắt đầu chú thích từ bản sửa đổi đã cho.

Khi được chỉ định một hoặc nhiều lần, -L hạn chế chú thích ở các dòng được yêu cầu.

Nguồn gốc của các dòng được tự động theo sau khi đổi tên toàn bộ tệp (hiện có
không có tùy chọn nào để tắt tính năng theo dõi đổi tên). Để theo dõi các dòng được chuyển từ một tệp sang
khác, hoặc để theo dõi các dòng đã được sao chép và dán từ tệp khác, v.v., hãy xem
Tùy chọn -C và -M.

Báo cáo không cho bạn biết bất cứ điều gì về các dòng đã bị xóa hoặc thay thế; bạn
cần sử dụng một công cụ như git khác hoặc giao diện "cái cuốc" được đề cập ngắn gọn trong
đoạn sau.

Ngoài hỗ trợ chú thích tệp, Git còn hỗ trợ tìm kiếm lịch sử phát triển
cho thời điểm một đoạn mã xảy ra trong một thay đổi. Điều này giúp bạn có thể theo dõi khi mã
đoạn mã đã được thêm vào một tệp, được di chuyển hoặc sao chép giữa các tệp và cuối cùng bị xóa hoặc
đã thay thế. Nó hoạt động bằng cách tìm kiếm một chuỗi văn bản trong khác biệt. Một ví dụ nhỏ về
giao diện cuốc tìm kiếm blued_usage:

$ git log --pretty = oneline -S'blame_usage '
5040f17eba15504bad66b14a645bddd9b015ebb7 blame -S <ancestry-file>
ea4c7f9bf69e781dd0cd88d2bccb2bf5cc15c9a7 git-blame: Make the output

LỰA CHỌN

-b
Hiển thị SHA-1 trống cho các cam kết ranh giới. Điều này cũng có thể được kiểm soát thông qua
tùy chọn cấu hình blu.blankboundary.

--nguồn gốc
Đừng coi các cam kết gốc là ranh giới. Điều này cũng có thể được kiểm soát thông qua
tùy chọn cấu hình blu.showRoot.

--show-thống kê
Bao gồm số liệu thống kê bổ sung ở cuối đầu ra lỗi.

-L , , -L:
Chỉ chú thích phạm vi dòng đã cho. Có thể được chỉ định nhiều lần. Qua nối chồng
phạm vi được cho phép.

và là tùy chọn. “-L ”Hoặc“ -L , ”Kéo dài từ đến
phần cuối của tập tin. “-L, ”Kéo dài từ đầu tệp đến .

và có thể thực hiện một trong các hình thức sau:

· con số

Nếu như hoặc là một số, nó chỉ định một số dòng tuyệt đối (số dòng
từ năm 1).

· / Regex /

Biểu mẫu này sẽ sử dụng dòng đầu tiên khớp với biểu thức POSIX đã cho. Nếu như là một
regex, nó sẽ tìm kiếm từ cuối phạm vi -L trước đó, nếu có, nếu không
từ đầu tệp. Nếu như là “^ / regex /”, nó sẽ tìm kiếm từ đầu
tập tin. Nếu như là một regex, nó sẽ tìm kiếm bắt đầu từ dòng do .

· + Bù đắp hoặc -offset

Điều này chỉ hợp lệ cho và sẽ chỉ định một số dòng trước hoặc sau
dòng được đưa ra bởi .

Nếu như ": ”Được đưa ra thay cho và , nó là một biểu thức chính quy
biểu thị phạm vi từ dòng tên chức năng đầu tiên phù hợp với , lên đến
dòng funcname tiếp theo. “: ”Tìm kiếm từ cuối phạm vi -L trước đó, nếu
bất kỳ, nếu không từ đầu tệp. “^: ”Tìm kiếm từ đầu tệp.

-l
Hiển thị vòng quay dài (Mặc định: tắt).

-t
Hiển thị dấu thời gian thô (Mặc định: tắt).

-NS
Sử dụng các bản sửa đổi từ revs-file thay vì gọi danh sách git-rev(1).

--đảo ngược
Tiến lên lịch sử thay vì lùi lại. Thay vì hiển thị bản sửa đổi trong đó
dòng xuất hiện, điều này cho thấy bản sửa đổi cuối cùng trong đó một dòng đã tồn tại. Điều này đòi hỏi
một loạt các bản sửa đổi như START..END nơi mà con đường đổ lỗi tồn tại trong START.

-p, - sứ
Hiển thị ở định dạng được thiết kế cho máy tiêu dùng.

- dòng-sứ
Hiển thị định dạng sứ, nhưng xuất thông tin cam kết cho mỗi dòng, không chỉ
lần đầu tiên một cam kết được tham chiếu. Hàm ý - sứ.

--tình cảm
Hiển thị kết quả tăng dần theo định dạng được thiết kế cho máy tiêu dùng.

--encoding =
Chỉ định mã hóa được sử dụng để xuất tên tác giả và tóm tắt cam kết. Đặt nó thành
không có lỗi nào làm cho dữ liệu đầu ra không được chuyển đổi. Để biết thêm thông tin, hãy xem thảo luận
về mã hóa trong nhật ký git(1) trang hướng dẫn sử dụng.

- nội dung
Khi nào không được chỉ định, lệnh chú thích các thay đổi bắt đầu từ
bản sao cây làm việc. Cờ này làm cho lệnh giả vờ như thể bản sao của cây làm việc
có nội dung của tệp được đặt tên (chỉ định - để làm cho lệnh được đọc từ
đầu vào chuẩn).

--ngày
Chỉ định định dạng được sử dụng để xuất ngày tháng. Nếu - ngày không được cung cấp, giá trị của
biến cấu hình blu.date được sử dụng. Nếu biến cấu hình Blur.date cũng không được đặt,
định dạng iso được sử dụng. Để biết các giá trị được hỗ trợ, hãy xem thảo luận về tùy chọn --date
at nhật ký git(1).

-M | |
Phát hiện các dòng được di chuyển hoặc sao chép trong một tệp. Khi một cam kết di chuyển hoặc sao chép một khối
(ví dụ: tệp gốc có A và sau đó là B, và cam kết thay đổi nó thành B và
sau đó A), truyền thống đổ lỗi cho thuật toán chỉ thông báo một nửa chuyển động và
thường đổ lỗi cho các dòng được chuyển lên (tức là B) cho phụ huynh và đổ lỗi cho
đến các dòng đã được chuyển xuống (tức là A) cho cam kết con. Với tùy chọn này, cả hai
các nhóm dòng được đổ lỗi cho phụ huynh bằng cách chạy thêm các cuộc kiểm tra.

là tùy chọn nhưng nó là giới hạn dưới về số ký tự chữ và số
rằng Git phải phát hiện là đang di chuyển / sao chép trong một tệp để nó liên kết các dòng đó
với cam kết gốc. Giá trị mặc định là 20.

-C | |
Ngoài -M, phát hiện các dòng được di chuyển hoặc sao chép từ các tệp khác đã được sửa đổi trong
cùng một cam kết. Điều này hữu ích khi bạn tổ chức lại chương trình của mình và di chuyển mã xung quanh
trên các tệp. Khi tùy chọn này được cung cấp hai lần, lệnh cũng sẽ tìm kiếm
bản sao từ các tệp khác trong cam kết tạo tệp. Khi tùy chọn này được đưa ra
ba lần, lệnh cũng tìm kiếm các bản sao từ các tệp khác trong bất kỳ cam kết nào.

là tùy chọn nhưng nó là giới hạn dưới về số ký tự chữ và số
rằng Git phải phát hiện là di chuyển / sao chép giữa các tệp để nó liên kết các dòng đó
với cam kết gốc. Và giá trị mặc định là 40. Nếu có nhiều hơn một -C
các tùy chọn được đưa ra, đối số của -C ​​cuối cùng sẽ có hiệu lực.

-h
Hiển thị thông báo trợ giúp.

-c
Sử dụng cùng một chế độ đầu ra như chú thích git(1) (Mặc định: tắt).

--score-gỡ lỗi
Bao gồm thông tin gỡ lỗi liên quan đến sự di chuyển của các dòng giữa các tệp (xem -C)
và các dòng được di chuyển trong một tệp (xem -M). Số đầu tiên được liệt kê là điểm số. Đây là
số lượng ký tự chữ và số được phát hiện là đã được di chuyển giữa hoặc trong
các tập tin. Điều này phải trên một ngưỡng nhất định cho git đổ lỗi cho để xem xét những dòng
mã đã được di chuyển.

-f, --show-name
Hiển thị tên tệp trong cam kết ban đầu. Theo mặc định, tên tệp được hiển thị nếu có
bất kỳ dòng nào đến từ tệp có tên khác, do phát hiện đổi tên.

-n, --show-số
Hiển thị số dòng trong cam kết ban đầu (Mặc định: tắt).

-s
Bỏ tên tác giả và dấu thời gian khỏi đầu ra.

-e, --show-email
Hiển thị email tác giả thay vì tên tác giả (Mặc định: tắt). Điều này cũng có thể được
được điều khiển thông qua tùy chọn cấu hình blu.showEmail.

-w
Bỏ qua khoảng trắng khi so sánh phiên bản của cha mẹ và phiên bản của trẻ để tìm
các dòng đến từ.

--abbrev =
Thay vì sử dụng các chữ số thập lục phân 7 + 1 mặc định làm tên đối tượng viết tắt,
sử dụng +1 chữ số. Lưu ý rằng 1 cột được sử dụng cho dấu mũ để đánh dấu cam kết ranh giới.

CÁC SỨ FORMAT

Trong định dạng này, mỗi dòng được xuất sau một tiêu đề; tiêu đề ở mức tối thiểu có
dòng đầu tiên có:

· 40 byte SHA-1 của dòng cam kết được quy cho;

· Số dòng của dòng trong tệp gốc;

· Số dòng của dòng trong tệp cuối cùng;

· Trên một dòng bắt đầu một nhóm các dòng từ một cam kết khác với dòng trước đó,
số dòng trong nhóm này. Trên các dòng tiếp theo, trường này không có.

Dòng tiêu đề này được theo sau bởi thông tin sau ít nhất một lần cho mỗi lần cam kết:

· Tên tác giả ("tác giả"), email ("tác giả-thư"), thời gian ("tác giả-thời gian") và múi giờ
("tác giả-tz"); tương tự cho committer.

· Tên tệp trong cam kết mà dòng được quy cho.

· Dòng đầu tiên của thông báo nhật ký cam kết ("tóm tắt").

Nội dung của dòng thực được xuất sau tiêu đề trên, có tiền tố là TAB. Cái này
là cho phép thêm nhiều phần tử tiêu đề sau này.

Định dạng sứ thường ngăn chặn thông tin cam kết đã được nhìn thấy.
Ví dụ: hai dòng bị đổ lỗi cho cùng một cam kết sẽ được hiển thị, nhưng
chi tiết cho cam kết đó sẽ chỉ được hiển thị một lần. Điều này hiệu quả hơn, nhưng có thể yêu cầu
nhiều trạng thái được lưu giữ bởi người đọc. Tùy chọn --line-Ambassador có thể được sử dụng để xuất ra toàn bộ
cam kết thông tin cho mỗi dòng, cho phép sử dụng đơn giản hơn (nhưng kém hiệu quả hơn) như:

# đếm số dòng được gán cho mỗi tác giả
git blu - tập tin đường-sứ |
sed -n 's / ^ tác giả // p' |
sắp xếp | uniq -c | sắp xếp -rn

ĐẶC ĐIỂM KỸ THUẬT CÁC DÃY

Không giống như git đổ lỗi cho và git chú thích trong các phiên bản git cũ hơn, mức độ của chú thích
có thể được giới hạn cho cả phạm vi dòng và phạm vi sửa đổi. Tùy chọn -L, giới hạn
chú thích cho một loạt các dòng, có thể được chỉ định nhiều lần.

Khi bạn quan tâm đến việc tìm nguồn gốc cho các dòng 40-60 cho tệp foo, bạn có thể sử dụng
tùy chọn -L như vậy (chúng có nghĩa giống nhau - cả hai đều yêu cầu 21 dòng bắt đầu từ dòng
40):

git đổ lỗi -L 40,60 foo
git đổ lỗi -L 40, + 21 bức ảnh

Ngoài ra, bạn có thể sử dụng một biểu thức chính quy để chỉ định phạm vi dòng:

git bla bla -L '/ ^ sub xin chào {/, / ^} $ /' foo

giới hạn chú thích đối với phần nội dung của chương trình con hello.

Khi bạn không quan tâm đến những thay đổi cũ hơn phiên bản v2.6.18 hoặc những thay đổi cũ hơn 3
tuần, bạn có thể sử dụng các chỉ định phạm vi sửa đổi tương tự như git danh sách sửa đổi:

git đổ lỗi v2.6.18 .. - foo
git đổ lỗi --since = 3. tuần - foo

Khi các chỉ định phạm vi sửa đổi được sử dụng để giới hạn chú thích, các dòng không
đã thay đổi kể từ ranh giới phạm vi (hoặc cam kết v2.6.18 hoặc cam kết gần đây nhất
hơn 3 tuần tuổi trong ví dụ trên) được đổ lỗi cho cam kết ranh giới phạm vi đó.

Một cách đặc biệt hữu ích là xem liệu tệp đã thêm có các dòng được tạo bằng cách sao chép và dán hay không
từ các tệp hiện có. Đôi khi, điều này cho thấy rằng nhà phát triển đã cẩu thả và đã
không cấu trúc lại mã đúng cách. Trước tiên, bạn có thể tìm thấy cam kết đã giới thiệu tệp
với:

git log --diff-filter = A --pretty = short - foo

và sau đó chú thích sự thay đổi giữa cam kết và cha mẹ của nó, sử dụng commit ^! ký hiệu:

git đổ lỗi -C -C -f $ cam kết ^! - foo

TĂNG OUTPUT

Khi được gọi với tùy chọn --incremental, lệnh sẽ xuất ra kết quả khi nó được tạo. Các
đầu ra nói chung sẽ nói về các dòng được chạm vào bởi các cam kết gần đây hơn đầu tiên (tức là
dòng sẽ được chú thích không theo thứ tự) và được sử dụng bởi những người xem tương tác.

Định dạng đầu ra tương tự như định dạng Sứ, nhưng nó không chứa thực
dòng từ tệp đang được chú thích.

1. Mỗi mục đổ lỗi luôn bắt đầu bằng một dòng:

<40 byte hex sha1>

Số dòng đếm từ 1.

2. Lần đầu tiên một cam kết hiển thị trong luồng, nó có nhiều thông tin khác
về nó được in ra với thẻ một từ ở đầu mỗi dòng mô tả
thông tin cam kết bổ sung (tác giả, email, người cam kết, ngày tháng, bản tóm tắt, v.v.).

3. Không giống như định dạng Sứ, thông tin tên tệp luôn được cung cấp và kết thúc
mục nhập:

"tên tệp"

và do đó nó thực sự khá dễ dàng để phân tích cú pháp đối với một số trình phân tích cú pháp hướng dòng và từ
(điều này sẽ khá tự nhiên đối với hầu hết các ngôn ngữ kịch bản).

Chú thích
Đối với những người làm phân tích cú pháp: để làm cho nó mạnh mẽ hơn, chỉ cần bỏ qua bất kỳ ranh giới nào giữa
cái đầu tiên và cái cuối cùng (" dòng "và" tên tệp ") mà bạn không nhận ra
thẻ từ (hoặc quan tâm đến một từ cụ thể đó) ở đầu
dòng "thông tin mở rộng". Bằng cách đó, nếu có thêm thông tin (như
mã hóa cam kết hoặc bình luận cam kết mở rộng), một người xem đổ lỗi sẽ không quan tâm.

BẢN ĐỒ TÁC GIẢ

Nếu tệp .mailmap tồn tại ở cấp trên cùng của kho lưu trữ hoặc tại vị trí được trỏ
theo các tùy chọn cấu hình mailmap.file hoặc mailmap.blob, nó được sử dụng để tác giả bản đồ và
tên người cam kết và địa chỉ email thành tên thật và địa chỉ email chuẩn.

Ở dạng đơn giản, mỗi dòng trong tệp bao gồm tên thực chuẩn của một
tác giả, khoảng trắng và địa chỉ email được sử dụng trong cam kết (kèm theo < và >) để lập bản đồ
sang tên. Ví dụ:

Tên thích hợp[email được bảo vệ]>

Các dạng phức tạp hơn là:

<[email được bảo vệ]>[email được bảo vệ]>

cho phép mailmap chỉ thay thế phần email của một cam kết và:

Tên thích hợp[email được bảo vệ]>[email được bảo vệ]>

cho phép mailmap thay thế cả tên và email của một cam kết khớp với
địa chỉ email cam kết được chỉ định và:

Tên thích hợp[email được bảo vệ]> Tên cam kết[email được bảo vệ]>

cho phép mailmap thay thế cả tên và email của một cam kết khớp với cả
tên cam kết và địa chỉ email được chỉ định.

Ví dụ 1: Lịch sử của bạn chứa các cam kết của hai tác giả, Jane và Joe, có tên xuất hiện
trong kho lưu trữ dưới một số hình thức:

Joe Nhà phát triển[email được bảo vệ]>
Joe R. Nhà phát triển[email được bảo vệ]>
Jane Doe[email được bảo vệ]>
Jane Doe
Jane D.

Bây giờ, giả sử rằng Joe muốn tên đệm của anh ấy được sử dụng ban đầu và Jane thích họ của mình hơn
đánh vần đầy đủ. Tệp .mailmap thích hợp sẽ trông giống như sau:

Jane Doe
Joe R. Nhà phát triển[email được bảo vệ]>

Lưu ý cách không cần mục nhập cho , bởi vì tên thật của
tác giả đó đã đúng.

Ví dụ 2: Kho lưu trữ của bạn chứa các cam kết từ các tác giả sau:

nick1[email được bảo vệ]>
nick2[email được bảo vệ]>
nick2[email được bảo vệ]>
santa[email được bảo vệ]>
claus[email được bảo vệ]>
CTO[email được bảo vệ]>

Sau đó, bạn có thể muốn một tệp .mailmap giống như sau:

<[email được bảo vệ]>[email được bảo vệ]>
Một số anh chàng[email được bảo vệ]> nick1[email được bảo vệ]>
Tác giả khác[email được bảo vệ]> nick2[email được bảo vệ]>
Tác giả khác[email được bảo vệ]>[email được bảo vệ]>
Ông già Noen[email được bảo vệ]>[email được bảo vệ]>

Sử dụng hàm băm # cho các nhận xét trên dòng riêng của họ hoặc sau địa chỉ email.

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