[kde-doc-english] [Bug 81362] New: KExtendedSocket listening constructor should be better documented

[Linus McCabe]

------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
      
http://bugs.kde.org/show_bug.cgi?id=81362      
           Summary: KExtendedSocket listening constructor should be better
                    documented
           Product: docs
           Version: unspecified
          Platform: unspecified
        OS/Version: Linux
            Status: NEW
          Severity: normal
          Priority: NOR
         Component: general
        AssignedTo: kde-doc-english kde org
        ReportedBy: linus mccabe nu


Version:            (using KDE KDE 3.2.2)
Installed from:    00

The documentation section for 
KExtendedSocket::KExtendedSocket ( const QString & host, const QString & service, int flags = 0) 
( http://developer.kde.org/documentation/library/cvs-api/kdecore/html/classKExtendedSocket.html#a2 )
should be better documented, especially in regards to the the host argument.

Either you can bind to a specific host, like 'localhost', and only accept incoming connections made to that hostname, or you can accept connections for any host, by specifying QString::null. The latter part is a bit unclear imo, I was trying things like "" before finally finding an example showing (the probably obvious to some people)  correct use.

It should also be noted in the general description.

thanks
/Linus