nhức đầu - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

nhức đầu - Một chương trình để quản lý giấy phép của tệp nguồn của bạn.

SYNOPSIS

đau đầu [-NS hồ sơ] [-NS hồ sơ] [-r] [-trợ giúp | --Cứu giúp] hồ sơhữu ích. Cảm ơn !

MÔ TẢ

Trang hướng dẫn sử dụng này tài liệu ngắn gọn về đau đầu chỉ huy.

Trang hướng dẫn sử dụng này được viết cho bản phân phối Debian GNU / Linux vì bản gốc
chương trình không có trang hướng dẫn sử dụng.

Cách sử dụng phổ biến là đặt ở đầu các tệp mã nguồn một tiêu đề ngắn,
ví dụ, một số thông tin bản quyền. đau đầu là một công cụ đơn giản và nhẹ để
quản lý dễ dàng các tiêu đề này. Trong số các chức năng của nó, người ta có thể đề cập đến:

· Tiêu đề thường phải được tạo dưới dạng nhận xét trong tệp mã nguồn. đau đầu Chương trình khuyến mại
với các loại tệp khác nhau và tạo tiêu đề cho mỗi loại tệp trong một
định dạng.

· Tiêu đề tự động phát hiện các tiêu đề hiện có và loại bỏ chúng. Vì vậy, bạn có thể sử dụng nó
để cập nhật tiêu đề trong một tập hợp tệp.

COMMAND ĐƯỜNG DÂY LỰA CHỌN

hồ sơ
Tên của một tệp cần xử lý

-h tệp
Tạo tiêu đề với văn bản đến từ tệp

-c tệp
Đọc tệp cấu hình đã cho

-cứu cứu
Hiển thị danh sách tùy chọn của đau đầu

SỬ DỤNG

Hãy để chúng tôi minh họa việc sử dụng công cụ này bằng một ví dụ nhỏ. Giả sử bạn có một
dự án trộn mã C và Caml bao gồm ba tệp 'foo.c', 'bar.ml' và 'bar.mli' ',
và bạn muốn trang bị cho họ một số tiêu đề. Trước hết, hãy viết một tệp tiêu đề, tức là
tệp văn bản thuần túy bao gồm các tiêu đề thông tin phải đề cập đến. Một ví dụ về một tệp như vậy
được cho trong hình 1. Trong phần sau, chúng tôi giả sử tệp này được đặt tên là 'myheader' và nằm trong
cùng một thư mục với các tệp nguồn.

Sau đó, để tạo tiêu đề, chỉ cần chạy lệnh: đau đầu -h tiêu đề của tôi foo.c
thanh.ml thanh.mli

Mỗi tệp được trang bị một tiêu đề bao gồm văn bản được cung cấp trong tệp tiêu đề
'myheader', được bao quanh bởi một số ký tự phụ tùy thuộc vào định dạng của nó làm cho nó trở thành
nhận xét (ví dụ: '(*' và '*)' trong tệp '.ml'). Nếu bạn cập nhật tệp tiêu đề 'myheader', bạn
chỉ cần chạy lại lệnh trên để cập nhật tiêu đề trong tệp mã nguồn.

Tương tự, đang chạy: đau đầu -r foo.c thanh.ml thanh.mli loại bỏ bất kỳ hiện có trong tệp
'foo.c', 'bar.ml' và 'bar.mli'. Các tệp không có tiêu đề được giữ nguyên.

CẤU HÌNH FILE

Loại tệp và định dạng của tiêu đề có thể được chỉ định bởi tệp cấu hình. Theo mặc định,
tệp cấu hình nội trang mặc định được đưa ra trong hình 2 được sử dụng. Bạn cũng có thể sử dụng
tập tin cấu hình nhờ vào -c Lựa chọn : đau đầu -c myconfig -h tiêu đề của tôi foo.c thanh.ml
thanh.mli

Để viết cấu hình của riêng bạn, bạn có thể làm theo ví dụ cho trong hình 2. A
tập tin cấu hình bao gồm một danh sách các mục nhập được phân tách bằng ký tự '|'. Mỗi
chúng được làm bằng hai phần được phân tách bằng dấu '->'.

Cái đầu tiên là một biểu thức chính quy. (Biểu thức chính quy được đặt trong dấu ngoặc kép
dấu ngoặc kép và có cùng cú pháp như trong Gnu Emacs.) đau đầu xác định loại tệp
theo tên cơ sở của tệp; do đó, mỗi tệp được xử lý bằng cách sử dụng dòng đầu tiên tên của nó
diêm.

Cái thứ hai mô tả định dạng của tiêu đề cho các tệp loại này. Nó bao gồm
tên của một mô hình (ví dụ: 'khung'), có thể theo sau là danh sách các đối số. Lập luận là
được đặt tên: 'open: "(*"' có nghĩa là giá trị của đối số 'open' là '(*'. đau đầu
hiện hỗ trợ ba mô hình và một từ khóa đặc biệt:

khung
Với mô hình này, tiêu đề được tạo trong một khung. Mô hình này yêu cầu ba
các đối số: 'open' và 'close' (trình tự mở và đóng cho các nhận xét) và
'line' (ký tự được sử dụng để tạo các đường ngang của khung). Hai tùy chọn
các đối số có thể được sử dụng 'margin' (một chuỗi được in giữa bên trái và bên phải của
khung và viền, theo mặc định là hai khoảng trắng) và 'width' (chiều rộng của bên trong
của khung, mặc định là 68).

dòng
Tiêu đề là bộ sắp chữ giữa hai dòng. Ba đối số phải được cung cấp: 'mở' và
'close' (trình tự mở và đóng cho các nhận xét), 'line' (ký tự được sử dụng
để tạo các đường ngang). Ba đối số tùy chọn được phép: 'begin' (một chuỗi
bộ sắp chữ ở đầu mỗi dòng, theo mặc định là hai khoảng trắng), 'cuối cùng' (một chuỗi
bộ sắp chữ ở đầu dòng cuối cùng) và 'width' (chiều rộng của các dòng,
mặc định là 70).

Không
Mô hình này không tạo ra tiêu đề và không có đối số.

bỏ qua
Bỏ qua dòng tương ứng với một trong các tham số "khớp" regexp. Đối với loại
, mọi mẫu phần đầu tiên phù hợp với tên cơ sở của tệp đều được tính đến.

Sử dụng dịch vụ onworks.net nhức đầu