X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fadacurses6-config.1.html;h=9ddd175d8623a6773c3ad3f18da7ccb95a44cd92;hb=2882050bf8b296813e7e026b1c5c45d4a23043e3;hp=96af44a4e30f4e035385f25e57d849a1b72dc466;hpb=0fbd5e192896b3e446832d0a451df2cec5f5ae40;p=ncurses.git diff --git a/doc/html/man/adacurses6-config.1.html b/doc/html/man/adacurses6-config.1.html index 96af44a4..9ddd175d 100644 --- a/doc/html/man/adacurses6-config.1.html +++ b/doc/html/man/adacurses6-config.1.html @@ -1,6 +1,7 @@ - - -ADACURSES 1 User Commands - - + +adacurses6\-config 1 2023-10-07 ncurses 6.4 User commands + + -

ADACURSES 1 User Commands

adacurses6\-config 1 2023-10-07 ncurses 6.4 User commands

-ADACURSES(1)                     User Commands                    ADACURSES(1)
+adacurses6-config(1)             User commands            adacurses6-config(1)

NAME

-       adacurses6-config - helper script for AdaCurses libraries
+       adacurses6-config - configuration helper for AdaCurses libraries

SYNOPSIS

-       adacurses6-config [options]
+       adacurses6-config [--cflags] [--libs]
+
+       adacurses6-config --version
+
+       adacurses6-config --help

DESCRIPTION

-       This  is  a shell script which simplifies configuring an application to
-       use the AdaCurses library binding to ncurses.
+       This  program  development  aid  simplifies  the process of configuring
+       applications to use the AdaCurses library binding to ncurses.

OPTIONS

-       --cflags
-              echos the gnat (Ada  compiler)  flags  needed  to  compile  with
-              AdaCurses.
+       --cflags   reports the GNAT (Ada compiler) flags needed to compile with
+                  AdaCurses.
 
-       --libs echos the gnat libraries needed to link with AdaCurses.
+       --libs     reports the GNAT libraries needed to link with AdaCurses.
 
-       --version
-              echos  the  release+patchdate  version  of the ncurses libraries
-              used to configure and build AdaCurses.
+       --version  reports  the  release  and  patch  date  information  of the
+                  ncurses libraries used to configure and build AdaCurses  and
+                  exits successfully.
 
-       --help prints a list of the adacurses6-config script's options.
+       --help     issues a usage message and exits successfully.
 
-       If no options are given, adacurses6-config prints  the  combination  of
-       --cflags and --libs that gnatmake expects (see example).
+       Omitting options implies "--cflags --libs".

EXAMPLE

-       For  example,  supposing  that  you  want to compile the "Hello World!"
-       program for AdaCurses.  Make a file named "hello.adb":
-              with Terminal_Interface.Curses; use Terminal_Interface.Curses;
-
-              procedure Hello is
-
-                 Visibility : Cursor_Visibility := Invisible;
-                 done : Boolean := False;
-                 c : Key_Code;
+       Consider a program using AdaCurses to write the message "Hello, world!"
+       in the center of the screen and wait for the user to press the "q"  key
+       before exiting.  Populate a file hello.adb with the following.
 
-              begin
+           with Terminal_Interface.Curses; use Terminal_Interface.Curses;
 
-                 Init_Screen;
-                 Set_Echo_Mode (False);
+           procedure Hello is
+              Visibility : Cursor_Visibility := Invisible;
+              Message : constant String := "Hello, World!";
+              done : Boolean := False;
+              c : Key_Code;
+           begin
+              Init_Screen;
+              Set_Echo_Mode (False);
+              Set_Cursor_Visibility (Visibility);
+              Set_Timeout_Mode (Standard_Window, Non_Blocking, 0);
 
-                 Set_Cursor_Visibility (Visibility);
-                 Set_Timeout_Mode (Standard_Window, Non_Blocking, 0);
+              Move_Cursor (Line => Lines / 2,
+                           Column => (Columns - Message'Length) / 2);
+              Add (Str => Message);
 
-                 Move_Cursor (Line => Lines / 2, Column => (Columns - 12) / 2);
-                 Add (Str => "Hello World!");
+              while not done loop
+                 c := Get_Keystroke (Standard_Window);
 
-                 while not done loop
+                 case c is
+                     when Character'Pos ('q') => done := True;
+                     when others => null;
+                 end case;
 
-                    c := Get_Keystroke (Standard_Window);
-                    case c is
-                    when Character'Pos ('q') => done := True;
-                    when others => null;
-                    end case;
+                 Nap_Milli_Seconds (50);
+              end loop;
 
-                    Nap_Milli_Seconds (50);
-                 end loop;
+              End_Windows;
 
-                 End_Windows;
-
-              end Hello;
+           end Hello;
 
        Then, using
-              gnatmake `adacurses-config --cflags`  hello  -largs  `adacurses-
-              config --libs`
-
-       or (simpler):
-              gnatmake hello `adacurses-config`
-
-       you will compile and link the program.
+           gnatmake `adacurses6-config --cflags` hello \
+               -largs `adacurses6-config --libs`
+       or, more simply,
+           gnatmake hello `adacurses6-config`
+       you can compile and link the program.