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

CHƯƠNG TRÌNH:

TÊN

aegis sao chép tệp - sao chép tệp vào một thay đổi

SYNOPSIS

sự bảo hộ -CoPy_file [ tùy chọn...] tên tập tinhữu ích. Cảm ơn !
sự bảo hộ -CoPy_file -Sống độc lập [ tùy chọn...] tên tập tinhữu ích. Cảm ơn !
sự bảo hộ -CoPy_file -Danh sách [ tùy chọn...]
sự bảo hộ -CoPy_file -Cứu giúp

MÔ TẢ

Sản phẩm sự bảo hộ -CoPy_file lệnh được sử dụng để sao chép một tệp vào một thay đổi. Các tệp được đặt tên sẽ
được sao chép từ đường cơ sở vào thư mục phát triển và được thêm vào danh sách
các tệp trong sự thay đổi. Phiên bản của các tệp được sao chép từ đường cơ sở được ghi nhớ.

Lệnh này có thể được sử dụng để sao chép các bài kiểm tra thành một thay đổi, không chỉ các tệp nguồn. Kiểm tra là
được xử lý giống như bất kỳ tệp nguồn nào khác và tuân theo cùng một quy trình.

Cảnh báo: Nếu có các tệp trong thư mục phát triển cùng tên, chúng sẽ
bị ghi đè bởi lệnh này.

Bạn cũng có thể đặt tên cho các thư mục. Tất cả các tệp nguồn trong các thư mục được đặt tên và tất cả
các thư mục bên dưới chúng, sẽ được sao chép từ đường cơ sở vào thư mục phát triển,
và được thêm vào danh sách các tệp trong thay đổi.

Khi sao chép tệp một cách rõ ràng, sẽ là một lỗi nếu tệp đó đã là một phần của thay đổi.
Khi bạn đặt tên cho một thư mục, tất cả các tệp nguồn trong dự án bên dưới thư mục đó
được sao chép, ngoại trừ bất kỳ nội dung nào đã có trong thay đổi. Đó là một lỗi nếu không có
các tệp được đặt tên ngầm trong thư mục có thể được sử dụng.

Nếu bạn muốn thay đổi tệp nguồn đã sao chép thành tệp thực thi được (ví dụ: tập lệnh shell)
sau đó bạn chỉ cần sử dụng bình thường chmod(1) lệnh; ngược lại để làm cho nó không thực thi được.
Nếu bất kỳ bit thực thi nào của tệp được đặt tại aede(1) thời gian tệp được ghi nhớ là
thực thi và tất cả các bit thực thi (trừ đi umask của dự án) sẽ được thiết lập sau
aecp(1) lệnh.

Tập tin Họ tên Sự giải thích
Chương trình aegis sẽ cố gắng xác định tên tệp dự án từ tên tệp
được đưa ra trên dòng lệnh. Tất cả các tên tệp được lưu trữ trong các dự án aegis dưới dạng tương đối
vào gốc của cây thư mục cơ sở. Thư mục phát triển và
thư mục tích hợp là bóng của thư mục cơ sở này và vì vậy những tên tương đối này
cũng đăng ký ở đây. Các tệp có tên trên dòng lệnh đầu tiên được chuyển đổi thành đường dẫn tuyệt đối
Nếu cần. Sau đó, chúng được so sánh với đường dẫn cơ sở, thư mục phát triển
và đường dẫn thư mục tích hợp, để xác định tên tương đối đường cơ sở. Nó là
lỗi nếu tệp có tên nằm ngoài một trong các cây thư mục này.

Sản phẩm -BAse_Relative tùy chọn có thể được sử dụng để làm cho các tên tệp tương đối được hiểu là
liên quan đến đường cơ sở; tên tệp tuyệt đối sẽ vẫn được so sánh với các
đường dẫn để xác định tên đường cơ sở-tương đối.

Sản phẩm tên_tệp_tương_chính trong tệp cấu hình người dùng có thể được sử dụng để sửa đổi
hành vi mặc định này. Nhìn thấy aeuconf(5) để biết thêm thông tin.

