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

CHƯƠNG TRÌNH:

TÊN

stg - Quản lý đống bản vá lỗi bằng trình theo dõi nội dung Git

SYNOPSIS

stg [--version | --Cứu giúp]
stg [--Cứu giúp | --Cứu giúp]
stg [LỰA CHỌN LỆNH] [ARGS]

MÔ TẢ

StGit (Stacked Git) là một ứng dụng cung cấp một cách thuận tiện để duy trì một bản vá
ngăn xếp trên đầu nhánh Git:

· Các cam kết trên cùng (gần đây nhất) của một nhánh được đặt tên. Một cam kết được đặt tên như vậy là
gọi là bản vá.

· Sau khi thực hiện các thay đổi đối với worktree, bạn có thể kết hợp các thay đổi vào một
vá; cái này được gọi là làm mới. Bạn có thể làm mới bất kỳ bản vá nào, không chỉ bản vá trên cùng.

· Bạn có thể bật một bản vá: tạm thời đặt nó sang một bên, để bản vá bên dưới nó trở thành
miếng dán trên cùng. Sau này bạn có thể đẩy nó lại vào ngăn xếp. Đẩy và bật có thể
được sử dụng để sắp xếp lại các bản vá lỗi.

· Bạn co thể dê dang nổi loạn ngăn xếp bản vá của bạn trên bất kỳ cam kết Git nào khác. (Các cơ sở của một
ngăn xếp bản vá là cam kết Git gần đây nhất không phải là bản vá StGit.) Ví dụ: nếu
bạn bắt đầu tạo các bản vá trên đầu chi nhánh của người khác và người đó xuất bản
một chi nhánh được cập nhật, bạn có thể lấy tất cả các bản vá của mình và áp dụng chúng trên đầu bản cập nhật
chi nhánh.

· Như bạn mong đợi, việc thay đổi những gì bên dưới bản vá có thể khiến bản vá đó không còn nữa
áp dụng một cách sạch sẽ - điều này có thể xảy ra khi bạn sắp xếp lại các bản vá, căn cứ lại các bản vá hoặc làm mới một
bản vá không trên cùng. StGit sử dụng khả năng hợp nhất ba chiều nhận biết đổi tên của Git để
tự động sửa chữa những gì nó có thể; nếu nó vẫn không thành công, nó cho phép bạn giải quyết thủ công
xung đột giống như bạn giải quyết xung đột hợp nhất trong Git.

· Ngăn xếp bản vá chỉ là một số siêu dữ liệu bổ sung được gắn vào các cam kết Git thông thường, vì vậy bạn
có thể tiếp tục sử dụng hầu hết các công cụ Git cùng với StGit.

Điển hình sử dụng
Theo dõi chi nhánh
Theo dõi các thay đổi từ một chi nhánh từ xa, trong khi duy trì các sửa đổi cục bộ chống lại
nhánh đó, có thể với mục đích gửi một số bản vá ngược dòng. Bạn có thể sửa đổi
ngăn xếp bản vá của bạn nhiều như bạn muốn và khi các bản vá của bạn cuối cùng được chấp nhận
ngược dòng, lịch sử Git được ghi lại vĩnh viễn sẽ chỉ chứa chuỗi cuối cùng của
các bản vá chứ không phải chuỗi chỉnh sửa lộn xộn đã tạo ra chúng.

Các lệnh quan tâm trong dòng công việc này là rebase và mail.

Chi nhánh phát triển
Ngay cả khi bạn không có "ngược dòng" để gửi các bản vá, bạn có thể sử dụng StGit như một
cách sửa đổi lịch sử gần đây của một nhánh Git. Ví dụ, thay vì đầu tiên
cam kết thay đổi A, sau đó thay đổi B, và sau đó A2 để sửa chữa A bởi vì nó không hoàn toàn
đúng, bạn có thể kết hợp bản sửa lỗi trực tiếp vào A. Cách làm việc này dẫn đến một
lịch sử Git dễ đọc hơn nhiều so với việc bạn đã bất tử hóa mọi sai lầm mà bạn mắc phải
theo cách của bạn để giải pháp phù hợp.

