Improvements to SSL documentation?

Judging from the amount of questions that come up regarding SSL (not to mention that I’'m having problems right now), it occurs to me that the SSL docs that come with Wildfire could use some improvement. Do others feel the same way?

For instance, I see that Thawte’‘s kb has an option which isn’'t mentioned in the jive docs:

keytool -import -trustcacerts -file -alias -keystore [/b].

Similarly, it would have been nice to have a hint about the -keyalg option. There’'s no point in reprinting the url=http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/keytool.htmlkeytool man page[/url], but perhaps a link would be useful?

And while I’'m thinking about it, does the alias refer to the algorithm type (dsa, rsa), or the cn referenced in the certificate (as is implied by the current use of -alias example.com[/b]) or does it simply not matter?

Thoughts?