aketzu, 5 months ago

@bagder curlopt ssh privkey page doesn't mention that libssh2+gxrypt combo doesn't support extracting pubkey from privkey. Also I think id_rsa/id_dsa defaults are only used with libssh2. Does WolfSSL support pubkey at all? And libssh can do ed25519

https://github.com/libssh2/libssh2/blob/c0f69548be902147ce014ffa40b8db3cf1d4b0b4/src/libgcrypt.c#L169

bagder, 5 months ago

@aketzu lots of details there are SSH library specific, that also changes between versions. It's very hard for libcurl to have an exhaustive description of the myriad of combinations that can be used.. libssh2 speaks ed25519 as well and yes wolfSSH supports pubkey but curl's wolfSSH backend is a little incomplete so maybe there are things lacking...

oschonrock, 5 months ago

@bagder

The "problem" with curl is not the quality of the docs..

It's the sheer quantity! 😀

man pages which are more than 3 screens high, are very difficult to work with..

bagder, 5 months ago

@oschonrock I disagree with that as a general rule. Every option needs to be described properly. When you want to know how things works, you want to find that section in the docs, read it and understand it. Then it doesn't matter if there are N other pages because you don't read those.

oschonrock, 5 months ago

@bagder

it was totally a joke..

The docs are awesome..

Many many features.. make for very long docs..

The "half joke" part of it, is that I do find "simple programs" easier to place in recall and to quickly read a man page for.

Curl is massive. I use it almost every day (for 30 years) and know nearly nothing about it.

Awesome job , keep it up.

bagder, 5 months ago

@oschonrock but yes, a major challenge with docs is that the more there is, the harder it can get to find what you're looking for