cpan2debp - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

dh-make-perl - Tạo gói nguồn debian từ các mô-đun Perl

SYNOPSIS

dh-make-Perl [làm] {NGUỒN_DIR | --cpan MODULE|QUẬN} tùy chọn...
làm mới dh-make-perl {--chỉ một hữu ích. Cảm ơn !} [danh mục]
dh-make-perl xác định vị trí Foo :: Bar ...
dh-make-Perl refresh-cache
dh-make-perl kết xuất-config
dh-make-perl trợ giúp
cpan2deb MODULE|QUẬN tùy chọn...
cpan2dsc MODULE|QUẬN tùy chọn...

MÔ TẢ

dh-make-Perl sẽ tạo các tệp cần thiết để xây dựng gói nguồn debian từ Perl
phân phối mô-đun hoặc CPAN. Điều này hoạt động đối với hầu hết các gói đơn giản và cũng hữu ích cho
bắt đầu với việc đóng gói các mô-đun Perl.

Bạn có thể chỉ định tên mô-đun hoặc phân phối bằng công tắc --cpan và dh-make-Perl sẽ
tải xuống nó cho bạn từ máy nhân bản CPAN hoặc bạn có thể chỉ định thư mục với
nguồn giải nén. Nếu cả --cpan và một thư mục đều không được cung cấp làm đối số, dh-make-Perl
cố gắng tạo một gói Perl từ dữ liệu trong thư mục hiện tại.

Bạn có thể xây dựng và cài đặt gói nhị phân debian bằng cách sử dụng "--build" và "--install"
chuyển dòng lệnh.

If dh-make-Perl được gọi là

cpan2deb Foo :: Bar

nó cư xử như thế nào

dh-make-perl làm --build --cpan Foo :: Bar

If dh-make-Perl được gọi là

cpan2dsc Foo :: Bar

nó cư xử như thế nào

dh-make-perl làm --build-source --cpan Foo :: Bar

Sử dụng chương trình này không có lý do gì để không đọc tài liệu dành cho nhà phát triển debian,
bao gồm chính sách Debian, chính sách Debian Perl, hướng dẫn đóng gói, v.v.

HÀNG
làm cho
Lệnh mặc định nếu không có lệnh nào được đưa ra. Tạo ra debianisation từ đầu. Thất bại
với một lỗi nếu debian / thư mục đã tồn tại.

làm mới [thư mục]
Để làm mới một gói. "thư mục" mặc định là thư mục làm việc hiện tại.
Tái tạo debian / bản quyền, debian / quy tắc, debian / compat bằng cách sử dụng các mẫu hiện tại.
Trước khi thực hiện bất kỳ thay đổi nào đối với các tệp này, một bản sao lưu được tạo bằng .bak
hậu tố.

Điều này hữu ích khi debian / quy tắc được tạo bằng cách sử dụng các mẫu cũ hơn và không chứa
nhiều tùy chỉnh. Như mọi khi, bạn được khuyến khích xác minh nếu debian / quy tắc
trông khỏe mạnh.

"refresh" cũng cố gắng cập nhật danh sách phụ thuộc trong debian / control từ META.yml. Nó
móc may chăn(1) thành debian / quy tắc và tạo ra debian / README.source

Khi cập nhật debian / bản quyền dh-make-perl cố gắng thông minh trong việc ghi nhớ email
các địa chỉ. Nó lấy danh sách các chủ sở hữu bản quyền và email của họ cho debian / * từ
dòng đăng nhập debian / changelog. Tuy nhiên, để cho phép địa chỉ email
thay đổi, nó tìm kiếm các dòng thay đổi của biểu mẫu

* Thay đổi email: Debbie Devlin -> [email được bảo vệ]

Vì vậy, bây giờ "Debbie Devlin[email được bảo vệ]> "sẽ được sử dụng trong bản quyền thay vì
"Debbie Devlin[email được bảo vệ]> ".

--chỉ một | -o kiểm soát | bản quyền | tài liệu | ví dụ | quy tắc
Tùy chọn này cho phép một người chỉ cập nhật một hoặc nhiều tệp trong thư mục debian /
khi nào dh-make-Perl được chạy ở chế độ "làm mới". Các tên tệp được phân tách bằng dấu phẩy. Các
tùy chọn có thể được đưa ra nhiều lần, tích lũy các đối số.

xác định vị trí MODULE hữu ích. Cảm ơn !
Cố gắng xác định vị trí gói mã hóa Perl đã cho MODULEs.

Ví dụ:

dh-make-perl định vị IPC :: Run3 XML :: Tidy

