When I install a new package, more often than not there are variables that I can set - to customise the package. I love customisations, which is why I use Emacs in the first place.
For example, I installed the
osx-dictionary package. In the sample configuration, there is a
(setq osx-dictionary-dictionary-choice "Apple")
Everyone recognises expresions such as these. This one uses the
Apple dictionary as standard for all dictionary queries.
I would like to change some settings for that package, e.g. to use more than one dictionary for the output. I could try a hack, entering a list of dictionaries in the place of "Apple". However, I am hoping that there is maybe a better way (than me extremely inefficiently fumbling around with Lisp code), which finds the variable required within said package to do what I want.
When I use
C-h f and begin to type:
osx-dictio, to display possible completions, I get the following list:
Possible completions are: osx-dictionary--get-buffer osx-dictionary--goto-dictionary osx-dictionary--list-dictionaries osx-dictionary--region-or-word osx-dictionary--search osx-dictionary--view-result osx-dictionary-cli-find-or-recompile osx-dictionary-mode osx-dictionary-open-dictionary.app osx-dictionary-quit osx-dictionary-read-word osx-dictionary-recompile osx-dictionary-search-input osx-dictionary-search-pointer
that is two per line, 7 lines, so 14 possibilities. These are not mentioned in the package description. If anyone can explain the major differences between those with
- and those with
-- it might help me.
But that is not my point.
Is there a way to find definable variables within any given packages, so as to know how one can customise that package WITHOUT having to go and read through all the actual code? [That is namely a massive task for some packages... I don't want to know how the package works, I just want to install it, optimise it for my needs and get on with my life!]
These customisations are the ones I would like to store in my .emacs file. therefore, the descriptions of what it does and what the possible input values are, e.g. boolean or otherwise, would also be great to have.
I apologise if there is an easy answer that I have overlooked, but after searching around for too long, I have drawn a blank. If this is the case, I shall accept the downvote and delete my question in embarrassment, post-haste!