DOC: Improve docs for searchsorted
DOC: Improve docs for searchsorted

Also compare to the C++ functions with the same purpose.

mhvk/numpy,mattip/numpy,anntzer/numpy,simongibbons/numpy,seberg/numpy,madphysicist/numpy,numpy/numpy,endolith/numpy,mattip/numpy,madphysicist/numpy,abalkin/numpy,charris/numpy,MSeifert04/numpy,endolith/numpy,WarrenWeckesser/numpy,ahaldane/numpy,shoyer/numpy,gfyoung/numpy,pizzathief/numpy,madphysicist/numpy,grlee77/numpy,abalkin/numpy,madphysicist/numpy,jorisvandenbossche/numpy,endolith/numpy,shoyer/numpy,pbrod/numpy,jakirkham/numpy,grlee77/numpy,WarrenWeckesser/numpy,gfyoung/numpy,ahaldane/numpy,jorisvandenbossche/numpy,rgommers/numpy,rgommers/numpy,rgommers/numpy,pizzathief/numpy,jakirkham/numpy,jakirkham/numpy,ahaldane/numpy,mattip/numpy,grlee77/numpy,charris/numpy,shoyer/numpy,anntzer/numpy,simongibbons/numpy,pizzathief/numpy,pbrod/numpy,seberg/numpy,ahaldane/numpy,gfyoung/numpy,MSeifert04/numpy,mhvk/numpy,tynn/numpy,simongibbons/numpy,numpy/numpy,seberg/numpy,grlee77/numpy,tynn/numpy,jorisvandenbossche/numpy,madphysicist/numpy,mattip/numpy,pdebuyl/numpy,pbrod/numpy,endolith/numpy,jakirkham/numpy,mhvk/numpy,pbrod/numpy,Eric89GXL/numpy,simongibbons/numpy,numpy/numpy,jakirkham/numpy,charris/numpy,jorisvandenbossche/numpy,MSeifert04/numpy,pdebuyl/numpy,rgommers/numpy,seberg/numpy,MSeifert04/numpy,ahaldane/numpy,shoyer/numpy,pizzathief/numpy,mhvk/numpy,charris/numpy,anntzer/numpy,numpy/numpy,WarrenWeckesser/numpy,Eric89GXL/numpy,pdebuyl/numpy,grlee77/numpy,simongibbons/numpy,jorisvandenbossche/numpy,Eric89GXL/numpy,pizzathief/numpy,WarrenWeckesser/numpy,abalkin/numpy,anntzer/numpy,tynn/numpy,pbrod/numpy,MSeifert04/numpy,WarrenWeckesser/numpy,pdebuyl/numpy,shoyer/numpy,Eric89GXL/numpy,mhvk/numpy