This isn't really right, is it? The scripts under $prefix/share/bro
are going to be overwritten except for site/. 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 ...".
Or maybe turn it around: "The following files/paths won't be touched: ..."
Robin
+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