summaryrefslogtreecommitdiff
path: root/help2man.vi.1
blob: ff22fe2dfb29b1224ca93a4bf63401d19d68c45f (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
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.10.
.TH HELP2MAN "1" "Tháng sáu 2012" "help2man 1.40.10" "Lệnh người dùng"
.SH TÊN
help2man \- tạo một trang hướng dẫn đơn giản
.SH "TÓM TẮT"
.B help2man
[\fITÙY_CHỌN\fR]... \fITÊN-LỆNH\fR
.SH "MÔ TẢ"
« help2man » tạo một trang hướng dẫn dựa vào kết xuất của tuỳ chọn
`\-\-help' (trợ giúp) và `\-\-version' (phiên bản).
.TP
\fB\-n\fR, \fB\-\-name\fR=\fICHUỖI\fR
mô tả cho đoạn văn TÊN (NAME)
.TP
\fB\-s\fR, \fB\-\-section\fR=\fIPHẦN\fR
số thứ tự phần cho trang hướng dẫn (1, 6, 8)
.TP
\fB\-m\fR, \fB\-\-manual\fR=\fITÊN\fR
tên của trang hướng dẫn (User Commands, ...)
.TP
\fB\-S\fR, \fB\-\-source\fR=\fITEXT\fR
nguồn của chương trình (FSF, Debian, ...)
.TP
\fB\-L\fR, \fB\-\-locale\fR=\fICHUỖI\fR
chọn miền địa phương (mặc định "C";
.IP
đối với tiếng Việt thì là « vi_VN.UTF\-8 »)
.TP
\fB\-i\fR, \fB\-\-include\fR=\fITỆP\fR
bao gồm dữ liệu từ tập tin này
.TP
\fB\-I\fR, \fB\-\-opt\-include\fR=\fITỆP\fR
bao gồm dữ liệu từ tập tin này nếu có
.TP
\fB\-o\fR, \fB\-\-output\fR=\fITỆP\fR
gửi kết xuất cho tập tin này
.TP
\fB\-p\fR, \fB\-\-info\-page\fR=\fITÊ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 tuỳ 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 tuỳ chọn:
.TP
\fB\-h\fR, \fB\-\-help\-option\fR=\fICHUỖI\fR
chuỗi là tuỳ chọn trợ giúp
.TP
\fB\-v\fR, \fB\-\-version\-option\fR=\fICHUỖI\fR
chuỗi là tuỳ chọn phiên bản
.TP
\fB\-\-version\-string\fR=\fICHUỖ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 tuỳ chọn
.PP
Thông báo lỗi nào cho <bug\-help2man@gnu.org>.
.PP
Tác quyền (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2009, 2010,
2011, 2012 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 BAO GỒM"
Cũng có thể bao gồm dữ liệu bổ sung trong kết xuất, dùng tuỳ chọn
.B \-\-include
và
.B \-\-opt\-include
Có một định dạng đơn giản:

    [phần]
    chuỗi

    /mẫu/
    chuỗi

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 tuỳ 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ừ khoá RCS v.v.

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

    TÊN
    TÓM TẮT
    MÔ TẢ
    TÙY CHỌN
    MÔI TRƯỜNG
    TỆP
    VÍ DỤ
    \fIkhác\fR
    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 [NAME] 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 tạo
cho những phần tiêu chuẩn đưa ra trên, hoặc được bao gồm tại
.I other
(bên trên) theo thứ tự gặp trong tập tin bao gồm.
.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ó sẵn sàng trực tuyến 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 tồn 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 sổ tay hoàn toàn.