svn commit: r47469 - head/en_US.ISO8859-1/books/fdp-primer/writing-style

[Warren Block]

On Thu, 1 Oct 2015, Jason Helfman wrote:

> On Thu, Oct 1, 2015 at 7:55 AM, Warren Block <wblock at freebsd.org> wrote:
>       Author: wblock
>       Date: Thu Oct  1 14:55:39 2015
>       New Revision: 47469
>       URL: https://svnweb.freebsd.org/changeset/doc/47469
>
>       Log:
>         Swap two words transposed.
>
>       Modified:
>         head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml
>
>       Modified: head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml
>       ==============================================================================
>       --- head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml     Thu Oct  1 14:34:32 2015        (r47468)
>       +++ head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml     Thu Oct  1 14:55:39 2015        (r47469)
>       @@ -196,7 +196,7 @@
>                 <para>For example, commands:</para>
>
>                 <informalexample>
>       -           <para>Wrong: Use the command <command>svn</command> to
>       +           <para>Wrong: Use the <command>svn</command> command to
>                     update sources.</para>
>                 </informalexample>
>
>       _______________________________________________
>       svn-doc-all at freebsd.org mailing list
>       https://lists.freebsd.org/mailman/listinfo/svn-doc-all
>       To unsubscribe, send any mail to "svn-doc-all-unsubscribe at freebsd.org"
> 
> 
> 
> Why we are documenting what shouldn't be done? I thought that this was discouraged.

It is.  This section has been around forever, but a bigger issue is that 
this type of redundancy is difficult to explain without showing the 
wrong way.  Suggestions welcome.