Adjust the info and man page files to Debian. -- Ludovic Brenta. --- docs/gtkada_rm/gtkada_rm.texi~ +++ docs/gtkada_rm/gtkada_rm.texi @@ -1,11 +1,11 @@ \input texinfo @c -*-texinfo-*- -@settitle GtkAda Reference Manual -@setfilename gtkada_rm.info +@settitle GtkAda 2.4 Reference Manual +@setfilename gtkada2_rm.info @syncodeindex fn cp @dircategory User Interface Toolkit @direntry -* GtkAda_Rm: (gtkada_rm). Ada95 graphical tookit based on GTK+ (Reference Manual) +* GtkAda2 Reference Manual: (gtkada2_rm). Ada95 graphical tookit based on GTK+ (Reference Manual) @end direntry @c -------------------------------------------- --- docs/dgate.1~ +++ docs/dgate.1 @@ -1,18 +1,19 @@ -.TH DGATE 1 "29 March 1999" "GNU Debian/Linux" "GtkAda programming manual" +.TH DGATE2 1 "2 July 2003" "Debian GNU/Linux" "GtkAda 2.4 programming manual" .SH NAME -dgate \- dynamically test a GLADE XML file +dgate2 \- dynamically test a GLADE XML file .SH SYNOPSIS -.B dgate +.B dgate2 .I file .SH DESCRIPTION -\fIdgate\fP is the dynamic version of the program transforming -a file produced by \fIglade(1)\fP, the Gtk GUI builder, into an Ada -program. It will not produce any Ada code, but will simulate the Ada code -generated by \fIgate(1)\fP, and is useful during the design phase. +\fIdgate2\fP is the dynamic version of the program transforming a file +produced by \fIglade-2(1)\fP, the Gtk GUI builder, into an Ada +program. It will not produce any Ada code, but will simulate the Ada +code generated by \fIgate2(1)\fP, and is useful during the design +phase. .SH "SEE ALSO" -.BR gtkada-config (1), -.BR gate (1), -.BR glade (1) +.BR gtkada2-config (1), +.BR gate2 (1), +.BR glade-2 (1) .SH "COPYRIGHT FOR THIS MAN PAGE" This man page has been written by Samuel Tardieu for the Debian GNU/Linux distribution, from informations given --- docs/gate.1~ +++ docs/gate.1 @@ -1,33 +1,34 @@ -.TH GATE 1 "29 March 1999" "GNU Debian/Linux" "GtkAda programming manual" +.TH GATE2 1 "2 July 2003" "Debian GNU/Linux" "GtkAda 2.4 programming manual" .SH NAME -gate \- generate Ada applications from a GLADE XML file +gate2 \- generate Ada applications from a GLADE XML file .SH SYNOPSIS -.B gate +.B gate2 .I file .SH DESCRIPTION -\fIgate\fP is the static version of the program transforming -a file produced by \fIglade(1)\fP, the Gtk GUI builder, into an Ada -program. -It will generate a set of Ada files that, when compiled, will -recreate the interface you just designed in \fIglade(1)\fP. -The most important file created by Gate is called +\fIgate2\fP is the static version of the program transforming a file +produced by \fIglade-2(1)\fP, the Gtk GUI builder, into an Ada +program. It will generate a set of Ada files that, when compiled, +will recreate the interface you just designed in \fIglade-2(1)\fP. +The most important file created by gate2 is called .\" .IR "callback_.adb" . .IB "callback_" "" ".adb" and contains stubs for all the callbacks you declared in Glade. .PP -Note that you can easily go back to Glade any time, modify your interface, -and have \fIgate\fP regenerate a set of files. All your modifications will be -kept in the new files. For that, \fIgate\fP creates a directory -.B .gate -in the current directory. Please do not delete it if you want \fIgate\fP to be able to -keep your changes from one version to the next. -Also note that to be able to keep track of your modifications, gate relies on -patch and diff being available on your system. If you don't have a working set -of diff/patch, configure will simply replace them by null operations. +Note that you can easily go back to glade-2 any time, modify your +interface, and have \fIgate2\fP regenerate a set of files. All your +modifications will be kept in the new files. For that, \fIgate2\fP +creates a directory +.B .gate2 +in the current directory. Please do not delete it if you want +\fIgate2\fP to be able to keep your changes from one version to the +next. Also note that to be able to keep track of your modifications, +gate2 relies on patch and diff being available on your system. If you +don't have a working set of diff/patch, configure will simply replace +them by null operations. .SH "SEE ALSO" -.BR gtkada-config (1), -.BR dgate (1), -.BR glade (1) +.BR gtkada2-config (1), +.BR dgate2 (1), +.BR glade-2 (1) .SH "COPYRIGHT FOR THIS MAN PAGE" This man page has been written by Samuel Tardieu for the Debian GNU/Linux distribution, from informations given --- docs/gtkada-config.1~ +++ docs/gtkada-config.1 @@ -1,48 +1,56 @@ -.TH GTKADA-CONFIG 1 "29 March 1999" "GNU Debian/Linux" "GtkAda programming manual" +.TH GTKADA2-CONFIG 1 "2 July 2003" "Debian GNU/Linux" "GtkAda 2.4 programming manual" .SH NAME -gtkada-config - script to get information about the installed version of GTKADA +gtkada2-config - script to get information about the installed version of GTKADA .SH SYNOPSIS -.B gtkada-config +.B gtkada2-config [\-\-prefix\fI[=DIR]\fP] [\-\-version] [\-\-libs] [\-\-cflags] [\-\-static] .SH DESCRIPTION .PP -\fIgtkada-config\fP is a tool that is used to configure to determine -the compiler and linker flags that should be used to compile -and link programs that use \fIGTKADA\fP. -. +\fIgtkada2-config\fR is a tool that is used to configure to determine +the compiler and linker flags that should be used to compile and link +programs that use GtkAda. To compile, bind and link a program against +GtkAda, you invoke \fBgnatmake\fR like this: + + gnatmake my_prog `gtkada2-config` + .SH OPTIONS .l -\fIgtkada-config\fP accepts the following options: +\fBgtkada2-config\fR accepts the following options: .TP 8 .B \-\-version -Print the currently installed version of \fIGTKADA\fP on the standard output. +Print the currently installed version of \fIGTKADA\fR on the standard output. .TP 8 .B \-\-libs -Print the linker flags that are necessary to link a \fIGTKADA\fP program. +Print the linker flags that are necessary to link a \fIGTKADA\fR program. .TP 8 .B \-\-cflags -Print the compiler flags that are necessary to compile a \fIGTKADA\fP program. +Print the compiler flags that are necessary to compile a \fIGTKADA\fR program. .TP 8 .B \-\-static -Print the flags that are necessary to statically build a \fIGTKADA\fP program. +Print the flags that are necessary to statically build a \fIGTKADA\fR program. .TP 8 .B \-\-prefix=PREFIX -If specified, use PREFIX instead of the installation prefix that \fIGTKADA\fP -was built with when computing the output for the \-\-cflags and -\-\-libs options. This option must be specified -before any \-\-libs or \-\-cflags options. +Use PREFIX instead of the installation prefix that \fIGTKADA\fR was +built with when computing the output for the \-\-cflags and \-\-libs +options. This option must be specified before any \-\-libs or +\-\-cflags options. + +.SH NOTES +In Debian GNU/Linux, a GNAT project file is available as an +alternative; see \fB/usr/share/ada/adainclude/gtkada2.gpr\fR. + .SH "SEE ALSO" -.BR gate (1), -.BR dgate (1), -.BR glade (1) +.BR gate2 (1), +.BR dgate2 (1), +.BR glade-2 (1) .SH "COPYRIGHT FOR THIS MAN PAGE" -This man page has been written by Samuel Tardieu -for the Debian GNU/Linux distribution, from informations given -by the GtkAda authors Emmanuel Briot, Joel Brobecker and Arnaud Charlet. - -Permission to use, copy, modify, and distribute this documentation -for any purpose and without fee is hereby granted, -provided that the above copyright notice appear in all copies and that -both that copyright notice and this permission notice appear in -supporting documentation. +This man page has been written by Samuel Tardieu and modified by +Ludovic Brenta for the Debian GNU/Linux distribution, from +informations given by the GtkAda authors Emmanuel Briot, Joel +Brobecker and Arnaud Charlet. + +Permission to use, copy, modify, and distribute this documentation for +any purpose and without fee is hereby granted, provided that the above +copyright notice appear in all copies and that both that copyright +notice and this permission notice appear in supporting documentation. --- docs/gtkada_ug/gtkada_ug.texi~ +++ docs/gtkada_ug/gtkada_ug.texi @@ -1,12 +1,12 @@ \input texinfo @c -*-texinfo-*- @c %**start of header -@setfilename gtkada_ug.info -@settitle GtkAda User's Guide +@setfilename gtkada2_ug.info +@settitle GtkAda 2.4 User's Guide @syncodeindex fn cp @dircategory User Interface Toolkit @direntry -* GtkAda_Ug: (gtkada_ug). Ada95 graphical tookit based on GTK+ (User's Guide) +* GtkAda2 User's Guide: (gtkada2_ug). Ada95 graphical tookit based on GTK+ (User's Guide) @end direntry @set GtkAdaVersion 2.4.0 --- docs/generate.1~ +++ docs/generate.1 @@ -0,0 +1,84 @@ +.TH GENERATE2 1 "25 Nov 2003" "Debian GNU/Linux" "GtkAda 2.4 programming manual" +.SH NAME +generate2 \- Generate an Ada binding to a GTK+ widget +.SH SYNOPSIS +generate2 \fIc_file\fR [\fIdefinition-file unit_name\fR] + +generate2 -l \fIc_file\fR [\fIada_file\fR] +.SH DESCRIPTION +This script reads \fIc_file\fR, a C header file describing a new GTK+ +widget, and produces an Ada 95 thick binding to it on standard output. +The binding makes it possible to use the widget from within Ada +programs, just like other GTK+ widgets. + +\fBgenerate2\fR does not fully automate the process, although it +should really speed things up. You will probably need less than 15 min +to create a new binding once you get used to the way GtkAda +works. Note that \fIc_file\fR should have the same format as is used +by GTK+ itself. + +Here are the steps to create a new binding : + +.IP \(bu 3 +Give the \fBgenerate2\fR script the C header file. + +.IP \(bu +For every field in the C structure, the script asks you whether or +not you want to create a function to make it accessible from Ada. +Answer y or n (the default value is n, just press ENTER). Example: + + $ generate2 ../include/gtk/gtkbutton.h > temporary + Create a function for the field child (of type GtkWidget*) [n]? + Create a function for the field in_button (of type guint) [n]? + Create a function for the field button_down (of type guint) [n]? + +.IP \(bu +If you answered yes to at least one of the above questions, create a +new C file, and move the C part of the temporary file created by +generate2 to this C file. + +.IP \(bu +Do a \fBgnatchop\fR on the temporary file created by generate2. +This should create two Ada files (spec and body). + +.IP \(bu +Edit these two files as needed (generally to change some parameters +from Gint to Boolean for instance). It can be a little bit tricky +when one of your functions returns a GList* or a GSList*. Please have +a look at `/usr/share/ada/adainclude/gtkada2/gtk-combo.ads' for +examples how to do this. + +.SH OPTIONS + +.TP +.B -l +Simply list the functions defined in the file (C or Ada). If an +\fIada_file\fR argument is present, the output will only show the +differences between the two files. +.TP +.I file_name +name of the C file to parse. +.TP +.I definition_file +The file to parse for interface definition. +.TP +.I unit_name +If present, only the functions including this name will be generated. +.SH EXAMPLES +generate2 ../include/gdk/gdk.h ../include/gdk/gdktypes.h window + +generate2 ../include/gtk/gtkframe.h +.SH SEE ALSO +.BR gtkada2-config (1), +.BR gate2 (1), +.BR glade-2 (1), +.BR gnatchop (1) +.SH COPYRIGHT FOR THIS MAN PAGE +This man page has been written by Ludovic Brenta for the Debian +GNU/Linux distribution, from information given by the GtkAda authors +Emmanuel Briot, Joel Brobecker and Arnaud Charlet. + +Permission to use, copy, modify, and distribute this documentation for +any purpose and without fee is hereby granted, provided that the above +copyright notice appear in all copies and that both that copyright +notice and this permission notice appear in supporting documentation. --- docs/gdialog.1~ +++ docs/gdialog.1 @@ -0,0 +1,49 @@ +.TH GDIALOG2 1 "25 Nov 2003" "Debian GNU/Linux" "GtkAda 2.4 programming manual" +.SH NAME +gdialog2 \- Display a GTK+ dialog box from the command line. +.SH SYNOPSIS +gdialog2 [\fIdialog_type\fR [\fIjustification\fR]] +.SH DESCRIPTION +\fBgdialog2\fR displays the contents of its standard input in a GTK+ +dialog box. This is the version supplied with GtkAda version 2, and +it uses GTK+ 2 widgets. +.SH OPTIONS +.TP 5 +.I dialog_type +The type of dialog box desired. Possible values are: +.RS +.TP 13 +.BR warning +A message box with an exclamation point. +.TP +.BR error +A message box with a red stop sign. +.TP +.BR information +A message box with an "information" sign: white "i" on blue +background. +.TP +.BR confirmation +A message box with a question mark. +.TP +.BR custom +A message box with no pixmap and a user-defined caption. +.RE + +The default type is \fBinformation\fR. + +.TP +.I justification +The type of justification desired for the text of the message. +Possible values are \fBjustify_left\fR, \fBjustify_right\fR, +\fBjustify_center\fR and \fBjustify_fill\fR. The default is +\fBjustify_center\fR. +.SH COPYRIGHT FOR THIS MAN PAGE +This man page has been written by Ludovic Brenta for the Debian +GNU/Linux distribution, from information given by the GtkAda authors +Emmanuel Briot, Joel Brobecker and Arnaud Charlet. + +Permission to use, copy, modify, and distribute this documentation for +any purpose and without fee is hereby granted, provided that the above +copyright notice appear in all copies and that both that copyright +notice and this permission notice appear in supporting documentation.