làm mới bộ đệm
dh-make-Perl phân tích cú pháp các tệp Nội dung, được tìm nạp bởi tệp apt(1) và lưu trữ kết quả
trong bộ nhớ cache. Bộ nhớ đệm được làm mới tự động nếu nó cũ hơn bất kỳ Nội dung nào
tập tin. Tuy nhiên, nếu bạn chạy tệp apt(1) trong công việc hàng đêm của bạn, lần đầu tiên bạn chạy
dh-make-Perl trong ngày, bạn sẽ đợi bộ nhớ cache được tạo lại. Với
tùy chọn này, bạn có thể di chuyển việc tạo lại bộ đệm ẩn sang công việc cron, ngay sau "apt-file
cập nhật".

Không có gì nếu bộ đệm ẩn mới hơn tệp Nội dung.

kết xuất cấu hình
Làm cho cấu hình hiện tại, bao gồm bất kỳ cài đặt mặc định nào được in vào
đầu ra tiêu chuẩn.

Hữu ích cho việc điền tệp dh-make-perl.conf.

giúp đỡ
Hiển thị thông tin sử dụng ngắn.

LỰA CHỌN
--apt-content-dir dir
Vị trí của thư mục Contents apt-file. Mặc định là / var / cache / apt / apt-file

--vòm bất kì | tất cả các
Điều này chuyển đổi giữa các gói phụ thuộc vòm và các gói độc lập vòm. Nếu như --vòm không phải
đã sử dụng, dh-make-Perl sử dụng các thuật toán hoạt động tương đối tốt để quyết định điều này một mình.

- sao lưu | - không sao lưu
Ở chế độ "làm mới", hãy tạo bản sao lưu của debian / bản quyền và debian / quy tắc trước
ghi đè chúng. Bật theo mặc định.

--basepkgs
Đưa ra danh sách các gói được phân tách bằng dấu phẩy một cách rõ ràng để xem xét các gói "cơ sở" (tức là
gói luôn có sẵn trong hệ thống Debian). Tùy chọn này mặc định là
"perl, perl-base" - nó được sử dụng để kiểm tra sự phụ thuộc của mô-đun. Nếu một mô-đun cần thiết là
trong "basepkgs", nó sẽ không được đề cập trong trường "depend:" của "debian / control".

Nếu tùy chọn này được chỉ định, các gói mặc định được đề cập ở trên sẽ không được bao gồm
(nhưng sẽ được đề cập dưới dạng phụ thuộc rõ ràng trong gói kết quả). Bạn có thể, trong số
khóa học, đề cập đến các mô-đun của riêng bạn và chỉ định rõ ràng các giá trị mặc định.

Lưu ý rằng tùy chọn này nên được sử dụng ít và cẩn thận, vì nó có thể dẫn đến
các gói không thể xây dựng lại do các phụ thuộc chưa được thực hiện.

- phụ thuộc PHỤ LỤC XÂY DỰNG
Chỉ định thủ công chuỗi được sử dụng cho các phụ thuộc xây dựng của mô-đun (nghĩa là
các gói và phiên bản của chúng phải được cài đặt để thành công
xây dựng gói). Hãy nhớ rằng các gói được tạo bởi dh-make-Perl yêu cầu
debhelper được chỉ định làm phụ thuộc vào bản dựng. Lưu ý tương tự như đối với - áp dụng tùy chọn
tại đây - chỉ sử dụng khi cần thiết.

--bdepsi XÂY DỰNG-PHỤ THUỘC-ĐỘC LẬP
Chỉ định thủ công chuỗi được sử dụng cho các phụ thuộc xây dựng của mô-đun cho
công trình độc lập với kiến ​​trúc. Ghi chú tương tự như ghi chú cho --depends và --bdepends
các tùy chọn áp dụng ở đây.

Lưu ý rằng đối với --depends, --bdepends và --bdependsi, bạn cũng có thể chỉ định rằng
trường không được xuất hiện trong debian / rules (tất nhiên là nếu bạn thực sự có ý đó ;-)) bởi
cung cấp cho nó một chuỗi rỗng làm đối số.

--xây dựng
Xây dựng gói nhị phân (tức là tệp .deb) sau khi thiết lập thư mục gói.

NB: Điều này chỉ xây dựng một gói nhị phân (bằng cách gọi "fakeroot debian / rules binary") và
không ký gói. Nó có nghĩa là để cài đặt cục bộ nhanh một gói, không phải để
tạo một gói sẵn sàng để gửi vào kho lưu trữ Debian.

