How to choose the default (or any) CKEditor toolbar?

Blurgh. Here's how this stuff works, as far as I can tell, anyway. Two important things to know:

* If you're just using the basic CKEditor module, ckeditor.config.js is completely irrelevant to getting your toolbar set up. Ignore it.

* CKEditor toolbars are associated with text formats, like "Filtered HTML" or "Full HTML" (or, presumably, other text formats you might define). Each text format can be connected to exactly one toolbar; when a textbox with that text format appears, its toolbar will be presented.

So, while more complicated things are possible, let's say that you just want to define a new toolbar for the "Filtered HTML" text format. Here, it seems, is how you do that:

Go to admin/config/content/ckeditor and make a new profile. it's probably easiest to clone whichever profile is currently associated with Filtered HTML. This will take you to an editing form where you can specify the details of the profile. Hack around here if you like and if you understand what you're doing, but the only thing that really matters is that, in the "Basic Setup" block of the form, you give the profile a new name. I don't believe that the name particularly matters other than as a reminder to you or other site developers; it doesn't show up in the user's view of the editor. You'll also see a section called "Input Formats" (this should probably be Text Formats, but whatever) with the single item, "Plain text". Leave this alone (but we'll be back); save your new profile.

Back on admin/config/content/ckeditor, go into the profile that is currently associated with Filtered HTML. In the Basic Setup block of this form, the Input Formats section should have an item called "Filtered HTML" with a checked checkbox next to it. Uncheck the checkbox, and save the form.

Click the "edit" link for your new profile, and go into the Basic Setup block. The Input Formats section will now have two items with checkboxes -- Filtered HTML (now that it's no longer connected to that other profile) and Plain Text. Click the checkbox next to Filtered HTML.

Now, open up the "Editor Appearance" block. The "Toolbar" section offers a very nice drag-and-drop interface that will let you add or remove buttons from a model toolbar. Arrange them however you like: Once you save this profile, THIS WILL BECOME THE TOOLBAR FOR FILTERED HTML. This is why the contents of ckeditor.config.js don't matter -- the toolbar configuration is completely done here. Finally, save your new profile.

You should now be done. Go to Create Content and make a new page that uses Filtered HTML for one of its fields -- you should see the toolbar you just defined.

Anyway, that seems to be how it works. Again, blurgh. If this is documented somewhere (else, now), that would be great to know. If not, the CKEditor people are welcome to steal this. I'm now heading off to fall into a bottle of wine and try to recover from all this....