1notcurses_core(3)                                            notcurses_core(3)
2
3
4

NAME

6       notcurses_core - minimal Notcurses linkage
7

SYNOPSIS

9       #include <notcurses/notcurses.h>
10
11       -lnotcurses-core
12
13       struct  notcurses*  notcurses_core_init(const  notcurses_options* opts,
14       FILE* fp);
15
16       struct ncdirect* ncdirect_core_init(const  char*  termtype,  FILE*  fp,
17       uint64_t flags);
18

DESCRIPTION

20       If your binary has no use for the multimedia capabilities of Notcurses,
21       consider linking directly to libnotcurses-core rather than  libnotcurs‐
22       es.  This ought greatly reduce the dependency burden of Notcurses.
23
24       If  using  libnotcurses-core,  notcurses_core_init  must be used in the
25       place of notcurses_init, and ncdirect_core_init must  be  used  in  the
26       place  of ncdirect_init.  Failure to do will usually result in an error
27       during linking.  At worst, you'll end up with the unnecessary dependen‐
28       cies in your binary after all.
29

BUGS

31       This  all  ought be handled by the toolchain.  It's stupid for users to
32       have to think about this.
33

NOTES

35       If Notcurses was built with USE_MULTIMEDIA=none, libnotcurses will have
36       no  multimedia  dependencies,  and thus this won't save anything.  It's
37       still best to explicitly use  libnotcurses-core  when  appropriate,  to
38       avoid  picking  up  the  dependency  chain on systems where it is being
39       used.
40

RETURN VALUES

42       The same as notcurses_init and ncdirect_init.
43

SEE ALSO

45       notcurses(3), notcurses_direct(3), notcurses_init(3), utf8(7)
46

AUTHORS

48       nick black <nickblack@linux.com>.
49
50
51
52                                    v3.0.8                   notcurses_core(3)