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

CHƯƠNG TRÌNH:

TÊN

cvs2cl - chuyển đổi thông báo nhật ký cvs thành thay đổi

SYNOPSIS

cvs2cl [lựa chọn] [TỆP1 [TỆP2 ...]]

MÔ TẢ

cvs2cl tạo ra một ChangeLog kiểu GNU cho các nguồn do CVS kiểm soát bằng cách chạy "cvs log" và
phân tích cú pháp đầu ra. Các thông báo nhật ký trùng lặp được hợp nhất theo đúng cách.

Đầu ra mặc định của cvs2cl được thiết kế nhỏ gọn, rõ ràng về hình thức, nhưng vẫn
dễ dàng cho con người để đọc. Nó phải được giải thích phần lớn; một từ viết tắt
có thể không rõ ràng là "utags". Đó là viết tắt của "thẻ phổ quát" - thẻ phổ quát là
một trong tất cả các tệp trong một mục thay đổi nhất định.

Nếu bạn cần đầu ra dễ dàng cho một chương trình phân tích cú pháp, hãy sử dụng --xml Lựa chọn. Lưu ý rằng
với đầu ra XML, tất cả thông tin có sẵn đều được bao gồm trong mỗi mục nhập thay đổi,
cho dù bạn có yêu cầu hay không, trên lý thuyết rằng trình phân tích cú pháp của bạn có thể bỏ qua bất cứ điều gì
không tìm kiếm.

Nếu tên tệp được cung cấp dưới dạng đối số, cvs2cl chỉ hiển thị thông tin nhật ký cho các tệp được đặt tên.

LỰA CHỌN

-h, -Cứu giúp, --Cứu giúp, -?
Hiển thị một trợ giúp ngắn và thoát.

--phiên bản
Hiển thị phiên bản và thoát.

-r, - sự xem xét
Hiển thị số sửa đổi trong đầu ra.

-b, - băng ghế
Hiển thị tên chi nhánh trong các bản sửa đổi khi có thể.

-t, --tags
Hiển thị các thẻ (tên tượng trưng) trong đầu ra.

-T, --ngày gắn thẻ
Hiển thị các thẻ ở đầu ra trong lần xuất hiện đầu tiên của chúng.

- chết đi được
Hiển thị các tệp đã chết.

--stdin
Đọc từ stdin, không chạy nhật ký cvs.

--thiết bị xuất chuẩn
Xuất ra stdout chứ không phải ChangeLog.

-d, - phân phối
Đặt ChangeLogs trong các thứ tự con.

-f FILE, --tập tin FILE
Viết thư cho FILE thay vì ChangeLog.

--fsf
Sử dụng điều này nếu dữ liệu nhật ký ở kiểu FSF ChangeLog.

--FSF
Cố gắng đầu ra tương thích với tiêu chuẩn FSF nghiêm ngặt (không tương thích với --tích lũy).

-W GIÂY, --cửa sổ GIÂY
Khoảng thời gian trong đó các mục nhật ký thống nhất.

-U UFILE, - sơ đồ UFILE
Mở rộng tên người dùng thành địa chỉ email từ UFILE.

--passwd MẬT KHẨU
Sử dụng tệp mật khẩu hệ thống để mở rộng tên người dùng. Nếu không có miền thư nào được cung cấp (qua
--miền), nó cố gắng đọc một từ / etc / mailname, đầu ra của hostname -d,
tên miền dns, hoặc là tên miền. cvs2cl thoát với lỗi nếu không có tùy chọn nào trong số đó
thành công. Sử dụng miền '' để ngăn việc thêm miền thư.

--miền DOMAIN
Miền để tạo địa chỉ email từ.

--gecos
Nhận thông tin người dùng từ dữ liệu GECOS.

-R ĐĂNG KÝ, --regexp ĐĂNG KÝ
Chỉ bao gồm các mục nhập phù hợp ĐĂNG KÝ. Tùy chọn này có thể được sử dụng nhiều lần.

-I ĐĂNG KÝ, --phớt lờ ĐĂNG KÝ
Bỏ qua các tệp có tên trùng khớp ĐĂNG KÝ. Tùy chọn này có thể được sử dụng nhiều lần. Các
regexp là một biểu thức chính quy perl. Nó được kết hợp như là; bạn có thể muốn tiền tố bằng
a ^ hoặc hậu tố với $ để neo đối sánh.