Quy trình xét duyệt Bên Effects
Lệnh này sẽ hủy bỏ mọi đăng ký xây dựng hoặc kiểm tra, vì thêm một tệp khác
hợp lý làm mất hiệu lực của chúng. Nếu tệp cấu hình dự án đã được thêm vào, bất kỳ sự khác biệt nào
đăng ký cũng sẽ bị hủy bỏ.

Khi các tệp thay đổi được liệt kê (sự bảo hộ -Danh sách Thay đổi_Files -TERse) các tệp được sao chép sẽ
xuất hiện trong danh sách. Khi các tệp dự án được liệt kê với một số thay đổi rõ ràng
(sự bảo hộ -Danh sách Dự án_Files -TERse -Thay đổi N) không có tệp nào của thay đổi, bao gồm
các tệp đã sao chép, sẽ xuất hiện trong danh sách ngắn gọn. Hai tính năng này rất hữu ích khi
gọi aegis từ bên trong DMT để tạo danh sách các tệp nguồn.

CÁC CƠ SỞ KHÓA

Khóa đường cơ sở được sử dụng để đảm bảo rằng đường cơ sở vẫn ở trạng thái nhất quán cho
thời lượng của các lệnh cần đọc nội dung của tệp trong đường cơ sở.

Các lệnh yêu cầu đường cơ sở phải nhất quán (chúng bao gồm A và B(1)
aecp(1) aed(1) lệnh) lấy đường cơ sở đọc Khóa. Đây là một khóa không độc quyền, vì vậy
sự phát triển đồng thời của những thay đổi không bị cản trở.

Lệnh sửa đổi đường cơ sở, aeipass(1), lấy một đường cơ sở viết Khóa. Cái này
là một khóa độc quyền, buộc aeipass(1) để chặn cho đến khi không có số đọc đường cơ sở đang hoạt động
ổ khóa.

Có thể một trong các lệnh phát triển ở trên sẽ chặn cho đến khi
sự bảo hộ -Tích hợp_PASS hoàn thành. Điều này thường có thời gian ngắn trong khi dự án
lịch sử được cập nhật. Độ trễ là cần thiết để các lệnh này nhận được một
xem đường cơ sở. Không có lệnh tích hợp nào khác sẽ gây ra sự phát triển trên
các lệnh để chặn.

Khi chức năng nhánh của aegis được sử dụng, khóa đọc (không độc quyền) sẽ được thực hiện trên
đường cơ sở nhánh và cả từng đường cơ sở "mẹ". Tuy nhiên, một cơ sở viết
(độc quyền) khóa chỉ được thực hiện trên đường cơ sở nhánh; các đường cơ sở "mẹ" chỉ là
đọc (không độc quyền) bị khóa.

THI QUAN HỆ

Lệnh “aegis -Test -SUGgest” có thể được sử dụng để aegis gợi ý hồi quy phù hợp
kiểm tra thay đổi của bạn, dựa trên các tệp nguồn trong thay đổi của bạn. Điều này tự động
tập trung nỗ lực thử nghiệm vào các thử nghiệm có liên quan, giảm số lượng thử nghiệm hồi quy
cần thiết để tự tin rằng bạn đã không giới thiệu một lỗi.

Các tương quan kiểm tra được tạo bởi lệnh “aegis -Integrate_Pass”, lệnh này
liên kết từng thử nghiệm trong thay đổi với từng tệp nguồn trong thay đổi. Do đó, mỗi
tệp nguồn tích lũy một danh sách các bài kiểm tra đã được liên kết với nó trong quá khứ.
Điều này không chính xác như phân tích phạm vi mã, nhưng là một ước tính hợp lý trong
thực hành.

Sản phẩm aecp(1) aenf(1) các lệnh được sử dụng để liên kết các tệp với một thay đổi. Trong khi họ
không tích cực thực hiện liên kết, đây là những tệp được sử dụng bởi aeipass(1)
aet(1) để xác định tệp nguồn nào được liên kết với các bài kiểm tra nào.

