[Bro-Dev] [Bro-Commits] [git/bro] fastpath: Add general FAQ entry about upgrading Bro. (e93748d)

[Siwek, Jonathan Luke]

> 
>> +What files will get overwritten when upgrading/installing a new Bro version?
>> +----------------------------------------------------------------------------
>> +
>> +Expect everything except things in ``$prefix/share/bro`` and
>> +``$prefix/etc`` to be overwritten, but backing up the entire ``$prefix``
>> +before upgrading is good practice (``$prefix`` indicating the root of
>> +where Bro was installed).
>> +
> 
> This isn't really right, is it? The scripts under $prefix/share/bro
> are going to be overwritten except for site/.

Oops, I actually did mean to type "$prefix/share/bro/site" and not "$prefix/share/bro", thanks.

> On the other hand,
> $prefix/share/logs shouldn't be touched. More generally, because we
> install into a general $prefix, there's lots of non-Bro stuff there
> that won't be touched, so maybe it needs a framing like "Of the files
> that Bro installs, it may override …".

The question I was trying to answer was "Of the files that Bro installs, which *won't* it overwrite?".  I'll redo the FAQ for that and see what you think.

> Or maybe turn it around: "The following files/paths won't be touched: ..."

Not sure if people care to know about what happens to most run-time stuff, but I can see mentioning that at least logs don't get touched.

    Jon