Các lệnh quan tâm trong dòng công việc này chẳng hạn như bỏ ghi chú, có thể được sử dụng để di chuyển
bản vá cơ sở ngăn xếp trở xuống - tức là, biến các cam kết Git thành các bản vá lỗi StGit sau khi thực tế
- và cam kết, nghịch đảo của nó.
Để biết thêm thông tin, xem các hướng dẫn[1.

Chỉ định các bản vá lỗi
Nhiều lệnh StGit lấy tham chiếu đến các bản vá StGit làm đối số. Các bản vá trong ngăn xếp
được xác định bằng các tên ngắn, mỗi tên phải là duy nhất trong ngăn xếp.

Các bản vá trong nhánh hiện tại chỉ được gọi bằng tên của chúng. Một số lệnh cho phép
bạn chỉ định một bản vá trong một nhánh khác của kho lưu trữ; điều này được thực hiện bằng cách thêm tiền tố
tên bản vá với tên chi nhánh và dấu hai chấm (ví dụ: otherbranch: thatpatch).

Chỉ định cam kết
Một số lệnh StGit lấy các cam kết Git làm đối số. StGit chấp nhận tất cả các biểu thức cam kết
Git đó; và thêm vào đó, tên bản vá (tùy chọn tiền tố của tên nhánh và
dấu hai chấm) được cho phép trong ngữ cảnh này. Các bổ ngữ Git thông thường ^ và ~ cũng được phép; ví dụ,
abranch: apatch ~ 2 là ông lớn của cam kết là bản vá lỗi trên nhánh
một chi nhánh.

Thay vì tên bản vá, bạn có thể nói {base} để tham chiếu đến cơ sở ngăn xếp (chỉ cam kết
bên dưới miếng dán dưới cùng); vì vậy, abranch: {base} là cơ sở của ngăn xếp trong nhánh
một chi nhánh.

Nếu bạn cần chuyển một tham chiếu StGit đã cho tới một lệnh Git, id-stg(1) sẽ chuyển đổi nó thành
một id cam kết Git cho bạn.

LỰA CHỌN

Các cờ tùy chọn chung sau đây có sẵn. Các tùy chọn bổ sung có sẵn cho
(và được ghi lại bằng) các lệnh con khác nhau.

--phiên bản
In phiên bản StGit, cũng như phiên bản của các thành phần khác được sử dụng, chẳng hạn như Git và
Con trăn.

--Cứu giúp
In tóm tắt và danh sách tất cả các lệnh con. Nếu một lệnh con StGit được đưa ra,
in mã tổng hợp cho lệnh con đó.

STGIT HÀNG

Chúng tôi chia các lệnh StGit thành các nhóm chủ đề, theo loại đối tượng chính mà chúng
tạo hoặc thay đổi.

Dưới đây là một mô tả ngắn về mỗi lệnh. Mô tả chi tiết hơn có sẵn trong
các trang lệnh riêng lẻ. Những trang đó được đặt tên stg- (1).

Kho lệnh
bản sao stg(1)
Tạo bản sao cục bộ của một kho lưu trữ từ xa

id-stg(1)
In giá trị băm git của tham chiếu StGit

Sắp xếp (chi nhánh) lệnh
chi nhánh stg(1)
Các thao tác rẽ nhánh: chuyển đổi, liệt kê, tạo mới, đổi tên, xóa, ...

sạch sẽ(1)
Xóa các bản vá trống trong chuỗi

stg-cam kết(1)
Lưu trữ vĩnh viễn các bản vá đã áp dụng vào cơ sở ngăn xếp

stg-float(1)
Đẩy các bản vá lỗi lên trên cùng, ngay cả khi đã được áp dụng

stg-goto(1)
Đẩy hoặc bật các bản vá lỗi đến một bản đã cho

stg-trốn(1)
Ẩn một bản vá trong chuỗi

stg-init(1)
Khởi tạo nhánh hiện tại để sử dụng với StGIT

nhật ký stg(1)
Hiển thị bảng thay đổi bản vá

stg-tiếp theo(1)
In tên của bản vá tiếp theo

stg-patch(1)
Hiển thị các bản vá đã áp dụng sửa đổi tệp

stg-pop(1)
Bật một hoặc nhiều bản vá lỗi từ ngăn xếp

stg-trước(1)
In tên của bản vá trước đó

stg-xuất bản(1)
Đẩy các thay đổi ngăn xếp sang một nhánh thân thiện với hợp nhất

stg-kéo(1)
Kéo các thay đổi từ kho lưu trữ từ xa

đẩy stg(1)
Đẩy một hoặc nhiều bản vá vào ngăn xếp

stg-rebase(1)
Di chuyển cơ sở ngăn xếp đến một điểm khác trong lịch sử

làm lại stg(1)
Hoàn tác thao tác hoàn tác cuối cùng

sửa chữa stg(1)
Sửa siêu dữ liệu StGit nếu nhánh được sửa đổi bằng lệnh git

thiết lập lại stg(1)
Đặt lại ngăn xếp bản vá về trạng thái trước đó

dòng stg(1)
In loạt bản vá

stg-chìm(1)
Gửi các bản vá sâu hơn xuống ngăn xếp

stg-bí(1)
Gộp hai hoặc nhiều bản vá thành một

stg-top(1)
In tên của bản vá hàng đầu

stg-bỏ ghi chú(1)
Biến các cam kết git thông thường thành các bản vá lỗi StGit

stg-hoàn tác(1)
Hoàn tác thao tác cuối cùng

stg-hiện(1)
Hiện một bản vá ẩn

Vá lệnh
stg-xóa(1)
Xóa các bản vá lỗi

stg-sửa(1)
Chỉnh sửa mô tả bản vá hoặc khác biệt

xuất khẩu stg(1)
Xuất các bản vá vào một thư mục

tập tin stg(1)
Hiển thị các tệp được sửa đổi bởi một bản vá (hoặc bản vá hiện tại)

stg-gấp(1)
Tích hợp một bản vá lỗi GNU vào bản vá hiện tại

stg-nhập(1)
Nhập tệp khác biệt GNU dưới dạng bản vá mới

thư stg(1)
Gửi một bản vá hoặc một loạt các bản vá qua e-mail

stg-mới(1)
Tạo một bản vá mới, trống

chọn stg(1)
Nhập một bản vá từ một nhánh khác hoặc một đối tượng cam kết

làm mới stg(1)
Tạo cam kết mới cho bản vá hiện tại

đổi tên stg(1)
Đổi tên một bản vá

stg-show(1)
Hiển thị cam kết tương ứng với một bản vá

đồng bộ hóa stg(1)
Đồng bộ hóa các bản vá với một nhánh hoặc một chuỗi

Chỉ mục / worktree lệnh
stg-khác biệt(1)
Hiển thị sự khác biệt của cây

CẤU HÌNH CƠ CHẾ

StGit sử dụng cơ chế cấu hình tương tự như Git. Nhìn thấy git(7) để biết thêm chi tiết.

TEMPLATES

Một số lệnh StGit sử dụng tệp mẫu để cung cấp văn bản mặc định hữu ích cho
được chỉnh sửa bởi người dùng. Này các tệp mẫu .tmpl được tìm kiếm trong phần sau
thư mục:

1. $ GITDIR / (trên thực tế, thư mục .git / trong kho lưu trữ của bạn)

2. $ HOME / .stgit / các mẫu /

3. / usr / share / stgit / template /

GHI CHÚ

1. hướng dẫn
[set $ man.base.url.for.relative.links] /tutorial.html

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