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

Jonathan Dearborn <[email protected]> Sun, 19 Feb 2017 17:58:16 -0500
Newsgroups gmane.comp.lib.sdl
Message-ID <CA+DSiHajUhv9ze10XkM1iL8Rh9PQXndG9_DHjnKkm7BB64=Ncg@mail.gmail.com>
--===============4160868503302351503==
Content-Type: multipart/alternative; boundary=f40304379edc47198a0548ea16af

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

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]=
m
> 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 disjointe=
d
> 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=3D
> ca6328caf29e567ac498a6d32ae4399a
>
> , and some comments in the driver source for SDL2 for other platforms. Bu=
t
> surely that can=E2=80=99t be all the documentation for a decade old proje=
ct?
>
> 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 lev=
el
> 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
>
>

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

<div dir=3D"ltr">Sounds like you should look at this file:<div><a href=3D"h=
ttp://hg.libsdl.org/SDL/file/5fcc998013ed/docs/README-porting.md">http://hg=
.libsdl.org/SDL/file/5fcc998013ed/docs/README-porting.md</a><br></div><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 4:41 PM, Arne Schwettmann <span di=
r=3D"ltr">&lt;<a href=3D"mailto:[email protected]" target=3D"_blank=
">[email protected]</a>&gt;</span> wrote:<br><blockquote class=3D"g=
mail_quote" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-l=
eft:1ex"><div style=3D"word-wrap:break-word"><div>Hello SDL developers,</di=
v>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 (port=
ing to Android or other platforms where SDL2 now exists).<div><br></div><di=
v>I have the following question:<br><div>- Is there a standard reference do=
cument that includes all the functions with implementation details*? I need=
 something telling me which system level functions (drivers) I have to impl=
ement, detailing their desired behaviour (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 this</div><div><a href=3D"https://forums=
.libsdl.org/viewtopic.php?p=3D3591&amp;sid=3Dca6328caf29e567ac498a6d32ae439=
9a" target=3D"_blank">https://forums.libsdl.org/<wbr>viewtopic.php?p=3D3591=
&amp;sid=3D<wbr>ca6328caf29e567ac498a6d32ae439<wbr>9a</a></div><div><br></d=
iv><div>, and some comments in the driver source for SDL2 for other platfor=
ms. But surely that can=E2=80=99t be all the documentation for a decade old=
 project?</div><div><br></div><div>To clarify: None of the content at=C2=A0=
<a href=3D"https://wiki.libsdl.org" target=3D"_blank">https://wiki.libsdl.o=
rg</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 am looking at documentation at the =
developer level for porting the SDL2 library itself, not documentation at t=
he user level for using an existing SDL2 port for a project.=C2=A0</div><di=
v><br></div><div><div>Thank you very much for any help in advance,</div></d=
iv><div>Arne</div></div></div><br>______________________________<wbr>______=
___________<br>
SDL mailing list<br>
<a href=3D"mailto:[email protected]">[email protected]</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/<wbr>listinfo.cgi/sdl-lib=
sdl.org</a><br>
<br></blockquote></div><br></div>

--f40304379edc47198a0548ea16af--

--===============4160868503302351503==
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

--===============4160868503302351503==--