Thử nghiệm Tương quan tính chính xác
Giả sử rằng các mối tương quan của thử nghiệm là chính xác và các thử nghiệm là đồng đều
được phân phối trên không gian chức năng, sẽ có ít hơn 1 / số cơ hội rằng một
kiểm tra liên quan chưa được chạy bởi “aegis -Test -SUGgest con số" chỉ huy. Nhỏ
lượng tiếng ồn được thêm vào trọng số thử nghiệm, do đó, đôi khi những điều không mong muốn
đã kiểm tra và các bài kiểm tra giống nhau không được chạy mọi lúc.

Độ chính xác của mối tương quan kiểm tra có thể được cải thiện bằng cách đảm bảo rằng:

· Mỗi thay đổi nên được tập trung mạnh mẽ, không có sự bao gồm tệp vô cớ. Cái này
tránh các tương quan giả.

· Mỗi mục của chức năng mới nên được thêm vào trong một thay đổi riêng lẻ, thay vì
một số với nhau. Điều này tương quan chặt chẽ giữa các bài kiểm tra với chức năng.

· Mỗi lỗi nên được sửa trong một thay đổi riêng lẻ, thay vì nhiều lỗi cùng nhau. Cái này
tương quan chặt chẽ giữa các bài kiểm tra với chức năng.

· Các mối tương quan kiểm tra sẽ bị mất nếu các tập tin được di chuyển. Điều này là do các mối tương quan là bởi
tên.

Cách tốt nhất để các bài kiểm tra tương quan chính xác với các tệp nguồn là khi có sự thay đổi
chứa một thử nghiệm và chính xác những tệp đó liên quan đến chức năng đang thử nghiệm. Quá
nhiều tập tin giả sẽ làm suy yếu tính hữu ích của các mối tương quan thử nghiệm.

Thông báo
Sản phẩm sao chép_file_lệnh Trong dự án cấu hình tệp được chạy, nếu được thiết lập. Các dự án_file_‐
lệnh cũng được chạy, nếu được thiết lập và nếu gần đây đã có tích hợp. Nhìn thấy
aepconf(5) để biết thêm thông tin.

Tập tin Hoạt động Điều chỉnh
Khi lệnh này chạy, trước tiên nó sẽ kiểm tra các tệp thay đổi so với các tệp dự án. Nếu như
có sự mâu thuẫn, các hành động tệp sẽ được điều chỉnh như sau:

tạo Nếu một tệp đang được tạo, nhưng một tập hợp thay đổi khác được tích hợp, điều này cũng
tạo tệp, hành động tệp trong tập hợp thay đổi vẫn đang được phát triển sẽ
được điều chỉnh để "sửa đổi".

sửa đổi Nếu một tệp đang được sửa đổi, nhưng một tập hợp thay đổi khác được tích hợp sẽ loại bỏ
tệp, hành động tệp trong tập hợp thay đổi vẫn đang được phát triển sẽ
được điều chỉnh để "tạo".

loại bỏ Nếu một tệp đang bị xóa, nhưng một tập hợp thay đổi khác được tích hợp sẽ xóa
tệp, tệp sẽ bị xóa khỏi tập thay đổi vẫn đang được phát triển.

LỰA CHỌN

Các tùy chọn sau được hiểu:

-BAse_Relative
Tùy chọn này có thể được sử dụng để làm cho các tên tệp tương đối được coi là liên quan đến
phần gốc của cây nguồn. Nhìn thấy aeuconf(5) cho người dùng tương ứng
ưu đãi.

-CUrrent_Relative
Tùy chọn này có thể được sử dụng để làm cho các tên tệp tương đối được coi là liên quan đến
thư mục hiện tại. Đây thường là mặc định. Nhìn thấy aeuconf(5) cho
sở thích người dùng tương ứng.

