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

CHƯƠNG TRÌNH:

TÊN

manlifter - tập lệnh chuyển đổi hàng loạt và khai thác thử nghiệm cho doclifter

SYNOPSIS

người lái xe [-NS tùy chọn] [-e] [-f danh sách] [-Chào ủy nhiệm] [-m] [-M] [-o vượt mặt]
[-P thư mục vá lỗi] [-P] [-q] [-v] [-s phần] [-NS loại trừ] tênhữu ích. Cảm ơn !

người lái xe [-NS]

MÔ TẢ

người lái xe là một kịch bản trình tự người học tài liệu(1) để chuyển đổi toàn bộ cây trang thủ công thành
XML-Docbook, tùy chọn cũng tạo HTML từ XML. Một công dụng khác là
công cụ kiểm tra tra tấn cho doclifter; nó ghi các lỗi vào đầu ra tiêu chuẩn và thu thập thời gian.

Được gọi mà không có bất kỳ đối số tệp nào, manlifter cố gắng chuyển đổi tất cả các trang nam đủ điều kiện
được cài đặt trên hệ thống, đặt các tệp xml kết quả dưới xmlman hiện tại
danh mục. Mỗi trang được dịch thành công foo.N được sao chép sang manN / foo.xml bên dưới
thư mục đầu ra, bất kể nó đến từ thư mục nguồn nào.

Một trang thủ công được coi là không đủ điều kiện để chuyển đổi hàng loạt nếu nó chứa văn bản cho biết
nó đã được tạo ra từ DocBook master của Doxygen.

Đối với mỗi tệp nguồn được kiểm tra, nếu tệp đích tồn tại và mới hơn
nguồn, chuyển đổi bị bỏ qua; do đó, số lần chạy tăng dần của người lái xe làm ít công việc nhất
cần thiết để giữ cho cây XML mục tiêu được cập nhật. Tương tự như vậy, các tệp HTML có nguồn gốc ở chế độ -h là
chỉ được thực hiện khi cần thiết.

Stub các trang chỉ là .vì thế chuyển hướng được dịch sang các liên kết tượng trưng tương ứng của XML
tệp (và, với -h, tệp HTML).

người lái xe cũng có thể được gọi với một đối số tệp duy nhất, được hiểu là phần gốc
tên của một trang hướng dẫn tiềm năng. người lái xe sau đó tìm kiếm tất cả các phần thủ công đã chọn cho
một trang phù hợp và cố gắng chuyển đổi nó. Trong trường hợp này, một bản sao của trang người đàn ông và
phiên bản đã chuyển đổi sẽ bị loại bỏ ngay lập tức bên ngoài thư mục đầu ra, với các tên
foobar.man và foobar.man.xml, tương ứng. Chế độ này thường chỉ quan tâm
đến người học tài liệu các nhà phát triển để gỡ lỗi chương trình đó.

Trong một trong các trường hợp trên, người lái xe sẽ giải nén tệp nếu nó có .gz, .bz2 hoặc
Hậu tố .Z trên tên.

Các tùy chọn như sau:

-d
Truyền đối số chuỗi cho mỗi lệnh gọi doclifter làm tùy chọn. Mỗi mã thông báo được phân tách bằng dấu cách
trong chuỗi trở thành một đối số riêng biệt trong cuộc gọi.

-e
Chạy ở chế độ lọc nhật ký (chủ yếu quan tâm đến người học tài liệu nhà phát triển). Trong chế độ này,
người lái xe đọc nhật ký kiểm tra từ đầu vào chuẩn và lọc nó theo cách phụ thuộc vào
các tùy chọn -f và -q. Nếu cả hai đều không được cung cấp, thông báo từ các lần chạy thành công là
loại bỏ và chỉ các lỗi được chuyển sang đầu ra tiêu chuẩn.

-f
Thông thường, chạy doclifter trên các tệp được đặt tên theo từng dòng trong tệp đối số. Trong
chế độ lọc lỗi thay vào đó, đối số được hiểu là một chế độ lọc thông thường
biểu hiện.

-h
Đồng thời tạo các bản dịch HTML vào thư mục đầu ra. Đánh dấu citerefentry của DocBook
được chuyển đổi thành siêu liên kết trong thư mục và danh sách nội dung được tạo để
chỉ mục.html.

