Merge changes I505c4aea,I2ae0529c

* changes:
  Import SDL release-1.2.15
  Handle SDL windows with BGRA color

1 files changed, 58 insertions, 0 deletions

diff --git a/distrib/sdl-1.2.15/docs/man3/SDL_CDOpen.3 b/distrib/sdl-1.2.15/docs/man3/SDL_CDOpen.3
new file mode 100644
index 0000000..dbf23fc
--- /dev/null
+++ b/distrib/sdl-1.2.15/docs/man3/SDL_CDOpen.3
@@ -0,0 +1,58 @@
+.TH "SDL_CDOpen" "3" "Tue 11 Sep 2001, 22:58" "SDL" "SDL API Reference" 
+.SH "NAME"
+SDL_CDOpen \- Opens a CD-ROM drive for access\&.
+.SH "SYNOPSIS"
+.PP
+\fB#include "SDL\&.h"
+.sp
+\fBSDL_CD *\fBSDL_CDOpen\fP\fR(\fBint drive\fR);
+.SH "DESCRIPTION"
+.PP
+Opens a CD-ROM drive for access\&. It returns a \fI\fBSDL_CD\fR\fR structure on success, or \fBNULL\fP if the drive was invalid or busy\&. This newly opened CD-ROM becomes the default CD used when other CD functions are passed a \fBNULL\fP CD-ROM handle\&. 
+.PP
+Drives are numbered starting with 0\&. Drive 0 is the system default CD-ROM\&.
+.SH "EXAMPLES"
+.PP
+.nf
+\f(CWSDL_CD *cdrom;
+int cur_track;
+int min, sec, frame;
+SDL_Init(SDL_INIT_CDROM);
+atexit(SDL_Quit);
+
+/* Check for CD drives */
+if(!SDL_CDNumDrives()){
+  /* None found */
+  fprintf(stderr, "No CDROM devices available
+");
+  exit(-1);
+}
+
+/* Open the default drive */
+cdrom=SDL_CDOpen(0);
+
+/* Did if open? Check if cdrom is NULL */
+if(!cdrom){
+  fprintf(stderr, "Couldn\&'t open drive: %s
+", SDL_GetError());
+  exit(-1);
+}
+
+/* Print Volume info */
+printf("Name: %s
+", SDL_CDName(0));
+printf("Tracks: %d
+", cdrom->numtracks);
+for(cur_track=0;cur_track < cdrom->numtracks; cur_track++){
+  FRAMES_TO_MSF(cdrom->track[cur_track]\&.length, &min, &sec, &frame);
+  printf("	Track %d: Length %d:%d
+", cur_track, min, sec);
+}
+
+SDL_CDClose(cdrom);\fR
+.fi
+.PP
+.SH "SEE ALSO"
+.PP
+\fI\fBSDL_CD\fR\fR, \fI\fBSDL_CDtrack\fR\fR, \fI\fBSDL_CDClose\fP\fR
+.\" created by instant / docbook-to-man, Tue 11 Sep 2001, 22:58