From 2137c52ef2de16fb1a15c0b8245e293ea0adb147 Mon Sep 17 00:00:00 2001 From: Jedidiah Barber Date: Fri, 9 May 2025 13:33:20 +1200 Subject: Revised readme into proper markdown --- readme.md | 77 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ readme.txt | 65 ---------------------------------------------------- 2 files changed, 77 insertions(+), 65 deletions(-) create mode 100644 readme.md delete mode 100644 readme.txt diff --git a/readme.md b/readme.md new file mode 100644 index 0000000..41ca58c --- /dev/null +++ b/readme.md @@ -0,0 +1,77 @@ + +## PortAudio Binding for the Ada Programming Language + +This is a thick binding of [PortAudio](https://www.portaudio.com/). So effort +has been made to get rid of all C-isms and C-specific types wherever possible. +In particular: + + + +The package hierarchy is as follows: + + + +A few short example programs are available in the `example` subdirectory. + + + +#### Dependencies + +Build time: + + +Run time: + + + + +#### Building and Installation + +This repository is written to use the GNAT Project Manager build tools. To +build, use the following command + +`gprbuild portaudio.gpr` + +There is a single build switch of `-Xbuild` which can have a value of `release` +(the default) or `debug`. + +To install the binding, use + +`gprinstall -p -m portaudio.gpr` + +The other gpr file `example.gpr` can be used to build the short example +programs provided. + +For further information on the build tools, consult the +[GPRbuild docs](https://docs.adacore.com/gprbuild-docs/html/gprbuild_ug.html). + + + +#### Credits and Licensing + +This binding and the Ada test/example programs were written by Jedidiah Barber. + +All code of this binding and example programs is released into the public +domain. Consult `unlicense.txt` for further information. + + diff --git a/readme.txt b/readme.txt deleted file mode 100644 index 7e2d5f3..0000000 --- a/readme.txt +++ /dev/null @@ -1,65 +0,0 @@ - - -PortAudio Binding for the Ada Programming Language -================================================== - - -Overview --------- - -This is a thick binding, so effort has been made to get rid of all C-isms and -C-specific types wherever possible. In particular: - - * Pa_Initialize and Pa_Terminate are now automatic - * All error codes have been converted to exceptions - * Void pointers are completely absent - * Standard error is suppressed in C during init, so no unexpected text output - -The package hierarchy is as follows: - - * Portaudio: Version information, exceptions, and a few common minor types - * Portaudio.Devices: Host_API and device related things - * Portaudio.Streams: Streams. sample buffers, and callbacks - -A few short example programs are available in /example/. - - -Dependencies ------------- - -An Ada 2012 compiler and standard library (build) -A C compiler and standard library (build) -gprbuild (build) -PortAudio (run) - - -Build Instructions ------------------- - -Ensure that all dependencies are installed, including any developer or header -packages for PortAudio. Then the following commands will build and install the -binding: - - gprbuild portadao.gpr - gprinstall -p -m portadao.gpr - -The other gpr file, example.gpr, can be used to build the few short example and -test programs provided. - - -Further Information -------------------- - -C API of PortAudio: -http://files.portaudio.com/docs/v19-doxydocs/portaudio_8h.html - - -Credits and Legal ------------------ - -This binding and the Ada test/example programs were written by Jedidiah Barber. - -All code of this binding and example programs is released into the public -domain. Consult unlicense.txt for further information. - - -- cgit