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

CHƯƠNG TRÌNH:

TÊN

aegis xóa tệp - thêm tệp cần xóa vào một thay đổi

SYNOPSIS

sự bảo hộ -ReMove_file tên tập tin... [ tùy chọn...]
sự bảo hộ -ReMove_file -Danh sách [ tùy chọn...]
sự bảo hộ -ReMove_file -Cứu giúp

MÔ TẢ

Sản phẩm sự bảo hộ -ReMove_file lệnh được sử dụng để thêm tệp bị xóa vào một thay đổi. Tập tin
sẽ được thêm vào danh sách các tệp trong thay đổi và sẽ bị xóa khỏi đường cơ sở
tại thời điểm hội nhập.

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

Một tệp sẽ được tạo trong thư mục phát triển chứa 1KB văn bản ngẫu nhiên. Các
văn bản ngẫu nhiên đủ nổi loạn để hầu hết các trình biên dịch sẽ đưa ra thông báo lỗi,
nếu tệp được tham chiếu vô tình. Điều này thường rất hữu ích khi loại bỏ
bao gồm các tệp.

Bạn có thể chỉ định một tên thư mục để xóa tất cả các tệp trong cây thư mục được đặt tên. Nó là
một lỗi nếu không có tệp liên quan.

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ì việc thêm tệp một cách hợp lý
làm mất hiệu lực của chúng.

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

Thay đổi các Kiểu of a Tập tin
Nếu bạn muốn thay đổi loại tệp (giả sử từ thử nghiệm thành tệp nguồn, hoặc phó
ngược lại) bạn có thể thực hiện như hai thay đổi, bằng cách sử dụng đầu tiên không khí(1) trong một lần thay đổi và sau đó
sử dụng aenf(1) hoặc đại diện(1) trong một thay đổi thứ hai hoặc bạn có thể kết hợp cả hai bước trong cùng một
thay đổi. Hãy nhớ sử dụng không khí -bắt đầu tùy chọn hoặc bạn sẽ nhận được một cái mới đặc biệt nhất
mẫu tệp.

Thông báo
Sản phẩm xóa_file_command 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.

TRẮNG

Aegis cung cấp cho bạn cái thường được gọi là “đường dẫn xem” chỉ ra sự phát triển
công cụ (trình biên dịch, xây dựng hệ thống, vv) trước tiên hãy xem trong thư mục phát triển, sau đó trong
đường cơ sở nhánh, v.v. cho đến đường cơ sở chính.

Vấn đề với đường dẫn chế độ xem là để xóa tệp, bạn cần một số loại
"trắng" để nói "ngừng tìm kiếm, nó đã bị xóa."

Khi bạn sử dụng không khí(1) hoặc aemv(1) lệnh, điều này có nghĩa là "thêm thông tin vào thay đổi này
sẽ xóa tệp khỏi đường cơ sở khi thay đổi này được tích hợp ". I E trong khi
sự thay đổi nằm trong được phát triển trạng thái, tệp chỉ bị "loại bỏ" trong quá trình phát triển
thư mục - nó vẫn hiện diện trong đường cơ sở và sẽ có cho đến khi có sự thay đổi
tích hợp thành công.

Khi bạn sử dụng không khí(1) hoặc aemv(1) các lệnh, Aegis sẽ tạo một tệp 1K để hoạt động như
tẩy trắng. Nội dung của nó khá xấu nên nếu bạn biên dịch hoặc bao gồm "đã loại bỏ"
tập tin vô tình, bạn nhận được một lỗi nghiêm trọng. Điều này sẽ nhắc bạn xóa
người giới thiệu.

Khi thay đổi trong tích hợp, tệp bị xóa sẽ không được sao chép / liên kết từ đường cơ sở tới
thư mục tích hợp và là không được sao chép từ thư mục phát triển. Tại đây
thời gian nó biến mất về mặt vật lý (không mất trắng). Người ta cho rằng do lỗi
làm cho trắng tất cả các tham chiếu cũ đã được tìm thấy và sửa trong khi thay đổi trong
được phát triển nhà nước.

Tập tin Biểu hiện
Khi tạo danh sách các tệp được biên dịch hoặc liên kết, điều quan trọng là tệp
tệp kê khai được tạo từ thông tin do Aegis biết, chứ không phải từ hệ thống tệp.
Đây là một số lý do:

(a) Aegis biết chính xác tệp (nguồn) đang ở đâu, trong khi mọi thứ khác là
suy ra kiến ​​thức của Aegis; và

(b) khó tìm trong hệ thống tệp khi đường dẫn xem dài hơn 2 thư mục
(và phương pháp phân nhánh của Aegis có thể làm cho nó dài ra tùy ý); và