-I
Chỉ định gốc của cây trang hướng dẫn sử dụng. Theo mặc định, đây là / usr / share / man.

-m
Thực hiện một bản vá để sửa trang cuối cùng được tải xuống. Nó được sao chép, một trình chỉnh sửa được gọi vào
bản sao (sử dụng biến môi trường $ EDITOR), và sau đó khác(1) được gọi là thả
bản vá trong thư mục bản vá trước. Không xảy ra lỗi nếu đã có bản vá như vậy
hiện tại.

-M
Nâng các tệp được chỉ định, sau đó thực hiện tương đương với tùy chọn -m.

-o
Đặt thư mục đầu ra mà các bản dịch XML-DocBook sẽ bị loại bỏ. Qua
mặc định đây là xmlman trong thư mục hiện tại ở chế độ hàng loạt hoặc hiện tại
thư mục khác.

-p
Giải thích đối số là tên của thư mục bản vá (tên mặc định là bản vá trước
dưới thư mục hiện tại). Mỗi tệp có tên foo.N.patch được hiểu là một bản vá để
được áp dụng cho trang hướng dẫn sử dụng foo (N) trước khi doclifter dịch nó.

-P
Bật cấu hình bằng cách sử dụng mô-đun Hotshot Python; điều này chỉ hữu ích để điều chỉnh
doclifter để nó chạy nhanh hơn. Dữ liệu thô được ghi vào manlifter.prof và
báo cáo được thêm vào nhật ký trên đầu ra tiêu chuẩn. Cảnh báo: các tệp dữ liệu thô có thể
trở nên khổng lồ và quá trình hậu xử lý để tạo báo cáo có thể mất nhiều thời gian
xử lý thực tế (hoặc lâu hơn!).

-q
Thông thường, chuyển tùy chọn -q (yên tĩnh) cho mỗi lệnh gọi doclifter. Trong chế độ lọc lỗi,
trả về danh sách các tệp mà bản dịch không thành công.

-v
Chuyển tùy chọn -v (verbose) cho mỗi lệnh gọi doclifter. Tùy chọn này có thể được lặp lại để
tăng mức độ chi tiết.

-s
Chỉ định một phần để quét. Sử dụng điều này với một đối số; nó không cần thiết khi
thực hiện chuyển đổi toàn bộ cây.

-S
Biên dịch thống kê lỗi từ một người lái xe logfile được trình bày trên đầu vào tiêu chuẩn. Cái này
tùy chọn sẽ được quan tâm chủ yếu để người học tài liệu nhà phát triển.

-X
Ở chế độ hàng loạt, loại trừ các trang được liệt kê trong tệp đối số. Có nghĩa là được sử dụng cho các trang
được biết đến là tốt và cần một thời gian dài để nâng lên, nhằm giảm bớt
thời gian cho một cuộc chạy thử nghiệm. (Hầu hết các trang được tải lên trong vòng chưa đầy nửa giây, nhưng một số trang có thể mất
15 phút hoặc lâu hơn.)

người lái xe phát ra một tệp log tới đầu ra tiêu chuẩn. Tệp bắt đầu bằng dòng dấu thời gian và
dòng trống và kết thúc bằng một dòng cho biết thời gian chạy và nhiều số liệu thống kê thú vị.
Giữa những khổ này là các khổ thơ, được phân tách bằng các dòng trống, mỗi khổ một cho mỗi tệp trên đó người học tài liệu
đã chạy.

Dòng đầu tiên của mỗi khổ thơ có dấu "!", Theo sau là tên đường dẫn của nguồn
máy nhắn tin thủ công, theo sau là "=" và trạng thái trả về của doclifter chạy trên tệp đó.
Theo sau đó là một khoảng trắng và người học tài liệuthời gian chạy tính bằng giây.

Dòng đầu tiên này có thể được theo sau bởi các thông báo thông tin và kết quả đầu ra lỗi của
doclifter chạy.

người lái xe phải tìm một bản sao của người học tài liệu trong thư mục hiện tại hoặc một trong các
thư mục lệnh trong của bạn PATH để chạy.

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