Page MenuHomeFreeBSD

D25148.id72936.diff
No OneTemporary

D25148.id72936.diff

Index: en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml
@@ -358,7 +358,7 @@
now.</para>
</important>
- <para>Next, either create a &man.patch.1;, or a &man.shar.1; file.
+ <para>Next, create a &man.patch.1;, file.
Assuming the port is called <literal>oneko</literal> and is in
the <literal>games</literal> category.</para>
@@ -384,20 +384,7 @@
</important>
</example>
- <example xml:id="porting-submitting-shar">
- <title>Creating a <filename>.shar</filename> for a New
- Port</title>
-
- <para><command>cd</command> to the directory above where the
- port directory is located, and use <command>shar</command> to
- create the archive:</para>
-
- <screen>&prompt.user; <userinput>cd ..</userinput>
-&prompt.user; <userinput>shar `find <replaceable>oneko</replaceable>` &gt; <replaceable>oneko</replaceable>.shar</userinput></screen>
- </example>
-
- <para>Submit one of <filename>oneko.shar</filename> or
- <filename>oneko.diff</filename> with the <link
+ <para>Submit <filename>oneko.diff</filename> with the <link
xlink:href="https://bugs.freebsd.org/submit/">bug submission
form</link>. Use product <quote>Ports &amp;
Packages</quote>, component <quote>Individual Port(s)</quote>,
@@ -405,7 +392,6 @@
Add a short description of the program to the Description field
of the PR (perhaps a short version of
<varname>COMMENT</varname>), and remember to add
- <filename>oneko.shar</filename> or
<filename>oneko.diff</filename> as an attachment.</para>
<note>
@@ -435,5 +421,21 @@
added to the list of <link
xlink:href="&url.articles.contributors;/contrib-additional.html">Additional
&os; Contributors</link> and other files.</para>
+
+ <para>It is also possible to submit ports using a &man.shar.1; file. Using
+ the previous example with the <literal>oneko</literal> port above.</para>
+
+ <example xml:id="porting-submitting-shar">
+ <title>Creating a <filename>.shar</filename> for a New Port</title>
+
+ <para>go to the directory above where the
+ port directory is located, and use <command>tar</command> to
+ create the shar archive:</para>
+
+ <screen>&prompt.user; <userinput>cd ..</userinput>
+ &prompt.user; <userinput>tar cf <replaceable>oneko</replaceable>.shar --format shar <replaceable>oneko</replaceable></userinput></screen>
+ </example>
+ <para><filename>oneko.shar</filename> can then be submitted in the same way
+ as <filename>oneko.diff</filename> above.</para>
</sect1>
</chapter>

File Metadata

Mime Type
text/plain
Expires
Wed, Nov 19, 8:42 PM (13 h, 13 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
25674683
Default Alt Text
D25148.id72936.diff (2 KB)

Event Timeline