- nguồn xây dựng
Xây dựng gói nguồn (tức là các tệp .dsc và .debian.tar.gz) sau khi thiết lập
gói thư mục lên.

NB: Điều này chỉ xây dựng một gói nguồn (bằng cách gọi "dpkg-source -b") và không ký
gói. Nó có nghĩa là để cài đặt cục bộ nhanh chóng gói nguồn được ném
ví dụ như một công ty xây dựng, không phải để tạo một gói nguồn sẵn sàng để gửi cho
Kho lưu trữ Debian.

--có ITPBUG
Chỉ định thủ công số lỗi ITP mà gói này đóng. Nếu không được đưa ra, dh-làm-
perl sẽ cố gắng kết nối với bug.debian.org để lấy số lỗi thích hợp, bằng cách sử dụng
WWW :: Cơ giới hóa.

--core-ok
Cho phép xây dựng các mô-đun Perl cốt lõi. Theo mặc định, dh-make-Perl sẽ không cho phép xây dựng một
mô-đun được vận chuyển như một phần của thư viện Perl tiêu chuẩn; bằng cách xác định điều này
Tùy chọn, dh-make-Perl sẽ xây dựng chúng bằng mọi cách.

Lưu ý rằng, mặc dù không thể xảy ra, nhưng điều này có thể phá vỡ các mục không liên quan trong
hệ thống - nếu phiên bản mới hơn của mô-đun lõi phá vỡ API, tất cả các loại daemon
có thể khó chịu ;-)

--cpan MODULE|QUẬN
Hướng dẫn dh-make-Perl để tìm nạp và trích xuất mô-đun CPAN hoặc bản phân phối đã cho.
Hoạt động cả với "Foo :: Bar" và "Foo-Bar".

--cpan-gương MIRROR
Chỉ định một trang CPAN để sử dụng làm bản sao.

--data-dir MỤC
Sử dụng một thư mục dữ liệu khác, thay vì mặc định, "/ usr / share / dh-make-perl"

Thư mục dữ liệu là dh-make-Perl tìm kiếm các quy tắc mặc định của nó. * các mẫu. Nó là
tương tự như - nhà-dir, nhưng không thay đổi vị trí của bộ đệm ẩn Nội dung APT
tập tin. Nếu cả hai đều được đưa ra, - nhà-dir được ưu tiên.

- phụ thuộc PHỤ LỤC
Chỉ định thủ công chuỗi được sử dụng cho các phụ thuộc của mô-đun. Điều này nên được
được sử dụng khi xây dựng các mô-đun ở đó dh-make-Perl không thể đoán các phụ thuộc Perl (chẳng hạn
như các mô-đun được xây dựng bằng Mô-đun :: Cài đặt) hoặc khi mã Perl phụ thuộc vào không phải Perl
nhị phân hoặc thư viện. Thông thường, dh-make-Perl sẽ tìm ra các phụ thuộc bằng cách
chinh no. Nếu bạn cần phải vượt qua dh-make-Perl thông tin phụ thuộc, bạn phải sử dụng
định dạng gói debian. I E

dh-make-perl - phụ thuộc libtest-more-perl

--desc NGẮN MÔ TẢ
Sử dụng đối số đến --desc làm mô tả ngắn gọn cho gói.

--dh PHIÊN BẢN
Đặt mức độ tương thích trình gỡ lỗi mong muốn. Giá trị mặc định là 8 cho kiến ​​trúc-
các gói độc lập và 9 cho các gói phụ thuộc vào kiến ​​trúc (XS).

Kể từ phiên bản 0.77, dh-make-Perl chỉ hỗ trợ mức độ tương thích của trình gỡ lỗi > = 8.

Xem gỡ lỗi(1).

--quận PHÂN PHỐI
Giới hạn các bản phân phối có tệp "Nội dung" được phân tích cú pháp. Đối số là một
tên phân phối.

Mặc định: trống, nghĩa là không lọc.

Ví dụ:
dh-make-Perl --dist etch

--e-mail | -e E-MAIL
Chỉ định thủ công địa chỉ email Người bảo trì để sử dụng trong debian / control và trong
debian / changelog.

--loại trừ | -i [ĐĂNG KÝ]
Điều này cho phép bạn chỉ định PCRE để loại trừ một số tệp khỏi tìm kiếm tài liệu và
những thứ như thế. Nếu không có đối số nào được đưa ra (nhưng công tắc được chỉ định - không chỉ định
công tắc sẽ bao gồm mọi thứ), nó được đặt mặc định là các giá trị mặc định của dpkg-source.

