You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
54 lines
1.5 KiB
Markdown
54 lines
1.5 KiB
Markdown
% notcurses_core(3)
|
|
% nick black <nickblack@linux.com>
|
|
% v3.0.9
|
|
|
|
# NAME
|
|
|
|
notcurses_core - minimal Notcurses linkage
|
|
|
|
# SYNOPSIS
|
|
|
|
**#include <notcurses/notcurses.h>**
|
|
|
|
**-lnotcurses-core**
|
|
|
|
**struct notcurses* notcurses_core_init(const notcurses_options* ***opts***, FILE* ***fp***);**
|
|
|
|
**struct ncdirect* ncdirect_core_init(const char* ***termtype***, FILE* ***fp***, uint64_t ***flags***);**
|
|
|
|
# DESCRIPTION
|
|
|
|
If your binary has no use for the multimedia capabilities of Notcurses,
|
|
consider linking directly to **libnotcurses-core** rather than
|
|
**libnotcurses**. This ought greatly reduce the dependency burden of
|
|
Notcurses.
|
|
|
|
If using **libnotcurses-core**, **notcurses_core_init** must be
|
|
used in the place of **notcurses_init**, and **ncdirect_core_init** must
|
|
be used in the place of **ncdirect_init**. Failure to do will usually
|
|
result in an error during linking. At worst, you'll end up with the
|
|
unnecessary dependencies in your binary after all.
|
|
|
|
# BUGS
|
|
|
|
This all ought be handled by the toolchain. It's stupid for users to have
|
|
to think about this.
|
|
|
|
# NOTES
|
|
|
|
If Notcurses was built with **USE_MULTIMEDIA=none**, **libnotcurses** will
|
|
have no multimedia dependencies, and thus this won't save anything. It's
|
|
still best to explicitly use **libnotcurses-core** when appropriate, to
|
|
avoid picking up the dependency chain on systems where it *is* being used.
|
|
|
|
# RETURN VALUES
|
|
|
|
The same as **notcurses_init** and **ncdirect_init**.
|
|
|
|
# SEE ALSO
|
|
|
|
**notcurses(3)**,
|
|
**notcurses_direct(3)**,
|
|
**notcurses_init(3)**,
|
|
**utf8(7)**
|