Changeset View
Changeset View
Standalone View
Standalone View
quick-porting/chapter.xml
Show First 20 Lines • Show All 352 Lines • ▼ Show 20 Lines | <para>Once happy with the port, the only thing remaining is to | ||||
happy about it too.</para> | happy about it too.</para> | ||||
<important> | <important> | ||||
<para>We do not need the <filename>work</filename> directory or | <para>We do not need the <filename>work</filename> directory or | ||||
the <filename>pkgname.tgz</filename> package, so delete them | the <filename>pkgname.tgz</filename> package, so delete them | ||||
now.</para> | now.</para> | ||||
</important> | </important> | ||||
<para>Next, either create a &man.patch.1;, or a &man.shar.1; file. | <para>Next, either create a &man.patch.1; file. | ||||
Assuming the port is called <literal>oneko</literal> and is in | Assuming the port is called <literal>oneko</literal> and is in | ||||
the <literal>games</literal> category.</para> | the <literal>games</literal> category.</para> | ||||
<example xml:id="porting-submitting-diff"> | <example xml:id="porting-submitting-diff"> | ||||
<title>Creating a <filename>.diff</filename> for a New | <title>Creating a <filename>.diff</filename> for a New | ||||
Port</title> | Port</title> | ||||
<para>Add all the files with <command>svn add</command>. | <para>Add all the files with <command>svn add</command>. | ||||
Show All 9 Lines | &prompt.user; <userinput>svn diff <replaceable>games/oneko</replaceable> > <replaceable>oneko.diff</replaceable></userinput></screen> | ||||
<important> | <important> | ||||
<para>To make it easier for committers to apply the patch on | <para>To make it easier for committers to apply the patch on | ||||
their working copy of the ports tree, please generate the | their working copy of the ports tree, please generate the | ||||
<filename>.diff</filename> from the base of your ports | <filename>.diff</filename> from the base of your ports | ||||
tree.</para> | tree.</para> | ||||
</important> | </important> | ||||
</example> | </example> | ||||
<example xml:id="porting-submitting-shar"> | <para>Submit the <filename>oneko.diff</filename> with the <link | ||||
<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>` > <replaceable>oneko</replaceable>.shar</userinput></screen> | |||||
</example> | |||||
<para>Submit one of <filename>oneko.shar</filename> or | |||||
<filename>oneko.diff</filename> with the <link | |||||
xlink:href="https://bugs.freebsd.org/submit/">bug submission | xlink:href="https://bugs.freebsd.org/submit/">bug submission | ||||
form</link>. Use product <quote>Ports & | form</link>. Use product <quote>Ports & | ||||
Packages</quote>, component <quote>Individual Port(s)</quote>, | Packages</quote>, component <quote>Individual Port(s)</quote>, | ||||
and follow the guidelines shown there. | and follow the guidelines shown there. | ||||
Add a short description of the program to the Description field | Add a short description of the program to the Description field | ||||
of the PR (perhaps a short version of | of the PR (perhaps a short version of | ||||
<varname>COMMENT</varname>), and remember to add | <varname>COMMENT</varname>), and remember to add | ||||
<filename>oneko.shar</filename> or | |||||
<filename>oneko.diff</filename> as an attachment.</para> | <filename>oneko.diff</filename> as an attachment.</para> | ||||
<note> | <note> | ||||
<para>Giving a good description in the summary of the problem | <para>Giving a good description in the summary of the problem | ||||
report makes the work of port committers a lot easier. We | report makes the work of port committers a lot easier. We | ||||
prefer something like <quote>New port: | prefer something like <quote>New port: | ||||
<replaceable>category</replaceable>/<replaceable>portname</replaceable> | <replaceable>category</replaceable>/<replaceable>portname</replaceable> | ||||
<replaceable>short description of | <replaceable>short description of | ||||
Show All 23 Lines |