bug#10868: 24.0.93; `comment-style' needs to be explained

[Drew Adams]

> > The docstring of comment-style refers the user to comment-styles for
> > details on what the values mean.  However, this is not available
> > until after newcomment.el is loaded.  So autoload comment-styles
> > to avoid this problem.
> 
> Then this is an instance of a general problem. See eg
> http://debbugs.gnu.org/cgi/bugreport.cgi?bug=1768
> for the same thing.
> 
> IMO there should be a general solution rather than papering over every
> instance that occurs with more pre/autoloading.

Maybe, maybe not.

No one has suggested "papering over *every instance* that occurs with more
pre/autoloading".  Quite the contrary.  Stefan gave some specific guidelines
(reasons) why preloading makes sense in this _particular_ case.

But if what you say is true and is agreed upon, we can discuss the general
problem & solution separately - in emacs-devel, for example.

Wrt _this_ bug report: let us not let the perfect become the enemy of the good.
Let's not wait for some expected or hoped-for general solution before fixing
this particular bug.

It's hard enough to get approval that a particular option's doc string be
preloaded.  Let's not throw abstract obstacles in the path, once that need has
been recognized in a particular case.

> PS Someone might want to rename this report to reflect the real issue.

Please, no.  Please do not try to detour this bug fix.

Instead, file a separate bug report for the general case that you suppose.  Or
better yet, bring up the question for discussion at emacs-devel.