# Does documentation exist for SDL\_net?

**URL:** <https://discourse.libsdl.org/t/does-documentation-exist-for-sdl-net/3645>\
**Category:** SDL Development\
**Created:** [December 19, 2000, 2:23am UTC](https://discourse.libsdl.org/t/does-documentation-exist-for-sdl-net/3645 "2000-12-19T02:23:08Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![John\_Lawrence](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/j/4af34b/32.png) [@John\_Lawrence](https://discourse.libsdl.org/u/John_Lawrence)\
**Post date:** [December 19, 2000, 2:23am UTC](https://discourse.libsdl.org/t/does-documentation-exist-for-sdl-net/3645/1 "2000-12-19T02:23:08Z")

</div>

Hello all,

I’ve been stumbling around trying to use SDL\_net for a little while, i was just wondering if there was documentation of any kind that deals with it. Thanks!

-john

---

<div class="post-metadata">

**Author:** ![Miguel\_Angel\_Blanch](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/m/eada6e/32.png) [@Miguel\_Angel\_Blanch](https://discourse.libsdl.org/u/Miguel_Angel_Blanch)\
**Post date:** [December 19, 2000, 10:41am UTC](https://discourse.libsdl.org/t/does-documentation-exist-for-sdl-net/3645/2 "2000-12-19T10:41:02Z")

</div>

Mensaje citado por: John Lawrence :

> Hello all,
> 
> I’ve been stumbling around trying to use SDL\_net for a little while,  
> i \> was just wondering if there was documentation of any kind that  
> deals \> with it. Thanks!

SDL\_net.h explain it perfectly.  
Aynway follow me any question as I have been using it for around a  
year in arianne ( [http://www.arianne.cx](http://www.arianne.cx) )

Regards,  
Miguel

---

<div class="post-metadata">

**Author:** ![Oisin\_Mulvihill](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/o/8edcca/32.png) [@Oisin\_Mulvihill](https://discourse.libsdl.org/u/Oisin_Mulvihill)\
**Post date:** [December 19, 2000, 11:25am UTC](https://discourse.libsdl.org/t/does-documentation-exist-for-sdl-net/3645/3 "2000-12-19T11:25:33Z")

</div>

Header files comments are NOT documentation. I’m seriously  
thinking about writting proper docs+examples for this, as there  
is quite a few things the header file is very vague about.  
Hopefully I’ll find time to do this after the project i’m  
working.

om.

p.s. don’t get me wrong, I think sdl\_net is great its just  
a bit tricky if you’re new to it, as I was almost a year  
ago now.\> ----- Original Message -----

> From: MIGUEL ANGEL BLANCH LARDIN [[mailto:x5101920@fedro.ugr.es](mailto:x5101920@fedro.ugr.es)]  
> Sent: Tuesday, December 19, 2000 10:41 AM  
> To: sdl at [lokigames.com](http://lokigames.com)  
> Subject: Re: [SDL] does documentation exist for SDL\_net?
> 
> Mensaje citado por: John Lawrence :
> 
> > Hello all,
> > 
> > I’ve been stumbling around trying to use SDL\_net for a little while,  
> > i \> was just wondering if there was documentation of any kind that  
> > deals \> with it. Thanks!
> 
> SDL\_net.h explain it perfectly.  
> Aynway follow me any question as I have been using it for around a  
> year in arianne ( [http://www.arianne.cx](http://www.arianne.cx) )
> 
> Regards,  
> Miguel

---

<div class="post-metadata">

**Author:** ![John\_Lawrence](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/j/4af34b/32.png) [@John\_Lawrence](https://discourse.libsdl.org/u/John_Lawrence)\
**Post date:** [December 19, 2000, 8:44pm UTC](https://discourse.libsdl.org/t/does-documentation-exist-for-sdl-net/3645/4 "2000-12-19T20:44:10Z")

</div>

I’ve tried digging through the source files, but the best way i’ve learned  
how to use it is hacking away at the sample chat program. I still don’t know  
how to use it, I just copy and paste from chat.cpp & chatd.c 🙂 . That  
would be awesome if you could work on the docs, let me know when you get  
aound to that!

PS - speaking of SDL\_net being tricky, do you know why when you set a client  
to connect to a local server with the hostname localhost, instead of your  
local IP, that communication with clients outside of localhost is  
impossible? i found that odd…\> ----- Original Message -----

> From: [oisin.mulvihill@trintech.com](mailto:oisin.mulvihill@trintech.com) (Oisin Mulvihill)  
> To:   
> Sent: Tuesday, December 19, 2000 3:25 AM  
> Subject: RE: [SDL] does documentation exist for SDL\_net?
> 
> > Header files comments are NOT documentation. I’m seriously  
> > thinking about writting proper docs+examples for this, as there  
> > is quite a few things the header file is very vague about.  
> > Hopefully I’ll find time to do this after the project i’m  
> > working.
> > 
> > om.
> > 
> > p.s. don’t get me wrong, I think sdl\_net is great its just  
> > a bit tricky if you’re new to it, as I was almost a year  
> > ago now.
> > 
> > -----Original Message-----  
> > From: MIGUEL ANGEL BLANCH LARDIN [mailto:x5101920 at fedro.ugr.es]  
> > Sent: Tuesday, December 19, 2000 10:41 AM  
> > To: sdl at [lokigames.com](http://lokigames.com)  
> > Subject: Re: [SDL] does documentation exist for SDL\_net?
> > 
> > Mensaje citado por: John Lawrence :
> > 
> > > Hello all,
> > > 
> > > I’ve been stumbling around trying to use SDL\_net for a little while,  
> > > i \> was just wondering if there was documentation of any kind that  
> > > deals \> with it. Thanks!
> > 
> > SDL\_net.h explain it perfectly.  
> > Aynway follow me any question as I have been using it for around a  
> > year in arianne ( [http://www.arianne.cx](http://www.arianne.cx) )
> > 
> > Regards,  
> > Miguel

---

<div class="post-metadata">

**Author:** ![Miguel\_Angel\_Blanch](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/m/eada6e/32.png) [@Miguel\_Angel\_Blanch](https://discourse.libsdl.org/u/Miguel_Angel_Blanch)\
**Post date:** [December 19, 2000, 10:01pm UTC](https://discourse.libsdl.org/t/does-documentation-exist-for-sdl-net/3645/5 "2000-12-19T22:01:23Z")

</div>

> PS - speaking of SDL\_net being tricky, do you know why when you set  
> a  
> client  
> to connect to a local server with the hostname localhost, instead of  
> your  
> local IP, that communication with clients outside of localhost is  
> impossible? i found that odd…

I don’t understand exactly but are you saying that you execute two  
client on different machines to connect to localhost and it don’t run,  
is it?

Ok, this is the expected behaviour, use instead the IP ( and don’t use  
neither 127.0.0.1 )

---

<div class="post-metadata">

**Author:** ![John\_Lawrence](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/j/4af34b/32.png) [@John\_Lawrence](https://discourse.libsdl.org/u/John_Lawrence)\
**Post date:** [December 19, 2000, 11:06pm UTC](https://discourse.libsdl.org/t/does-documentation-exist-for-sdl-net/3645/6 "2000-12-19T23:06:03Z")

</div>

no, when you’re running the server on a machine, and you connect to that  
server locally using hostname localhost as a connection destination, and  
then connect to it remotely, the locally connected client cannot communicate  
with a remote client. if you use the IP while connecting locally, then  
you’re able to communicate with remote clients. _whew_\> ----- Original Message -----

> From: x5101920@fedro.ugr.es (Miguel Angel Blanch Lardin)  
> To:   
> Sent: Tuesday, December 19, 2000 2:01 PM  
> Subject: Re: [SDL] does documentation exist for SDL\_net?
> 
> > > PS - speaking of SDL\_net being tricky, do you know why when you set  
> > > a  
> > > client  
> > > to connect to a local server with the hostname localhost, instead of  
> > > your  
> > > local IP, that communication with clients outside of localhost is  
> > > impossible? i found that odd…
> > 
> > I don’t understand exactly but are you saying that you execute two  
> > client on different machines to connect to localhost and it don’t run,  
> > is it?
> > 
> > Ok, this is the expected behaviour, use instead the IP ( and don’t use  
> > neither 127.0.0.1 )

---

<div class="post-metadata">

**Author:** ![Martin\_Donlon](https://discourse.libsdl.org/letter_avatar_proxy/v4/letter/m/919ad9/32.png) [@Martin\_Donlon](https://discourse.libsdl.org/u/Martin_Donlon)\
**Post date:** [December 20, 2000, 1:45am UTC](https://discourse.libsdl.org/t/does-documentation-exist-for-sdl-net/3645/7 "2000-12-20T01:45:14Z")

</div>

Well why not join the SDLdoc Project then? Experience the joy of docbook and  
the pain of the toolchain.  
No seriously, its great fun:)  
However, if you are seriously considering writing documentation then you might  
aswell make it part of sdldoc.

And all you other troubled souls? Waking up in a cold sweat, wanting to  
document something but you just don’t know what? SDLdoc is for you!On Tue, Dec 19, 2000 at 11:25:33AM -0000, Oisin Mulvihill wrote:

> Header files comments are NOT documentation. I’m seriously  
> thinking about writting proper docs+examples for this, as there  
> is quite a few things the header file is very vague about.  
> Hopefully I’ll find time to do this after the project i’m  
> working.
> 
> om.
> 
> p.s. don’t get me wrong, I think sdl\_net is great its just  
> a bit tricky if you’re new to it, as I was almost a year  
> ago now.
> 
> -----Original Message-----  
> From: MIGUEL ANGEL BLANCH LARDIN [mailto:x5101920 at fedro.ugr.es]  
> Sent: Tuesday, December 19, 2000 10:41 AM  
> To: sdl at [lokigames.com](http://lokigames.com)  
> Subject: Re: [SDL] does documentation exist for SDL\_net?
> 
> Mensaje citado por: John Lawrence :
> 
> > Hello all,
> > 
> > I’ve been stumbling around trying to use SDL\_net for a little while,  
> > i \> was just wondering if there was documentation of any kind that  
> > deals \> with it. Thanks!
> 
> SDL\_net.h explain it perfectly.  
> Aynway follow me any question as I have been using it for around a  
> year in arianne ( [http://www.arianne.cx](http://www.arianne.cx) )
> 
> Regards,  
> Miguel

## – Martin

Bother! said Pooh, as he sunk his twelfth Guinness