summaryrefslogtreecommitdiff
path: root/help2man.vi.1
blob: d86be5ec29b1e71be1c97476df8cf95a6a9ddc6b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.2.
.TH HELP2MAN "1" "Tháng 4 2022" "GNU help2man 1.49.2" "Các câu lệnh"
.SH TÊN
help2man \- tạo một trang hướng dẫn dạng man kiểu đơn giản
.SH "TÓM TẮT"
.B help2man
[\fI\,TÙY_CHỌN\/\fR]\fI\,… TÊN-LỆNH\/\fR
.SH "MÔ TẢ"
“help2man” tạo một trang hướng dẫn dựa trên kết xuất từ tùy chọn
“\-\-help” (trợ giúp) và “\-\-version” (phiên bản).
.TP
\fB\-n\fR, \fB\-\-name\fR=\fI\,CHUỖI\/\fR
mô tả cho đoạn văn TÊN (NAME)
.TP
\fB\-s\fR, \fB\-\-section\fR=\fI\,PHẦN\/\fR
số thứ tự phần cho trang hướng dẫn (1, 6, 8)
.TP
\fB\-m\fR, \fB\-\-manual\fR=\fI\,TÊN\/\fR
tên của trang hướng dẫn (User Commands, …)
.TP
\fB\-S\fR, \fB\-\-source\fR=\fI\,TEXT\/\fR
nguồn của chương trình (FSF, Debian, …)
.TP
\fB\-L\fR, \fB\-\-locale\fR=\fI\,CHUỖI\/\fR
chọn miền địa phương (mặc định "C";
đối với tiếng Việt thì là “vi_VN.UTF\-8”)
.TP
\fB\-i\fR, \fB\-\-include\fR=\fI\,TỆP\/\fR
bao gồm dữ liệu từ tập tin này
.TP
\fB\-I\fR, \fB\-\-opt\-include\fR=\fI\,TỆP\/\fR
bao gồm dữ liệu từ tập tin này nếu có
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,TỆP\/\fR
gửi kết xuất cho tập tin này
.TP
\fB\-p\fR, \fB\-\-info\-page\fR=\fI\,TÊN\/\fR
tên của trang hướng dẫn loại Texinfo
.TP
\fB\-N\fR, \fB\-\-no\-info\fR
thu hồi cái chỉ tới trang hướng dẫn Texinfo
.TP
\fB\-l\fR, \fB\-\-libtool\fR
loại trừ “lt\-” từ tên của chương trình
.TP
\fB\-\-help\fR
hiển thị trợ giúp này, sau đó thoát
.TP
\fB\-\-version\fR
hiển thị số thứ tự phiên bản, sau đó thoát
.PP
TÊN\-LỆNH có thể chấp nhận hai tùy chọn “\-\-help” và “\-\-version” và sản sinh kết xuất
qua đầu ra tiêu chuẩn (stdout) mặc dù cũng có thể ghi rõ thêm tùy chọn:
.TP
\fB\-h\fR, \fB\-\-help\-option\fR=\fI\,CHUỖI\/\fR
chuỗi là tùy chọn trợ giúp
.TP
\fB\-v\fR, \fB\-\-version\-option\fR=\fI\,CHUỖI\/\fR
chuỗi là tùy chọn phiên bản
.TP
\fB\-\-version\-string\fR=\fI\,CHUỖI\/\fR
chuỗi phiên bản
.TP
\fB\-\-no\-discard\-stderr\fR
bao gồm cả kết xuất từ đầu ra lỗi tiêu chuẩn
khi phân tích cú pháp của kết xuất tùy chọn
.PP
Thông báo lỗi nào cho <bug\-help2man@gnu.org>.
Thông báo lỗi dịch cho <translation\-team\-vi@lists.sourceforge.net>.
.PP
Bản quyền (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2009, 2010,
2011, 2012, 2013, 2014, 2015, 2016, 2017, 2020, 2021, 2022 Tổ chức Phần mềm Tự do.
Đây là phần mềm miễn phí; xem trong mã nguồn để biết các điều khoản về sao chép.
Đây KHÔNG bảo hành; thậm chí còn có thể BÁN ĐƯỢC hay PHÙ HỢP VỚI MỤC ĐÍCH ĐẶC THÙ.
.SH "TẬP TIN BAO GỒM"
Cũng có thể bao gồm dữ liệu bổ sung trong kết xuất, dùng tùy chọn
.B \-\-include
và
.B \-\-opt\-include
Có một định dạng đơn giản:

    [phần]
    văn bản

    /mẫu/
    văn bản

Khối văn bản định dạng *roff đúng nguyên văn được chèn vào kết xuất
hoặc ở đầu của phần
.BI [ phần ]
(không phân biệt chữ hoa/thường),
hoặc đẳng sau một đoạn văn tương ứng với mẫu
.BI / mẫu /\fR.

Mẫu chấp nhận cú pháp của biểu thức chính quy Perl,
và cũng cho phép dấu sửa đổi
.IR i ,
.I s
hay
.I m
(xem
.BR perlre (1)).

Dòng nào đứng trước phần đầu tiên hoặc mẫu bắt đầu với “\-” thì được
xử lý dưới dạng tùy chọn. Dữ liệu khác (nếu có) bị bỏ qua mà không xuất chi tiết,
và có thể được sử dụng làm ghi chú, từ khóa RCS và những thứ tương tự thế.

Thứ tự xuất phần (đã được bao gồm):

    TÊN
    TÓM TẮT
    MÔ TẢ
    TÙY CHỌN
    \fIkhác\fR
    MÔI TRƯỜNG
    TẬP TIN
    VÍ DỤ
    TÁC GIẢ
    THÔNG BÁO LỖI
    BẢN QUYỀN
    XEM THÊM

Bất cứ phần
.B [NAME]
hoặc
.B [SYNOPSIS]
nào xuất hiện trong tập tin bao gồm thì thay thế kết xuất tự động tạo
(dù bạn vẫn còn có dịp ghi đè lên phần tiền nhiệm bằng:
.B \-\-name
nếu cần).

NAME: TÊN
SYNOPSIS: TÓM TẮT

Các phần khác được thêm vào đầu của kết xuất tự động sản sinh
cho những phần tiêu chuẩn đưa ra trên, hoặc được bao gồm tại
.I khác
(bên trên) theo thứ tự gặp trong tập tin bao gồm.

Thay thế phần chữ trong “phần” có thể yêu cầu rõ ràng bằng cách
sử dụng cú pháp
.RI [< phần ],
.RI [= phần ]
hay
.RI [> phần ]
bổ xung thêm chữ vào trước, thay thế vào chỗ đó, hay sau của kết xuất
mặc định tương ứng.
.SH "TÍNH SẴN SÀNG"
Phiên bản mới nhất của bản phân phối này có thể tải về từ:

    ftp://ftp.gnu.org/gnu/help2man/
.SH "TÁC GIẢ"
Viết bởi Brendan O'Dea <bod@debian.org>
.SH "XEM THÊM"
Tài liệu hướng dẫn đầy đủ về
.B help2man
được bảo trì dưới dạng một sổ tay Texinfo.  Nếu chương trình
.B info
và
.B help2man
được cài đặt đúng ở địa chỉ của bạn thì câu lệnh
.IP
.B info help2man
.PP
nên cho phép bạn truy cập đến toàn bộ sổ tay.