-C, --trường hợp không nhạy cảm
Mọi đối sánh regexp đều được thực hiện phân biệt chữ hoa chữ thường.

-F CHI NHÁNH, --theo dõi CHI NHÁNH
Chỉ hiển thị các bản sửa đổi trên hoặc tổ tiên cho CHI NHÁNH.

--chỉ theo dõi CHI NHÁNH
Giống như --follow, nhưng các nhánh con không được theo sau.

--không có tổ tiên
Khi đang sử dụng -F, chỉ theo dõi các thay đổi kể từ khi CHI NHÁNH bắt đầu

--không-ẩn-nhánh-bổ sung
Theo mặc định, các mục nhập được tạo bởi cvs cho một tệp được thêm vào một nhánh (mục nhập 1.1 đã chết)
không được hiển thị. Cờ này đảo ngược hành động đó.

-S, --tiêu đề riêng
Dòng trống giữa mỗi tiêu đề và thông báo nhật ký.

- nhóm trong ngày
Nhóm các mục nhập ChangeLog vào cùng một ngày với nhau, thay vì có một mục nhập riêng biệt
cho mỗi cam kết vào ngày đó.

--tóm lược
Thêm thông tin tóm tắt thay đổi CVS.

- không quấn
Không tự động đóng gói thông báo nhật ký (khuyến nghị -S cũng thế).

- không thụt lề
Không thụt lề thông báo nhật ký

--gmt, --utc
Hiển thị thời gian theo GMT / UTC thay vì giờ địa phương.

--tích lũy
Thêm vào ChangeLog hiện có (không tương thích với --xml và --FSF).

-w, --ngày trong tuần
Hiển thị ngày trong tuần.

- không có thời gian
Không hiển thị thời gian trong đầu ra.

--đồng hồ
Nhật ký xuất theo thứ tự thời gian (mặc định là thứ tự thời gian đảo ngược).

--tiêu đề FILE
Nhận tiêu đề ChangeLog từ FILE ("-"nghĩa là stdin).

--xml
Đầu ra XML thay vì định dạng ChangeLog (không tương thích với --tích lũy).

--xml-mã hóa THƯỞNG THỨC
Chèn mệnh đề mã hóa trong tiêu đề XML.

--xml-bản định kiểu FILE
Chèn hướng dẫn xử lý biểu định kiểu xml với FILE định dạng đường dẫn tệp biểu định kiểu
trong tiêu đề XML.

--noxmlns
Không bao gồm thuộc tính xmlns = trong phần tử gốc.

--hide-tên tập tin
Không hiển thị tên tệp (bị bỏ qua đối với đầu ra XML).

--no-common-dir
Không rút ngắn tên thư mục từ tên tệp.

--rcs CVSROOT
Xử lý tên tệp từ RCS thô, chẳng hạn như những tên được tạo bởi đầu ra "cvs rlog",
tước tiền tố CVSROOT.

-P, --cắt tỉa
Không hiển thị thông báo nhật ký trống.

--đường dây sửa đổi
Xuất ra số dòng được thêm vào và số dòng bị xóa cho mỗi lần đăng ký (nếu
áp dụng). Hiện tại, điều này chỉ ảnh hưởng đến chế độ xuất XML.

--ignore-thẻ TAG
Bỏ qua các thay đổi riêng lẻ được liên kết với một thẻ nhất định. Có thể được lặp lại, nếu
vì vậy, các thay đổi được liên kết với bất kỳ thẻ nào trong số các thẻ đã cho sẽ bị bỏ qua.

--show-thẻ TAG
Chỉ ghi nhật ký các thay đổi riêng lẻ được liên kết với một thẻ nhất định. Có thể được lặp lại, nếu
vì vậy, các thay đổi được liên kết với bất kỳ thẻ nào trong số các thẻ đã cho sẽ được ghi lại.

--delta TỪ_TAG:GẮN THẺ
Cố gắng dấu gạch ngang giữa hai thẻ (kể từ khi TỪ_TAG lên đến và bao gồm GẮN THẺ). Các
thuật toán là một thuật toán đơn giản dựa trên ngày tháng (đây là một vấn đề khó) vì vậy kết quả là
không hoàn hảo.

