Skip to content

Commit

Permalink
Tweak wording
Browse files Browse the repository at this point in the history
  • Loading branch information
lidavidm committed Mar 26, 2024
1 parent c030626 commit 9efc64d
Showing 1 changed file with 7 additions and 4 deletions.
11 changes: 7 additions & 4 deletions docs/source/format/how_manager.rst
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,10 @@
How Drivers and the Driver Manager Work Together
================================================

.. note:: This document focuses on drivers/applications using the C API
definitions in adbc.h. That means C/C++/Python/Ruby, and possibly
C#/Go.
.. note:: This document focuses on drivers/applications that implement or
consume the C API definitions in adbc.h. That includes C/C++,
Python, and Ruby; and possibly C#, Go, and Rust (when implementing
or consuming drivers via FFI).

When an application calls a function like
:cpp:func:`AdbcStatementExecuteQuery`, how does it "know" what function in
Expand Down Expand Up @@ -70,11 +71,13 @@ same application:
In More Detail
==============

The adbc.h header ties everything together. It is the abstract API
The `adbc.h`_ header ties everything together. It is the abstract API
definition, akin to interface/trait/protocol definitions in other languages.
C being C, however, all it consists of is a bunch of function prototypes and
struct definitions without any implementation.

.. _adbc.h: https://github.com/apache/arrow/blob/main/format/adbc.h

A driver, at its core, is just a library that implements those function
prototypes in adbc.h. Those functions may be implemented in C, or they can be
implemented in a different language and exported through language-specific FFI
Expand Down

0 comments on commit 9efc64d

Please sign in to comment.