-Chi nhánh con số
Tùy chọn này có thể được sử dụng để chỉ định một nhánh khác cho tệp gốc, thay vì
so với đường cơ sở. (Xem thêm -Thân cây Lựa chọn. Xin lưu ý: -Chi nhánh tùy chọn
không lấy tên dự án, chỉ là hậu tố số nhánh.

-Ông bà
Tùy chọn này có thể được sử dụng để chỉ định nhánh ông bà (một nhánh lên từ
nhánh hiện tại) cho tệp gốc, thay vì đường cơ sở. (The -grandparent
tùy chọn giống như tùy chọn “-branch ..”.)

-Thay đổi con số
Tùy chọn này có thể được sử dụng để chỉ định một thay đổi cụ thể trong một dự án. Nhìn thấy
sự bảo hộ(1) để có mô tả đầy đủ về tùy chọn này.

-DEL ta con số
Tùy chọn này có thể được sử dụng để chỉ định một vùng châu thổ cụ thể trong lịch sử của dự án để
sao chép tệp từ, thay vì phiên bản mới nhất. Nếu vùng đồng bằng đã được
được đặt một cái tên (xem aedn(1) để biết cách làm) bạn có thể sử dụng tên delta thay vì delta
con số. Đó là một lỗi nếu delta được chỉ định không tồn tại. Số Delta
bắt đầu từ 1 và tăng dần; delta 0 là một trường hợp đặc biệt có nghĩa là "khi nhánh
đã bắt đầu".

-DELta_Ngày chuỗi
Tùy chọn này có thể được sử dụng để chỉ định một ngày và giờ cụ thể trong dự án
lịch sử để sao chép tệp từ đó, thay vì phiên bản mới nhất. Nó là một
nếu chuỗi được chỉ định không thể được hiểu là ngày và giờ hợp lệ.
Trích dẫn chuỗi nếu bạn cần sử dụng dấu cách.

-DELta_From_Change con số
Tùy chọn này có thể được sử dụng để chỉ định một vùng đồng bằng của dự án cụ thể khỏi sự thay đổi của nó
con số.

-Cứu giúp
Tùy chọn này có thể được sử dụng để có thêm thông tin về cách sử dụng sự bảo hộ
chương trình.

-Sống độc lập
Tùy chọn này được sử dụng để chỉ định rằng bản sao sẽ được chạy độc lập với bất kỳ
thay đổi cụ thể. Các tệp sẽ được sao chép liên quan đến thư mục hiện tại.

-Giữ cho
Tùy chọn này có thể được sử dụng để giữ lại các tệp và / hoặc thư mục thường bị xóa hoặc
được thay thế bằng lệnh. Mặc định cho người dùng xóa_file_preference nếu không
chỉ định, xem aeuconf(5) để biết thêm thông tin.

-Không_Keep
Tùy chọn này có thể được sử dụng để đảm bảo rằng các tệp và / hoặc thư mục bị xóa
hoặc được thay thế bằng lệnh. Mặc định cho người dùng xóa_file_preference nếu không
chỉ định, xem aeuconf(5) để biết thêm thông tin.

-Danh sách
Tùy chọn này có thể được sử dụng để lấy danh sách các đối tượng phù hợp cho lệnh này.
Danh sách có thể chung chung hơn dự kiến.

-Không_Logging
Tùy chọn này có thể được sử dụng để tắt tính năng ghi đầu ra tự động và các lỗi đối với
một tập tin. Điều này thường hữu ích khi một số lệnh aegis được kết hợp trong một trình bao
kịch bản.

- Đầu ra tên tập tin
Tùy chọn này có thể được sử dụng để chỉ định tệp đầu ra của tệp đang được sao chép từ
đường cơ sở. Chỉ một tệp cơ sở có thể được đặt tên khi tùy chọn này được sử dụng. Các
tên tệp "-" được hiểu là đầu ra chuẩn. Tùy chọn này không
thêm tệp vào tập hợp các tệp thay đổi. Không ổ khóa được thực hiện khi tùy chọn này là
được sử dụng, thậm chí không phải là khóa đọc đường cơ sở.

-Ghi đè
Tùy chọn này có thể được sử dụng để buộc ghi đè tệp. Hành động mặc định là
đưa ra lỗi nếu tệp hiện có sẽ bị ghi đè.

-Dự án tên
Tùy chọn này có thể được sử dụng để chọn dự án quan tâm. Khi không -Dự án
tùy chọn được chỉ định, AEGIS_DỰ ÁN biến môi trường được tham khảo. Nếu như
không tồn tại, của người dùng $ HOME / .aegisrc tệp được kiểm tra cho một mặc định
lĩnh vực dự án (xem aeuconf(5) để biết thêm thông tin). Nếu điều đó không tồn tại,
khi người dùng chỉ làm việc với các thay đổi trong một dự án, dự án
tên mặc định cho dự án đó. Nếu không, đó là một lỗi.

-Chỉ đọc
Tùy chọn này có thể được sử dụng để chỉ định rằng tệp sẽ được sử dụng để cách ly
thay đổi so với đường cơ sở. Người dùng không có ý định chỉnh sửa tệp. Này
tệp phải được hủy mở trước khi quá trình phát triển có thể kết thúc.

-Hủy bỏ
Tùy chọn này có thể được sử dụng để hủy bỏ (khôi phục) một thay đổi đã hoàn thành. Sự thay đổi thành
hủy bỏ (quay lại) được chỉ định theo cách thông thường, với một trong các --delta
tùy chọn.

-TERse
Tùy chọn này có thể được sử dụng để làm cho danh sách tạo ra mức tối thiểu
thông tin. Nó thường hữu ích cho các tập lệnh shell.

-Thân cây
Tùy chọn này có thể được sử dụng để chỉ định thân dự án cho tệp gốc, thay vì
so với đường cơ sở. (Xem thêm -Chi nhánh tùy chọn, tùy chọn -trunk giống như
tùy chọn “-branch -”.)

-Dài dòng
Tùy chọn này có thể được sử dụng để tạo ra aegis để tạo ra nhiều đầu ra hơn. Theo aegis mặc định
chỉ sản xuất đầu ra khi có lỗi. Khi được sử dụng với -Danh sách tùy chọn tùy chọn này
khiến các tiêu đề cột được thêm vào.

-Chờ đợi Tùy chọn này có thể được sử dụng để yêu cầu các lệnh Aegis chờ khóa truy cập, nếu
chúng không thể được lấy ngay lập tức. Mặc định cho người dùng lock_wait_preference
nếu không được chỉ định, hãy xem aeuconf(5) để biết thêm thông tin.

-Không chờ đợi
Tùy chọn này có thể được sử dụng để yêu cầu các lệnh Aegis phát ra lỗi nghiêm trọng nếu truy cập
khóa không thể lấy được ngay lập tức. Mặc định cho người dùng
lock_wait_preference nếu không được chỉ định, hãy xem aeuconf(5) để biết thêm thông tin.

Xem thêm sự bảo hộ(1) cho các tùy chọn chung cho tất cả các lệnh aegis.

Tất cả các tùy chọn có thể được viết tắt; chữ viết tắt được ghi lại dưới dạng các chữ cái viết hoa,
tất cả các chữ cái thường và dấu gạch dưới (_) là tùy chọn. Bạn phải sử dụng liên tiếp
chuỗi các chữ cái tùy chọn.

Tất cả các tùy chọn đều không phân biệt chữ hoa chữ thường, bạn có thể nhập chúng bằng chữ hoa hoặc chữ thường hoặc
kết hợp của cả hai, trường hợp không quan trọng.

Ví dụ: các đối số "-project," -PROJ "và" -p "đều được hiểu là
-Dự án Lựa chọn. Đối số "-prj" sẽ không được hiểu vì liên tiếp
các ký tự tùy chọn không được cung cấp.

Tùy chọn và các đối số dòng lệnh khác có thể được kết hợp tùy ý trên dòng lệnh,
sau các bộ chọn chức năng.

Các tên tùy chọn dài GNU được hiểu. Vì tất cả các tên tùy chọn cho sự bảo hộ dài,
điều này có nghĩa là bỏ qua phần đầu phụ '-'. Các "--tùy chọn=giá trị"quy ước cũng là
hiểu.

NÊN ALIAS

Bí danh được đề xuất cho lệnh này là
csh% bí danh aecp 'aegis -cp \! * -v'
sh $ aecp () {aegis -cp "$ @" -v}

LRI

Đó là một lỗi nếu thay đổi không nằm trong được phát triển nhà nước.
Đó là một lỗi nếu thay đổi không được chỉ định cho người dùng hiện tại.
Đó là một lỗi nếu tệp đã được thay đổi và -Ghi đè tùy chọn không phải là
được chỉ định.

EXIT TÌNH TRẠNG

Sản phẩm sự bảo hộ lệnh sẽ thoát với trạng thái là 1 đối với bất kỳ lỗi nào. Các sự bảo hộ lệnh sẽ chỉ
thoát với trạng thái 0 nếu không có lỗi.

MÔI TRƯỜNG BIẾN

Xem sự bảo hộ(1) cho danh sách các biến môi trường có thể ảnh hưởng đến lệnh này. Nhìn thấy
aepconf(5) cho tệp cấu hình dự án dự án_cụ thể trường để biết cách thiết lập
biến môi trường cho tất cả các lệnh được thực thi bởi Aegis.

VÍ DỤ

Dưới đây là một số ví dụ đơn giản. Hãy nhớ rằng hầu hết các lệnh đều liên quan đến dòng điện
thư mục, ngay cả khi những ví dụ này giả định rằng bạn đang ở cơ sở của sự phát triển
cây thư mục.

Sao chép Toàn bộ Dự án
Để sao chép toàn bộ dự án vào thay đổi của bạn, hãy sử dụng lệnh
aecp.
Dấu chấm ở cuối là một phần của lệnh, nó có nghĩa là "thư mục cong và mọi thứ
bên dưới nó ". Điều này hoạt động cho bất kỳ thư mục nào trong cây nguồn dự án của bạn, nếu bạn muốn
hoạt động chọn lọc hơn.

Giới thiệu Sớm hơn Dự án phiên bản
Bạn muốn sao chép chính xác các nguồn cho phiên bản trước đó của dự án của mình,
bạn cần biết số edelta (sử dụng con lươn lịch sử proj để tìm thấy nó). Sau đó sử dụng cái này
chỉ huy:
aecp-delta n .
Ở đâu n là số delta từ lịch sử dự án. Một lần nữa, dấu chấm ở cuối là một phần của
lệnh. Bằng cách sử dụng phiên bản $ sự thay thế (xem aesub(5) để biết thêm thông tin) bạn
có thể nhúng số delta này vào chương trình của bạn trước khi phân phối nó.

Cũng có thể đưa ra một số thay đổi trước đó, thay vào đó, sử dụng lệnh này:
aecp -delta-từ-thay đổi n .
Ở đâu n là số thay đổi của lãi suất. Một lần nữa, dấu chấm ở cuối là một phần của
chỉ huy.

Hủy bỏ a Thay đổi
Khi bạn cần hủy bỏ (hủy bỏ) một thay đổi đã hoàn thành, nó có thể sẽ là một số
thời gian trước, vì vậy bạn cần biết số delta hoặc số thay đổi. Sử dụng lệnh này:
aecp-delta n -giải quyết.
Ở đâu n là số delta của lãi suất. Tất cả các biến thể -delta khác cũng hoạt động, vì vậy
nếu bạn biết số thay đổi, bạn có thể lựa chọn nhiều hơn về những tệp để sao chép:
aecp -delta-từ-thay đổi n `aegis -l cf -ter -c n`
Ở đâu n là số thay đổi của lãi suất. Điều này chỉ sao chép các tệp trong
thay đổi vi phạm.

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