-g TÙY CHỌN, --global-opts TÙY CHỌN
Qua TÙY CHỌN đến các cv như trong "cvs TÙY CHỌN nhật ký ... ”.

-l TÙY CHỌN, --log-opt TÙY CHỌN
Qua TÙY CHỌN để cvs đăng nhập như trong "cvs ... log TÙY CHỌN".

Lưu ý về các tùy chọn và đối số:

· Các -I và -F các tùy chọn có thể xuất hiện nhiều lần.

· Để theo dõi các bản sửa đổi thân cây, hãy sử dụng "-F thân cây"("-F THÂN CÂY"cũng hoạt động). Điều này không sao
Bởi vì không bao giờ, sẽ không bao giờ đủ điên rồ để đặt tên cho một nhánh là "thân cây", phải không? Đúng.

· Cho -U tùy chọn, UFILE nên được định dạng như CVSROOT / người dùng. Đó là, mỗi
dòng UFILE trông như thế này:

ngẫu nhiên:[email được bảo vệ]

hoặc thậm chí có thể như thế này

jrandom: 'Jesse Q. Ngẫu nhiên[email được bảo vệ]>'

Đừng quên trích dẫn phần sau dấu hai chấm nếu cần thiết.

· Nhiều người muốn lọc theo ngày. Để làm như vậy, hãy gọi cvs2cl như sau:

cvs2cl -l "-d'DATESPEC '"

trong đó DATESPEC là bất kỳ thông số ngày tháng nào hợp lệ cho "cvs log -d". (Lưu ý rằng CVS
1.10.7 trở xuống yêu cầu không có khoảng cách giữa -d và đối số của nó).

· Ngày / giờ được diễn giải theo múi giờ địa phương.

· Nhớ trích dẫn đối số thành `-l'để shell của bạn không diễn giải các khoảng trắng là
dấu phân cách đối số.

· Xem phần 'Các tùy chọn chung' của sổ tay cvs ('thông tin cvs' trên các hệ thống giống UNIX)
để biết thêm thông tin chi tiết.

· Lưu ý rằng các quy tắc trích dẫn trong windows shell là khác nhau.

· Để chạy trong môi trường tự động như CGI hoặc PHP, có thể cần suidperl để
để thực thi với tư cách là người dùng phù hợp để bật / cvsroot đọc các tệp khóa được viết cho
lệnh 'cvs log'. Đây có thể chỉ là một trường hợp thay đổi / usr / bin / perl
lệnh tới / usr / bin / suidperl và khai báo biến PATH một cách rõ ràng.

VÍ DỤ

Một số ví dụ (làm việc trên UNIX shell):

# nhật ký sau ngày 6 tháng 2003 năm XNUMX (bao gồm cả)
cvs2cl -l "-d '> 2003-03-06'"
# nhật ký sau 4:34 chiều ngày 6 tháng 2003 năm XNUMX (bao gồm cả)
cvs2cl -l "-d '> 2003-03-06 16:34'"
# nhật ký từ 4:46 chiều ngày 6 tháng 2003 năm XNUMX (độc quyền) đến
# 4:34 CH ngày 6 tháng 2003 năm XNUMX (bao gồm cả)
cvs2cl -l "-d'2003-03-06 16:46>2003-03-06 16:34'"

Một số ví dụ (trên shell không phải UNIX):

# Được báo cáo là hoạt động trên windows xp / 2000
cvs2cl -l "-d" "> 2003-10-18; hôm nay <" ""

TÁC GIẢ

Karl Fogel
Melissa O'Neill
Martyn J. Pearce

Đóng góp từ

Mike Ayers
Tim Bradshaw
Richard Broberg
Nathan Bryant
Oswald Buddenhagen
Neil Conway
Arthur de Jong
Mark W. Eichin
Dave Elcock
Reid Ellis
Simon Josefsson
Robin Hugh Johnson
Terry Kane
Pete Kempf
Nụ hôn của Akos
Claus Klein
Eddie Kohler
Richard Lager
Kevin Lilly
Karl-Heinz Marbaise
Mitsuaki Masuhara
Henrik Nordstrom
Joe Orton
Peter Palfrader
Thomas Parmelan
Jordan Russel
Jacek Sliwerski
Johannes Stezenbach
Joseph Walton
Ernie Zapata

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