(c) Các tệp trắng và bất kỳ thứ gì khác còn lại "nằm xung quanh", sẽ gây nhầm lẫn cho bất kỳ phương pháp nào
mà thẩm vấn hệ thống tệp.

Cách dễ nhất để sử dụng kiến ​​thức tệp của Aegis là với một cái gì đó như ôi(1) tập lệnh
xử lý danh sách tệp Aegis. Ví dụ: bạn có thể làm điều này với làm cho(1) như sau:
# tạo tệp kê khai
tệp kê khai.make.inc: tệp kê khai.make.awk
(aegis -l cf -ter; aegis -l pf -ter) | \
awk -f manifest.make.awk> manifest.make.inc
# bây giờ bao gồm tệp kê khai
bao gồm manifest.make.inc
Lưu ý: điều này sẽ không hiệu quả nếu bạn làm một lần cho mỗi thư mục, nhưng không có gì
ngăn bạn viết nhiều bài tập vào bảng kê khai.make.inc tệp, tất cả trong một
vượt qua.

Có thể làm điều tương tự với trình tạo báo cáo của Aegis (xem aer(1) để biết thêm
thông tin), nhưng điều này liên quan nhiều hơn ôi(1) tập lệnh. Tuy nhiên, với
thông tin "thẳng từ miệng ngựa" như nó vốn có, nó cũng có thể thông minh hơn nhiều.

Tệp kê khai tệp này sẽ trở nên lỗi thời nếu không có khóa liên kết với tệp của Aegis
các lệnh hoạt động. Bằng cách sử dụng dự án-file_command và thay đổi_file_command Lĩnh vực
dự án cấu hình tập tin (xem aepconf(5) để biết thêm thông tin), bạn có thể xóa tệp này
vào những thời điểm chiến lược.
/ * chạy khi tệp kê khai tệp thay đổi được thay đổi * /
change_file_command = "rm -f manifest.make.inc";
/ * chạy khi tệp kê khai tệp dự án bị thay đổi * /
project_file_command = "rm -f manifest.make.inc";
Do đó, tệp kê khai tệp mới sẽ được tạo lại trong lần tiếp theo A và B(1) lệnh.

Các lựa chọn và Sở thích (Preferences)
Có một -Không-WhiteOut tùy chọn này có thể được sử dụng để chặn các tệp trắng khi bạn sử dụng
các không khí(1) aemv(1) lệnh. Có một tương ứng -TrắngRa tùy chọn, đó là
thường là mặc định.

Có một whiteout_preference trong tệp tùy chọn người dùng (xem aeuconf(5) cho
thêm thông tin) nếu bạn muốn đặt tùy chọn này lâu dài hơn.

Whiteout Tập tin Templates
Sản phẩm whiteout_template lĩnh vực của dự án cấu hình tệp có thể được sử dụng để tạo ra ngôn ngữ-
các tập tin lỗi cụ thể. Nếu không có mục nhập mẫu trắng nào phù hợp, một tệp 1KB rất xấu sẽ
được tạo ra - nó sẽ gây ra lỗi trình biên dịch đối với bất kỳ ngôn ngữ nào.

Nếu bạn muốn thông báo lỗi dễ đọc hơn, các mục nhập như
whiteout_template =
[
{
mẫu = ["*. [ch]"];
body = "#error Tệp này đã bị xóa.";
}
];
có thể rất hiệu quả (ví dụ này giả định gcc(1) đang được sử dụng).

Nếu điều đó là cần thiết Không tệp whiteout được tạo ra, chẳng hạn như đối với tệp nguồn C, bạn có thể
sử dụng một mẫu whiteout chẳng hạn như
whiteout_template =
[
{pattern = ["* .c"]; }
];
bởi vì vắng mặt thân hình trường phụ có nghĩa là không tạo tệp trắng nào cả.

Bạn có thể có nhiều mục nhập mẫu trắng, nhưng lưu ý rằng thứ tự của
mục nhập là quan trọng. Mục nhập đầu tiên phù hợp sẽ được sử dụng.

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.

-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.

-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.

-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.

-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.

-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.

-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.

-TrắngRa
Tùy chọn này có thể được sử dụng để yêu cầu các tệp đã xóa được thay thế bằng "dấu trắng"
tệp trong thư mục phát triển. Ý tưởng là việc biên dịch một tệp như vậy sẽ
dẫn đến một lỗi nghiêm trọng, để có thể tìm thấy tất cả các tham chiếu. Đây là
thường là mặc định.

-No_WhiteOut
Tùy chọn này có thể được sử dụng để yêu cầu không có tệp "trắng" nào được đặt trong
thư mục phát triển.

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 aerm 'aegis -rm \! * -v'
sh $ aerm () {aegis -rm "$ @" -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 không tồn tại trong đường cơ sở.
Đó là một lỗi nếu tệp đã là một phần của thay đổi.

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.

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