On Tue, 2020-07-14 at 22:57 -0400, Kevin A. McGrail wrote: > > A pointer to the wiki might be useful in the config files as well as > > > the > > > docs. Suggestions of which files? > > > > local.cf is the obvious one. > > > > Might not be a bad choice. I've never even looked at a stock local.cf > from the project in 20 years though. Need to do a vanilla install and > see what is in there and where it is generated.
> What about the docs? Where would you look for this nugget of > information as a user? > As a long-time UNIX/Linux developer I'd naturally look in the Spamassassin manpage, but I suspect a non-developer may not unless they're a power user. I'd also guess that others, including Mac and Windows users, would be looking for Help|About from a GUI app (nonapplicable here of course) or, failing that, to point a web browser at http://spamassassin.apache.org/ I think the best place to put warnings and advice about exceeding free usage RBL limits are: In the manpage: - the manpage, which only needs a single line saying something like: "Free RBL use limits: URL" added to its WEBSITES section On the Spamassassin website: - The top-level README - The Start Using page in the Wiki - the FAQ page. All these can link to a common page that describes low volume free use policies of Spamhaus and others RBL providers and how NOT using a local non-forwarding DNS can cause the user to get unexpected subscription requests from them. BTW, the page "https://www.spamtips.org/p/about-spamtipsorg.html - Configuration tips and tricks to maximize the effectiveness of SpamAssassin", which is linked to from the 'Docs' page seems to have vanished though the www.spamtips.org website is up and running. > Also: init.pre v330.pre and maybe v340.pre > > Well those pre files are pretty specific for new features in those > versions. > Fair point - I only included them because they load what look to be relevant plugins for this discussion. However, a note there may well propagate to future SA versions because typical developer version forking. Anyway, I hope these comments are useful. Martin
