os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Wrap long lines

Browse source 
Submitted by:	wblock@ (via mail)
This commit is contained in:
Carlo Strub 2012-09-02 12:21:36 +00:00
parent 000ef04a07
commit cc239ad8bc
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=39488
1 changed files with 15 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

27
en_US.ISO8859-1/books/porters-handbook/book.sgml
View file

@ -3414,30 +3414,33 @@ ALWAYS_KEEP_DISTFILES= yes
<title><makevar>COMMENT</makevar></title>
<para>This is a one-line description of the port.
Please respect the following rules:</para>
<orderedlist>
Please respect the following rules:</para>
<orderedlist>
<listitem>
<para>Try to keep the COMMENT value at no longer than 70
characters, as this line will be used by the &man.pkg.info.1;
utility to display a one-line summary of the port;</para>
characters, as this line will be used by the
&man.pkg.info.1; utility to display a one-line summary
of the port;</para>
</listitem>
<listitem>
<para>Do <emphasis>not</emphasis> include the package name
(or version number of the software);</para>
<para>Do <emphasis>not</emphasis> include the package
name (or version number of the software);</para>
</listitem>
<listitem>
<para>The comment should begin with a capital and end without a
period;</para>
<para>The comment should begin with a capital and end
without a period;</para>
</listitem>
<listitem>
<para>Do not start with an indefinite article (i.e. A or An);</para>
<para>Do not start with an indefinite article (i.e.
A or An);</para>
</listitem>
<listitem>
<para>Names are capitalized (e.g. Apache, JavaScript, Perl);</para>
<para>Names are capitalized (e.g. Apache, JavaScript,
Perl);</para>
</listitem>
<listitem>
<para>For lists of words use the Oxford comma (e.g. green,
red<emphasis>,</emphasis> and blue);</para>
<para>For lists of words use the Oxford comma (e.g.
green, red<emphasis>,</emphasis> and blue);</para>
</listitem>
<listitem>
<para>Spell check the text.</para>