Re: Porting SDL2 to a new platform, detailed docs?

--===============8156886631943092672==
Content-Type: multipart/alternative; boundary=001a1144a44ec093630548ea2fb7

--001a1144a44ec093630548ea2fb7
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

Ah, yep, I followed that forum link now and that's the intro file for
porting to a new platform.  My best advice is to do what it says and start
from either a similar platform's implementation or use the dummy driver as
a starting point.  There are several people who will have more to add.

Jonny D

On Sun, Feb 19, 2017 at 5:58 PM, Jonathan Dearborn <[email protected]>
wrote:

> Sounds like you should look at this file:
> http://hg.libsdl.org/SDL/file/5fcc998013ed/docs/README-porting.md
>
> Jonny D
>
> On Sun, Feb 19, 2017 at 4:41 PM, Arne Schwettmann <
> [email protected]> wrote:
>
>> Hello SDL developers,
>> I want to help in porting SDL2 to a new platform. I am new to this, and =
I
>> would greatly appreciate help from somebody who has done this before
>> (porting to Android or other platforms where SDL2 now exists).
>>
>> I have the following question:
>> - Is there a standard reference document that includes all the functions
>> with implementation details*? I need something telling me which system
>> level functions (drivers) I have to implement, detailing their desired
>> behaviour (input/output etc.)?
>>
>> *ideally this should be a long, indexed, pdf and not a bunch of
>> disjointed comments in source or a bunch of disjointed comments/readme=
=E2=80=99s on
>> GitHub :)
>>
>> What I have found:
>>
>> So far I have found this
>> https://forums.libsdl.org/viewtopic.php?p=3D3591&sid=3Dca6328caf
>> 29e567ac498a6d32ae4399a
>>
>> , and some comments in the driver source for SDL2 for other platforms.
>> But surely that can=E2=80=99t be all the documentation for a decade old =
project?
>>
>> To clarify: None of the content at https://wiki.libsdl.org is of use to
>> me, since it is at the user level. I need docs at the driver/internal le=
vel
>> of the API. I am looking at documentation at the developer level for
>> porting the SDL2 library itself, not documentation at the user level for
>> using an existing SDL2 port for a project.
>>
>> Thank you very much for any help in advance,
>> Arne
>>
>> _______________________________________________
>> SDL mailing list
>> [email protected]
>> http://lists.libsdl.org/listinfo.cgi/sdl-libsdl.org
>>
>>
>

--001a1144a44ec093630548ea2fb7
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr">Ah, yep, I followed that forum link now and that&#39;s the=
 intro file for porting to a new platform.=C2=A0 My best advice is to do wh=
at it says and start from either a similar platform&#39;s implementation or=
 use the dummy driver as a starting point.=C2=A0 There are several people w=
ho will have more to add.<div><br></div><div>Jonny D</div></div><div class=
=3D"gmail_extra"><br><div class=3D"gmail_quote">On Sun, Feb 19, 2017 at 5:5=
8 PM, Jonathan Dearborn <span dir=3D"ltr">&lt;<a href=3D"mailto:grimfang4@g=
mail.com" target=3D"_blank">[email protected]</a>&gt;</span> wrote:<br><b=
lockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1px =
#ccc solid;padding-left:1ex"><div dir=3D"ltr">Sounds like you should look a=
t this file:<div><a href=3D"http://hg.libsdl.org/SDL/file/5fcc998013ed/docs=
/README-porting.md" target=3D"_blank">http://hg.libsdl.org/SDL/file/<wbr>5f=
cc998013ed/docs/README-<wbr>porting.md</a><br></div><div><br></div><div>Jon=
ny D</div></div><div class=3D"gmail_extra"><br><div class=3D"gmail_quote"><=
div><div class=3D"h5">On Sun, Feb 19, 2017 at 4:41 PM, Arne Schwettmann <sp=
an dir=3D"ltr">&lt;<a href=3D"mailto:[email protected]" target=3D"_=
blank">[email protected]</a>&gt;</span> wrote:<br></div></div><bloc=
kquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1px #cc=
c solid;padding-left:1ex"><div><div class=3D"h5"><div style=3D"word-wrap:br=
eak-word"><div>Hello SDL developers,</div>I want to help in porting SDL2 to=
 a new platform. I am new to this, and I would greatly appreciate help from=
 somebody who has done this before (porting to Android or other platforms w=
here SDL2 now exists).<div><br></div><div>I have the following question:<br=
><div>- Is there a standard reference document that includes all the functi=
ons with implementation details*? I need something telling me which system =
level functions (drivers) I have to implement, detailing their desired beha=
viour (input/output etc.)?</div><div><br></div><div>*ideally this should be=
 a long, indexed, pdf and not a bunch of disjointed comments in source or a=
 bunch of disjointed comments/readme=E2=80=99s on GitHub :)</div><div><br><=
/div><div>What I have found:</div><div><br></div><div>So far I have found t=
his</div><div><a href=3D"https://forums.libsdl.org/viewtopic.php?p=3D3591&a=
mp;sid=3Dca6328caf29e567ac498a6d32ae4399a" target=3D"_blank">https://forums=
.libsdl.org/view<wbr>topic.php?p=3D3591&amp;sid=3Dca6328caf<wbr>29e567ac498=
a6d32ae4399a</a></div><div><br></div><div>, and some comments in the driver=
 source for SDL2 for other platforms. But surely that can=E2=80=99t be all =
the documentation for a decade old project?</div><div><br></div><div>To cla=
rify: None of the content at=C2=A0<a href=3D"https://wiki.libsdl.org" targe=
t=3D"_blank">https://wiki.libsdl.org</a>=C2=A0is of use to me, since it is =
at the user level. I need docs at the driver/internal level of the API. I a=
m looking at documentation at the developer level for porting the SDL2 libr=
ary itself, not documentation at the user level for using an existing SDL2 =
port for a project.=C2=A0</div><div><br></div><div><div>Thank you very much=
 for any help in advance,</div></div><div>Arne</div></div></div><br></div><=
/div>______________________________<wbr>_________________<br>
SDL mailing list<br>
<a href=3D"mailto:[email protected]" target=3D"_blank">[email protected].=
org</a><br>
<a href=3D"http://lists.libsdl.org/listinfo.cgi/sdl-libsdl.org" rel=3D"nore=
ferrer" target=3D"_blank">http://lists.libsdl.org/listin<wbr>fo.cgi/sdl-lib=
sdl.org</a><br>
<br></blockquote></div><br></div>
</blockquote></div><br></div>

--001a1144a44ec093630548ea2fb7--

--===============8156886631943092672==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

_______________________________________________
SDL mailing list
[email protected]
http://lists.libsdl.org/listinfo.cgi/sdl-libsdl.org

--===============8156886631943092672==--