--Tải về
Cài đặt gói mới được xây dựng. Chỉ định --install ngụ ý --build - Gói
sẽ không được cài đặt trừ khi nó được xây dựng (rõ ràng là ;-))

--xâm nhập
Khi xác định sự phụ thuộc của mô-đun, nếu Mô-đun :: Phụ thuộc không thành công, hãy thử lại với
Mô-đun :: Phụ thuộc :: Xâm nhập. M: D: Tôi tải tất cả các tệp .pm, chặn tải các tệp khác
mô-đun, chạy mã không đáng tin cậy thay cho bạn một cách hiệu quả. Sử dụng cẩn thận.

--mạng
Cho phép truy vấn danh sách WNPP Debian cho ITP và các lỗi tương tự. Được bật theo mặc định,
sử dụng "--no-network" để tắt.

--chú thích
Tùy chọn này để không chạy kiểm tra tự động mô-đun như một phần của bản dựng
tập lệnh đã bị xóa trong 0.54. Vui lòng điền vào DEB_BUILD_OPTIONS
biến môi trường nếu bạn muốn bỏ qua các kiểm tra khi xây dựng một gói.

- nhà-dir MỤC
Nơi Nội dung APT và các bộ nhớ đệm khác được lưu trữ.

Mặc định: ~ / .dh-make-perl

--tên gói hàng | -p TÊN GÓI HÀNG
Chỉ định tên gói theo cách thủ công, hữu ích khi mô-đun có dấu gạch ngang trong tên của nó.

--pkg-Perl
Hữu ích khi chuẩn bị một gói cho Nhóm Debian Perl
<http://pkg-perl.alioth.debian.org>.

Đặt các trường "Người bảo trì", "Người tải lên", "Vcs-Git" và "Vcs-Browser" trong debian / control
cho phù hợp. Ngoài ra, khi "--vcs git" được sử dụng (mặc định), hãy thiết lập điều khiển từ xa Git
chỉ đến đúng nơi trên git.debian.org.

--đệ quy
Chỉ có hiệu lực ở chế độ "make" với "--cpan" hoặc thư mục tranh luận. Khiến dh-make-perl
cố gắng tạo bao bì (và có thể xây dựng và cài đặt các gói nếu "--build" và
Các tùy chọn "--install" cũng được đưa ra) cho bất kỳ phần phụ thuộc nào bị thiếu gói.

Điều này hoạt động như thế này: khi gói 'chính' được xây dựng, bất kỳ gói nào bị thiếu sẽ
đưa vào một danh sách, và sau đó thủ tục debianisaion được chạy lần lượt trên từng người trong số họ,
một cách đệ quy.

--requiredep
Không thành công nếu gói Perl phụ thuộc không được tìm thấy (theo dõi phụ thuộc yêu cầu apt-
gói tệp được cài đặt và cập nhật)

- định dạng nguồn định dạng
Khi tạo hoặc làm mới bao bì, hãy sử dụng định dạng nguồn được chỉ định. Mặc định là
"3.0 (chăn bông)".

--nguồn-danh sách FILE
Hướng dẫn trình phân tích cú pháp tệp "Nội dung" sử dụng điều này hồ sơ khi xác định xem một tệp nhất định
có nên được phân tích cú pháp hay không. Nội dung tệp không khớp với bất kỳ dòng nào trong source.list không
đã phân tích cú pháp để giúp bạn tiết kiệm thời gian phân tích cú pháp các tệp cũ từ các máy nhân bản mà bạn không còn sử dụng nữa.

Mặc định: mặc định của apt.

--vcs VCS
In --pkg-Perl , sử dụng hệ thống kiểm soát phiên bản được chỉ định trong Vcs- *
lĩnh vực. Giá trị mặc định là "git".

If VCS là "git", "dh-make-perl" sẽ thiết lập kho lưu trữ Git với ba nhánh:

Thượng nguồn
Nhánh ban đầu chứa các nguồn ngược dòng

chủ
Chi nhánh nơi đóng gói được thực hiện, được tách ra "ngược dòng" và với nội dung của
thư mục "debian /" được thêm vào.

nguyên sinh-nhựa
Một chi nhánh để giữ nguyên sinh-nhựa(1) dữ liệu.

If --pkg-Perl cũng được cung cấp, một điều khiển từ xa "origin" được thêm vào để trỏ đến kho lưu trữ trên
git.debian.org.

--dài dòng | - không dài dòng
In thông tin bổ sung trong khi xử lý.

--verbose được bật theo mặc định ở chế độ "make", ngược lại thì tắt.

--phiên bản PHIÊN BẢN
Chỉ định phiên bản của gói kết quả.

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