gbp-dch - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

gbp-dch - Tạo thay đổi Debian từ các thông báo git cam kết

SYNOPSIS

gbp dch [ --phiên bản ] [ --Cứu giúp ] [ --dài dòng ] [ --color =[tự động | bật | tắt] ] [ --màu sắc-
lược đồ =BẢNG MÀU ] [ --debian-branch =Tên chi nhánh ] [ --debian-tag =định dạng thẻ ] [
--upstream-branch =Tên chi nhánh ] [ --upstream-tag =định dạng thẻ ] [ --ignore-chi nhánh ] [
--ảnh chụp nhanh | --phóng thích ] [ --tự động | --since =cam kết ] [ --new-version =phiên bản ] [ --bpo
| --nmu | --qa | --đội ] [ - phân phối =tên ] [ - lực lượng phân phối ] [
--urgency =cấp ] [ --[Không đầy đủ ] [ - [không-] meta ] [ --meta-closees = bug-close-tags ] [
--meta-Closees-bugnum = bug-number-format ] [ --snapshot-number =biểu hiện ] [ --Tôi-
chiều dài =con số ] [ --git-log =tùy chọn git-log ] [ - [no-] git-author ] [ - [no-] multimaint ]
[ - [no-] multimaint-merge ] [ --spawn-editor = [luôn luôn | ảnh chụp nhanh | phát hành] ] [ --làm-
tin nhắn =định dạng tin nhắn ] [ --làm ] [ --customizations =tập tin tùy chỉnh ] [đường dẫn1 đường dẫn2]

MÔ TẢ

gbp dch đọc thông báo cam kết git và tạo bảng thay đổi Debian từ nó. Nếu không
các đối số được đưa ra, gbp dch bắt đầu từ phiên bản gói Debian được gắn thẻ cuối cùng cho đến
đầu hiện tại của chi nhánh hiện tại. Nếu sự phân bố của phần trên cùng trong
debian / changelog is CHƯA ĐƯỢC LIÊN QUAN, các mục thay đổi sẽ được chèn vào phần này.
Nếu không, một phần mới sẽ được tạo.

If --tự động được đưa ra gbp dch, cố gắng đoán cam kết Git cuối cùng được ghi lại trong bảng thay đổi
- điều này chỉ hoạt động trong chế độ chụp nhanh. Nếu không thì, --từ có thể được sử dụng để nói gbp dch at
điểm nào nó sẽ bắt đầu trong lịch sử Git.

Các đối số đường dẫn bổ sung có thể được sử dụng để hạn chế các đường dẫn kho lưu trữ gbp dch nhìn
tại. Thiết lập con đường đến debian / là một lựa chọn tốt nếu ngược dòng sử dụng Git và tất cả đóng gói Debian
các thay đổi bị hạn chế đối với debian / tiểu vương. Trong những trường hợp phức tạp hơn (như
backports), bạn có thể sử dụng --git-log để hạn chế thêm các mục nhập bảng thay đổi đã tạo,
ví dụ bằng cách sử dụng --git-log ="--author = Foo Quán ba".

LỰA CHỌN

--phiên bản
Phiên bản in của chương trình, tức là phiên bản của bộ git-buildpackage

-v

--dài dòng
Thực thi chi tiết

-h

--Cứu giúp In trợ giúp và thoát

--color =[tự động | bật | tắt]
Có sử dụng đầu ra màu hay không.

--color-Scheme =BẢNG MÀU
Màu sắc để sử dụng trong đầu ra (khi màu được bật). Định dạng cho COLOR_SCHEME là
' : : : '. Giá trị số và tên màu được chấp nhận,
các trường trống ngụ ý màu mặc định. Ví dụ, --git-color-Scheme ='lục lam: 34 ::'
sẽ hiển thị thông báo gỡ lỗi bằng màu lục lam, thông báo thông tin có màu xanh lam và các thông báo khác trong
mặc định (tức là cảnh báo và thông báo lỗi màu đỏ).

--debian-branch =Tên chi nhánh
Nhánh trong kho lưu trữ Git mà gói Debian đang được phát triển, mặc định
is chủ.

--upstream-branch =Tên chi nhánh
Nhánh để xác định phiên bản ngược dòng từ. Mặc định là Thượng nguồn.

--git-upper-tag =TAG-ĐỊNH DẠNG
sử dụng định dạng thẻ này khi tìm kiếm thẻ của các phiên bản ngược dòng, mặc định là
ngược dòng /% (phiên bản) s.

--ignore-chi nhánh
Không kiểm tra xem nhánh hiện tại có khớp không chi nhánh debian.

--debian-tag =định dạng thẻ
định dạng thẻ được sử dụng, khi gắn thẻ các phiên bản debian, mặc định là debian /% (phiên bản) s

--since =cam kết
Bắt đầu đọc tin nhắn cam kết tại cam kết.

--tự động, -a
Đoán cam kết cuối cùng được ghi lại trong bảng thay đổi từ biểu ngữ ảnh chụp nhanh (hoặc từ
thẻ cuối cùng nếu không tồn tại biểu ngữ ảnh chụp nhanh).

- [không-] meta
Phân tích cú pháp các thẻ meta như Đóng:, Cảm ơn: và Gbp-Dch:. Xem META TAGS bên dưới.

--meta-Closees =thẻ đóng lỗi
Những thẻ meta nào cần tìm để tạo các mục nhập thay đổi đóng lỗi. Mặc định
là 'Đóng | LP' để hỗ trợ Debian và Launchpad.

--meta-closees-bugnum =lỗi-số-định dạng
Biểu thức chính quy nào nên được sử dụng để phân tích số lỗi. Mặc định là
'(?: bug | issue)? \ #? \ s? \ d +'. Lưu ý: regex sẽ ngăn chặn tất cả các phần của lỗi
số không muốn sử dụng "(? :)", hãy xem hướng dẫn sử dụng Python regex để biết chi tiết.

Ví dụ: --meta-closees-bugnum ="(?: bug)? \ s * ex- \ d +" sẽ khớp với tất cả các điều sau:

Có thể có Txt phù hợp? Kết quả
------------ ------ ------
lỗi EX-12345 Y EX-12345
cũ-01273 Y cũ-01273
lỗi ex-1ab Y ex-1
EX - 12345 N

--[Không đầy đủ
Bao gồm thông báo cam kết đầy đủ trong đầu ra bảng thay đổi.

- ảnh chụp, -S
Tạo một mục phát hành ảnh chụp nhanh. Điều này thêm một số phát hành ảnh chụp nhanh và một cảnh báo
biểu ngữ cho mục thay đổi. Số phiên bản phát hành đang được tăng tự động
với mọi bản phát hành ảnh chụp nhanh mới để tránh các gói bị hạ cấp trong quá trình chụp nhanh
thử nghiệm.

--snapshot-number =biểu hiện
Biểu thức Python nhận eval () ed thành số ảnh chụp nhanh mới.

--phóng thích, -R
Loại bỏ mọi biểu ngữ phát hành ảnh chụp nhanh và hậu tố phiên bản, đặt hiện tại
phân phối cho không ổn địnhvà mở bảng thay đổi để điều chỉnh lần cuối.

--new-version =phiên bản, -N phiên bản
Thêm phần bảng thay đổi mới với phiên bản phiên bản mới. Cùng với --ảnh chụp nhanh, Các
số ảnh chụp nhanh sẽ được thêm vào phiên bản mới.

--đội Tạo mục nhập thay đổi tải lên Nhóm.

--bpo Tăng số lượng bản phát hành Debian để tải lên backport và thêm backport
tải lên bình luận thay đổi.

--nmu Tăng số bản phát hành Debian cho bản tải lên không phải của người bảo trì.

--qa Tăng số bản phát hành Debian để tải lên Nhóm Debian QA và thêm một QA
tải lên bình luận thay đổi.

- phân phối =tên
Đặt trường phân phối thành tên.

- lực lượng phân phối
Buộc phân phối được chỉ định với --phân bổ được sử dụng, ngay cả khi nó không
khớp với danh sách các bản phân phối đã biết.

--urgency =cấp
Đặt trường khẩn cấp thành cấp.

--git-log =tùy chọn git-log
Các tùy chọn được chuyển nguyên văn cho nhật ký git(1).

--id-length =N
Bao gồm N các chữ số của id cam kết trong mục thay đổi. Mặc định là không bao gồm
bất kỳ id cam kết nào.

--ignore-regex =biểu thức chính quy
Bỏ qua các dòng cam kết khớp biểu thức chính quy khi tạo bảng thay đổi.

--git-tác giả
Sử dụng user.name và user.email từ git-config(1) cho trailer changelog.

- [no-] multimaint-merge
Hợp nhất các cam kết của người bảo trì.

--spawn-editor =[luôn luôn | ảnh chụp nhanh | phát hành]
Có tạo ra một trình chỉnh sửa hay không: luôn luôn, khi chụp ảnh nhanh hoặc khi thực hiện một bản phát hành.

--commit-msg =định dạng tin nhắn
sử dụng chuỗi định dạng này cho thông báo cam kết khi cam kết
tệp thay đổi (khi --làm được đưa ra). Mặc định là Cập nhật changelog cho
% (phiên bản) s phát hành

--làm
Cam kết thay đổi được tạo.

--customizations =tập tin tùy chỉnh
Tải mã Python từ tập tin tùy chỉnh. Hiện tại, điều hữu ích duy nhất là
mã có thể làm là xác định một hàm format_changelog_entry () tùy chỉnh.

TÓM TẮT PHƯƠNG THỨC

Chế độ chụp nhanh có thể được sử dụng cho các chu kỳ kiểm tra và cài đặt nhanh chóng mà không cần phải lo lắng về
số phiên bản hoặc mục nhập thay đổi.

Khi đang sử dụng --ảnh chụp nhanh or -S, gbp dch sử dụng tiêu đề giả trong bảng thay đổi Debian để
hãy nhớ git commit cuối cùng nó đã thêm một mục thay đổi cho. Nó cũng đặt một số phiên bản
kết thúc bằng ~ .gbp. Nó tự động tăng ảnh chụp nhanh
số lần gọi tiếp theo của gbp dch -S để các ảnh chụp nhanh sau này tự động có
số phiên bản cao hơn. Để thoát khỏi chế độ chụp nhanh, hãy gọi gbp dch với --phóng thích tùy chọn.
Thao tác này sẽ xóa tiêu đề giả và tách số phiên bản để phiên bản đã phát hành
có số phiên bản cao hơn so với ảnh chụp nhanh.

Kim loại TAGS

Ngoài các tùy chọn trên, định dạng của thông báo cam kết trong debian / changelog
có thể được sửa đổi bởi các thẻ đặc biệt (được gọi là Thẻ Meta) được đưa ra trong thông báo cam kết git. Meta
Quá trình xử lý thẻ có thể được kích hoạt thông qua --meta Lựa chọn. Các thẻ phải bắt đầu ở đầu tiên
cột của một thông báo cam kết nhưng có thể xuất hiện trên bất kỳ dòng nào. Chúng có dạng tên thẻ:
giá trị. Thẻ Meta hợp lệ là:

Gbp-Dch: hoạt động
Các hành động được hỗ trợ là: Bỏ qua sẽ bỏ qua cam kết này khi tạo
debian / changelog, ngắn mà sẽ chỉ sử dụng mô tả (dòng đầu tiên) của
cam kết thông báo khi tạo mục nhập thay đổi (hữu ích khi --đầy được đưa ra),
và Full sẽ sử dụng thông báo cam kết đầy đủ khi tạo mục nhập thay đổi
(hữu ích khi --đầy không được đưa ra).

Ngoài Gbp-Dch, không dùng nữa Git-Dch vẫn được hỗ trợ.

Cảm ơn: msg
Thêm một tin nhắn cảm ơn sau tin nhắn cam kết.

Đóng: số lỗi
Cho biết trong debian / changelog rằng lỗi đã được đóng lại bởi cam kết này. Xem
--meta-đóng cửa về cách mở rộng điều này cho các trình kiểm tra lỗi khác.

Thông báo cam kết git sau:

Thẻ meta tài liệu

vì vậy người ta không cần phải tham khảo sách hướng dẫn

Gbp-Dch: Ngắn
Số lần đóng: # 636088
Cảm ơn: Raphaël Hertzog đã gợi ý

Kết quả trong này debian / changelog mục nhập:

* Thẻ meta tài liệu.
Cảm ơn Raphaël Hertzog về đề xuất (Số lần đóng: # 636088)

CẤU HÌNH CÁC TẬP TIN

Một số gbp.conf các tệp được phân tích cú pháp để đặt giá trị mặc định cho các đối số dòng lệnh ở trên.
Xem gbp.conf(5)> manpage để biết chi tiết.

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