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
|
<!--
The FreeBSD Russian Documentation Project
$FreeBSDru: frdp/www/ru/docproj/submitting.sgml,v 1.9 2004/09/21 07:31:05 den Exp $
Original revision: 1.14
-->
<!DOCTYPE HTML PUBLIC "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension//EN" [
<!ENTITY base CDATA "..">
<!ENTITY date "$FreeBSD: www/ru/docproj/submitting.sgml,v 1.8 2005/10/05 20:59:52 simon Exp $">
<!ENTITY title "ðÒÏÅËÔ äÏËÕÍÅÎÔÉÒÏ×ÁÎÉÑ FreeBSD: ðÏÓÙÌËÁ ÄÏËÕÍÅÎÔÁÃÉÉ">
<!ENTITY % navinclude.docs "INCLUDE">
]>
<html>
&header;
<h2>ñ ÎÁÐÉÓÁÌ ÎÅËÏÔÏÒÏÅ ËÏÌÉÞÅÓÔ×Ï ÄÏËÕÍÅÎÔÁÃÉÉ. ëÁË ×ÁÍ Å£ ÐÏÓÌÁÔØ?</h2>
<p>÷Ï-ÐÅÒ×ÙÈ, ÓÐÁÓÉÂÏ, ÞÔÏ ×Ù ÎÁÛÌÉ ×ÒÅÍÑ É ÓÄÅÌÁÌÉ ÜÔÏ.</p>
<p>÷Ù ÄÏÌÖÎÙ ÓÄÅÌÁÔØ ×ÁÛÕ ÄÏËÕÍÅÎÔÁÃÉÀ ÄÏÓÔÕÐÎÏÊ ÄÌÑ ÐÒÅÄ×ÁÒÉÔÅÌØÎÏÇÏ
ÐÒÏÓÍÏÔÒÁ. åÓÌÉ ÜÔÏ ×ÏÚÍÏÖÎÏ, ÐÏÍÅÓÔÉÔŠţ ÎÁ FTP ÉÌÉ ×ÅÂ-ÓÅÒ×ÅÒ.</p>
<p>ðÏÓÌÅ ÜÔÏÇÏ ÐÏÛÌÉÔÅ ÓÏÏÂÝÅÎÉÅ × ÓÐÉÓÏË ÒÁÓÓÙÌËÉ -doc Ó ËÒÁÔËÉÍ
ÏÐÉÓÁÎÉÅÍ ÄÏËÕÍÅÎÔÁÃÉÉ É ÓÓÙÌËÏÊ ÎÁ Å£ ÍÅÓÔÏÐÏÌÏÖÅÎÉÅ, Á ÔÁËÖÅ
ÐÒÏÓØÂÏÊ ÐÏÄÅÌÉÔØÓÑ ÏÔÚÙ×ÁÍÉ.</p>
<p>åÓÌÉ ÐÏ ËÁËÉÍ-ÔÏ ÐÒÉÞÉÎÁÍ ×Ù ÎÅ ÍÏÖÅÔÅ ÐÏÍÅÓÔÉÔØ ÄÏËÕÍÅÎÔÁÃÉÀ ÎÁ
ËÁËÏÊ-ÌÉÂÏ FTP ÉÌÉ ×ÅÂ-ÓÅÒ×ÅÒ, ÔÏ ÐÏÛÌÉÔŠţ ÎÅÐÏÓÒÅÄÓÔ×ÅÎÎÏ × ÓÐÉÓÏË
ÒÁÓÓÙÌËÉ -doc. åÓÌÉ ×Ù ÓÏÂÉÒÁÅÔÅÓØ ÐÏÓÔÕÐÉÔØ ÉÍÅÎÎÏ ÔÁË, ÔÏ ÐÒÉÓÙÌÁÊÔÅ
ÄÏËÕÍÅÎÔÙ × ÆÏÒÍÁÔÅ ÏÂÙÞÎÏÇÏ ÔÅËÓÔÁ.</p>
<p>óËÏÒÅÅ ×ÓÅÇÏ, ×Ù ÅÝ£ ÐÏÎÁÄÏÂÉÔÓÑ ÓÄÅÌÁÔØ cc: ÜÔÏÇÏ ÚÁÐÒÏÓÁ ÎÁ
ËÏÍÍÅÎÔÁÒÉÉ × ÄÒÕÇÉÅ ÐÏÄÈÏÄÑÝÉÅ ÓÐÉÓËÉ ÒÁÓÓÙÌËÉ. îÁÐÒÉÍÅÒ, ÞÔÏ-ÌÉÂÏ,
ÏÔÎÏÓÑÝÅÅÓÑ Ë ÉÓÐÏÌØÚÏ×ÁÎÉÀ CVSup ÄÌÑ ÓÉÎÈÒÏÎÉÚÁÃÉÉ ÄÅÒÅ×Á ÉÓÈÏÄÎÙÈ
ÔÅËÓÔÏ×, ÂÕÄÅÔ ÉÎÔÅÒÅÓÎÏ ÐÏÄÐÉÓÞÉËÁÍ ÓÐÉÓËÏ× ÒÁÓÓÙÌËÉ
<tt>FreeBSD-current</tt> É <tt>FreeBSD-stable</tt>.</p>
<p>ðÏÓÌÅ ÔÏÇÏ, ËÁË ÌÀÄÉ ÐÏÓÍÏÔÒÅÌÉ ÎÁ ×ÁÛÕ ÄÏËÕÍÅÎÔÁÃÉÀ, É ×Ù ÐÏÌÕÞÉÌÉ
ÛÁÎÓ ×ËÌÀÞÉÔØ × ÄÏËÕÍÅÎÔ ÌÀÂÙÅ ÉÚ ÉÈ ÐÏÖÅÌÁÎÉÊ, ×Ù ÕÖÅ ÍÏÖÅÔÅ ÐÏÓÙÌÁÔØ
ÜÔÕ ÄÏËÕÍÅÎÔÁÃÉÀ.</p>
<p>þÔÏÂÙ ÓÄÅÌÁÔØ ÜÔÏ, ÚÁÁÒÈÉ×ÉÒÕÊÔŠţ × ÏÄÉÎ tar-ÆÁÊÌ. åÓÌÉ ×ÁÛÁ
ÄÏËÕÍÅÎÔÁÃÉÑ ÓÏÓÔÏÉÔ ÉÚ ÔÒÅÈ ÆÁÊÌÏ×, <tt>one</tt>, <tt>two</tt>
É <tt>three</tt>, Á ×Ù ÈÏÔÉÔÅ ÐÏÌÕÞÉÔØ ÉÈ × ×ÉÄÅ <tt>doc.tar</tt>,
ÓÄÅÌÁÊÔÅ ÓÌÅÄÕÀÝÅÅ:</p>
<pre>
% <b>tar cf doc.tar one two three</b>
</pre>
<p>úÁÔÅÍ ×ÙÐÏÌÎÉÔÅ ÓÖÁÔÉÅ tar-ÆÁÊÌÁ:</p>
<pre>
% <b>gzip -9 doc.tar</b>
</pre>
<p>× ÒÅÚÕÌØÔÁÔÅ ÞÅÇÏ ÐÏÑ×ÉÔÓÑ <tt>doc.tar.gz</tt>.</p>
<p>é, ÎÁËÏÎÅÃ, ÐÅÒÅËÏÄÉÒÕÊÔÅ ÆÁÊÌ × ×ÉÄ, ËÏÔÏÒÙÊ ÐÏÄÈÏÄÉÔ ÄÌÑ ÐÅÒÅÄÁÞÉ
ÞÅÒÅÚ ÌÀÂÕÀ ÐÒÏÇÒÁÍÍÕ ÜÌÅËÔÒÏÎÎÏÊ ÐÏÞÔÙ.</p>
<pre>
% <b>uuencode doc.tar.gz doc.tar.gz > doc.uue</b>
</pre>
<p>ôÅÐÅÒØ ÄÁÊÔÅ ÚÎÁÔØ Ï Î£Í ÇÒÕÐÐÅ ðÒÏÅËÔÁ äÏËÕÍÅÎÔÉÒÏ×ÁÎÉÑ. ðÒÁ×ÉÌØÎÙÍ
ÓÐÏÓÏÂÏÍ ÓÄÅÌÁÔØ ÜÔÏ Ñ×ÌÑÅÔÓÑ ÉÓÐÏÌØÚÏ×ÁÎÉÅ ÐÒÏÇÒÁÍÍÙ <b>send-pr</b>,
ËÏÔÏÒÁÑ ÄÏÌÖÎÁ ÉÍÅÔØÓÑ ÎÁ ×ÁÛÅÊ ÍÁÛÉÎÅ.</p>
<p>÷Ù ÄÅÌÁÅÔÅ ÜÔÏ ÄÌÑ ÔÏÇÏ, ÞÔÏÂÙ ×ÁÛÅ ÐÏÓÌÁÎÉÅ ÍÏÇÌÏ ÂÙÔØ ÏÔÓÌÅÖÅÎÏ.
ëÏÇÄÁ ×Ù ÏÆÏÒÍÌÑÅÔÅ PR (Problem Report - ÓÏÏÂÝÅÎÉÅ Ï ÐÒÏÂÌÅÍÅ), ÅÍÕ
ÎÁÚÎÁÞÁÅÔÓÑ ÕÎÉËÁÌØÎÙÊ ÎÏÍÅÒ. ïÄÉÎ ÉÚ ËÏÍÍÉÔÔÅÒÏ× ÍÏÖÅÔ ÚÁÔÅÍ
ÎÁÐÒÁ×ÉÔØ PR ÓÅÂÅ, É ÕÓÔÁÎÏ×ÉÔØ Ó ×ÁÍÉ Ó×ÑÚØ ÐÏ ÐÏ×ÏÄÕ ×ËÌÀÞÅÎÉÑ
ÎÏ×ÏÊ ÄÏËÕÍÅÎÔÁÃÉÉ × ÓÉÓÔÅÍÕ.</p>
<p><b>send-pr</b> ÓÁÍÁ ÐÏ ÓÅÂÅ ÏÞÅÎØ ÐÒÏÓÔÁ. ÷ÓÅ, ÞÔÏ ÏÎÁ ÄÅÌÁÅÔ - ÜÔÏ
ÐÏÓÙÌËÁ ÜÌÅËÔÒÏÎÎÏÊ ÐÏÞÔÙ, ÏÆÏÒÍÌÅÎÎÏÊ ÏÓÏÂÙÍ ÏÂÒÁÚÏÍ, ÎÁ ÏÐÒÅÄÅÌÅÎÎÙÊ
ÁÄÒÅÓ. ëÏÇÄÁ ×Ù ÚÁÐÕÓËÁÅÔÅ <b>send-pr</b>, ×Ù ÏËÁÚÙ×ÁÅÔÅÓØ ×
ÔÅËÓÔÏ×ÏÍ ÒÅÄÁËÔÏÒÅ (×ÅÒÏÑÔÎÅÅ ×ÓÅÇÏ, <b>vi</b> ÉÌÉ <b>emacs</b>) Ó
ÂÌÁÎËÏÍ ÄÌÑ ÚÁÐÏÌÎÅÎÉÑ É ÎÅËÏÔÏÒÙÍÉ ÉÎÓÔÒÕËÃÉÑÍÉ ÐÏ ÚÁÐÏÌÎÅÎÉÀ.</p>
<p>õÄÏÓÔÏ×ÅÒØÔÅÓØ, ÞÔÏ ÐÕÎËÔ "Category" ÕÓÔÁÎÏ×ÌÅÎ × "docs", Á × ÓÔÒÏÞËÅ
"Class" ÆÉÇÕÒÉÒÕÅÔ ÔÏÌØËÏ ÌÉÛØ "change-request". ÷Ù ÄÏÌÖÎÙ ×ËÌÀÞÉÔØ
× ÜÔÏ PR ÒÁÎÅÅ ÓÏÚÄÁÎÎÙÊ ÆÁÊÌ <tt>.uue</tt>.
<p>ëÏÇÄÁ ×Ù ÚÁ×ÅÒÛÉÔÅ ÒÁÂÏÔÕ Ó ÒÅÄÁËÔÏÒÏÍ, PR ÂÕÄÅÔ ÐÏÓÌÁÎÏ ÐÏ
ÜÌÅËÔÒÏÎÎÏÊ ÐÏÞÔÅ ÔÕÄÁ, ËÕÄÁ ÎÕÖÎÏ. ÷ÓËÏÒÅ ×Ù ÐÏÌÕÞÉÔÅ ÐÏÄÔ×ÅÒÖÄÁÀÝÅÅ
ÓÏÏÂÝÅÎÉÅ, ×ËÒÁÔÃÅ ÇÏ×ÏÒÑÝÅÅ, ËÁËÏÊ ÎÏÍÅÒ ÂÙÌ ÎÁÚÎÁÞÅÎ PR, É ÜÔÏÔ
ÎÏÍÅÒ ÍÏÖÅÔ ÂÙÔØ ÉÓÐÏÌØÚÏ×ÁÎ ÄÌÑ ÏÔÓÌÅÖÉ×ÁÎÉÑ ÅÇÏ ÓÕÄØÂÙ.</p>
<h2>ñ ÓÄÅÌÁÌ ÎÅËÏÔÏÒÙÅ ÉÚÍÅÎÅÎÉÑ É ÉÓÐÒÁ×ÌÅÎÉÑ × ÓÕÝÅÓÔ×ÕÀÝÅÊ ÄÏËÕÍÅÎÔÁÃÉÉ,
ËÁË ×ÁÍ ÉÈ ÐÏÓÌÁÔØ?</h2>
<p>íÙ ÓÎÏ×Á ÂÌÁÇÏÄÁÒÉÍ ×ÁÓ ÚÁ ÔÏ, ÞÔÏ ×Ù ÐÏÔÒÁÔÉÌÉ ÎÁ ÜÔÏ ×ÒÅÍÑ.</p>
<p>ðÒÅÖÄÅ ×ÓÅÇÏ ×ÁÍ ÎÕÖÎÏ ÓÇÅÎÅÒÉÒÏ×ÁÔØ ÏÓÏÂÙÊ ÆÁÊÌ, ÎÁÚÙ×ÁÅÍÙÊ
<i>diff</i>. ÷ ÜÔÏÍ diff-ÆÁÊÌÅ ÓÏÄÅÒÖÁÔÓÑ ÔÏÌØËÏ ÉÚÍÅÎÅÎÉÑ, ËÏÔÏÒÙÅ
×Ù ×ÎÅÓÌÉ. üÔÏ ÏÂÌÅÇÞÁÅÔ ÐÅÒÓÏÎÅ, ×ÙÐÏÌÎÑÀÝÅÊ ×ÎÅÓÅÎÉÅ ÉÚÍÅÎÅÎÉÊ ×
ÓÉÓÔÅÍÕ, ÐÒÏÓÍÏÔÒ ×ÁÛÉÈ ÉÚÍÅÎÅÎÉÊ, ÞÔÏ ÏÚÎÁÞÁÅÔ ÎÅÎÕÖÎÏÓÔØ ÔÒÁÔÙ
ÍÁÓÓÙ ×ÒÅÍÅÎÉ ÎÁ ÏÂßÑÓÎÅÎÉÑ, ÞÔÏ ËÏÎËÒÅÔÎÏ ÂÙÌÏ ÉÚÍÅÎÅÎÏ (ÈÏÔÑ ×Ù
ÄÏÌÖÎÙ ÂÕÄÅÔÅ ÏÂßÑÓÎÉÔØ, ÐÏÞÅÍÕ ÜÔÉ ÉÚÍÅÎÅÎÉÑ ÔÁË ÎÅÏÂÈÏÄÉÍÙ).</p>
<p>þÔÏÂÙ ÓÄÅÌÁÔØ 'diff', ×Ù ÄÏÌÖÎÙ:</p>
<ol>
<li>
<p>óÄÅÌÁÔØ ËÏÐÉÀ ÆÁÊÌÁ, ËÏÔÏÒÙÊ ÓÏÂÉÒÁÅÔÅÓØ ÍÅÎÑÔØ. åÓÌÉ ×Ù
ÉÚÍÅÎÑÅÔÅ <tt>foo.sgml</tt>, ×ÙÐÏÌÎÉÔÅ</p>
<pre>
% <b>cp foo.sgml foo.sgml.old</b>
</pre>
</li>
<li><p>úÁÔÅÍ ×ÎÅÓÉÔÅ ×ÁÛÉ ÉÚÍÅÎÅÎÉÑ × foo.sgml</p>
<pre>
% <b>vi foo.sgml</b>
... ËÌÁÃ ËÌÁÃ ËÌÁÃ ...
... ÔÅÓÔÉÒÕÅÍ ÉÚÍÅÎÅÎÉÑ, ÉÝÅÍ ÏÐÅÞÁÔËÉ, É ÔÏÍÕ ÐÏÄÏÂÎÏÅ ...
</pre>
</li>
<li><p>äÅÌÁÅÍ diff. ëÏÍÁÎÄÁ, ÜÔÏ ÄÅÌÁÀÝÁÑ:</p>
<pre>
% <b>diff -ru foo.sgml.old foo.sgml > foo.diff</b>
</pre>
<p>úÄÅÓØ ×ÙÐÏÌÎÑÅÔÓÑ ÐÒÏÓÍÏÔÒ ÏÔÌÉÞÉÊ ÍÅÖÄÕ Ä×ÕÍÑ ÆÁÊÌÁÍÉ É ÚÁÐÉÓØ
ÜÔÉÈ ÏÔÌÉÞÉÊ × ÆÁÊÌ <tt>foo.diff</tt>.</p>
</li>
</ol>
<p>ðÏÓÌÅ ÜÔÏÇÏ ×Ù ÍÏÖÅÔÅ ÐÏÓÌÁÔØ <tt>foo.diff</tt> ÏÂÒÁÔÎÏ × ÁÄÒÅÓ ÐÒÏÅËÔÁ.
ðÏÛÌÉÔÅ PR ÔÁË, ËÁË ÜÔÏ ÂÙÌÏ ÏÐÉÓÁÎÏ ×ÙÛÅ, ×ËÌÀÞÉ× × ÔÅÌÏ ÐÉÓØÍÁ
ÆÁÊÌ <tt>foo.diff</tt>.</p>
<p></p><a href="docproj.html">ðÒÏÅËÔ äÏËÕÍÅÎÔÉÒÏ×ÁÎÉÑ FreeBSD</a>
&footer;
</body>
</html>
|
