Freebsd-update to 9.3 from 9.2

[Doug Hardie]

On 20 July 2014, at 15:02, Warren Block <wblock at wonkity.com> wrote:

> On Sun, 20 Jul 2014, Doug Hardie wrote:
> 
>> 
>> On 20 July 2014, at 11:12, Warren Block <wblock at wonkity.com> wrote:
>> 
>>> On Sat, 19 Jul 2014, Doug Hardie wrote:
>>> 
>>>> 
>>>> On 19 July 2014, at 05:27, Warren Block <wblock at wonkity.com> wrote:
>>>> 
>>>>> On Sat, 19 Jul 2014, Doug Hardie wrote:
>>>>> 
>>>>>> On 18 July 2014, at 16:01, Warren Block <wblock at wonkity.com> wrote:
>>>>>>> It's not necessary to delete the source every time.  But /usr/src should be empty before the initial svn checkout, or there will be files in there that are unmanaged and can cause problems.  The Subversion instructions mention this.  (Or at least some of them do, we have a fair amount of similar sections in different chapters and sections that need to be combined.)
>>>>>>> 
>>>>>> 
>>>>>> I didn't find any mention of that in the manual.
>>>>> 
>>>>> There is one here:
>>>>> 
>>>>> http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/svn.html#svn-usage
>>>>> 
>>>> 
>>>> Yes there is, now that I understand it.  For those who know - its all there.  For those who don't, its not obvious.  The focus of the manual should be different from the man pages.
>>> 
>>> I have reworked that warning to make it more clear.  Is there another place that this should be noted?
>>> 
>> 
>> Not that I saw.  I only saw that note and thought it didn't apply to me.  Wrong again?
> 
> Is there anything else we can do to help make it more clear?  I don't mean to put you on the spot, just that I've found these types of problems often can be used to make valuable improvements in the documentation.  If you think of somewhere else it should be mentioned, or a better way to explain it, please let me or the freebsd-doc mailing list know.
> 

I would appreciate either examples or instructions with examples on how to setup and properly update a system using svn.  Those are the most common things admins do if they are not involved in the development of FreeBSD.  There used to be some good info on that in the handbook back when we used cvsup.  Think more tutorial and less man page constructs.  If I knew enough about the process, I'd try writing it, but so far most of the things I have tried have not worked.  Only one of the several systems I have tried to update to use svn and pkg still works.