[fr] #1991, #2003, #2004
Move hook method docs to be with the rest of the Shell docs.

Also add a class annotation for Shell so methods are connected up.
Fix incorrect classname.
Sync up es and fr translations.