diff options
Diffstat (limited to 'share')
| -rw-r--r-- | share/docs/lib/liboda.md | 38 | ||||
| -rw-r--r-- | share/man/man1/cat.1 | 7 |
2 files changed, 44 insertions, 1 deletions
diff --git a/share/docs/lib/liboda.md b/share/docs/lib/liboda.md index ee82dc0..e5345a4 100644 --- a/share/docs/lib/liboda.md +++ b/share/docs/lib/liboda.md @@ -189,3 +189,41 @@ structure to minimize the number of parameters used in the function signature. Upon failure of ``oda_reqwin()`` a negative POSIX errno value is returned (see ``sys/errno.h``). + +### Input management + +The liboda library additionally provides an input API that facilitates +management of user input (e.g., keyboard). + +(See ``liboda/input.h``) + +#### The ``oda_key`` structure + +ODA provides a standard description of keys received from a keyboard +device. Keyboard input is represented by the ``oda_key`` structure shown +below: + +```c +struct oda_key { + uint16_t type; + uint8_t scancode; + char ch; + ... +}; +``` + +The ``type`` field describes the key type, valid key types can be +found within the ``ODA_KEY_*`` definitions in ``liboda/input.h``. + +The ``scancode`` field contains the raw keyboard scancode received +from the device. + +The ``ch`` field contains the ASCII representation of the input received +from the device. + +#### The ``oda_kbd`` structure + +ODA represents keyboard devices through the ``oda_kbd`` structure found +in ``liboda/input.h``. This structure contains callbacks that are set up +by the compositor to be invoked when their respective keyboard related +event occurs. diff --git a/share/man/man1/cat.1 b/share/man/man1/cat.1 index 8214724..1759407 100644 --- a/share/man/man1/cat.1 +++ b/share/man/man1/cat.1 @@ -24,7 +24,7 @@ .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. -.Dd Jul 17 2025 +.Dd Aug 6 2025 .Dt CAT 1 .Os HYRA .Sh NAME @@ -39,6 +39,11 @@ The command can be used concatenate files or simply write their contents to standard output. +.Bd -literal +[-n]: Number each line +[-b]: Number each non-blank line +.Ed + .Sh SEE ALSO mex(1) |