mirrors/foot
1
0
Fork 0
mirror of https://codeberg.org/dnkl/foot.git synced 2026-02-05 04:06:08 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

selection: document the asynchronous behavior of text_from_{primary,clipboard}

Browse source
This commit is contained in:
Daniel Eklöf 2019-11-05 09:13:47 +01:00
parent b17358bd0a
commit fd82caad42
No known key found for this signature in database
GPG key ID: 5BBD4992C116573F
1 changed files with 17 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

18
selection.h
View file

@ -25,13 +25,29 @@ void selection_from_clipboard(struct terminal *term, uint32_t serial);
void selection_to_primary(struct terminal *term, uint32_t serial); void selection_to_primary(struct terminal *term, uint32_t serial);
void selection_from_primary(struct terminal *term); void selection_from_primary(struct terminal *term);
/* Copy text *to* primary/clipboard */
bool text_to_clipboard(struct terminal *term, char *text, uint32_t serial); bool text_to_clipboard(struct terminal *term, char *text, uint32_t serial);
bool text_to_primary(struct terminal *term, char *text, uint32_t serial);
/*
* Copy text *from* primary/clipboard
*
* Note that these are asynchronous; they *will* return
* immediately. The 'cb' callback will be called 0..n times with
* clipboard data. When done (or on error), the 'done' callback is
* called.
*
* As such, keep this in mind:
* - The 'user' context must not be stack allocated
* - Don't expect clipboard data to have been received when these
* functions return (it will *never* have been received at this
* point).
*/
void text_from_clipboard( void text_from_clipboard(
struct terminal *term, uint32_t serial, struct terminal *term, uint32_t serial,
void (*cb)(const char *data, size_t size, void *user), void (*cb)(const char *data, size_t size, void *user),
void (*done)(void *user), void *user); void (*done)(void *user), void *user);
bool text_to_primary(struct terminal *term, char *text, uint32_t serial);
void text_from_primary( void text_from_primary(
struct terminal *term, struct terminal *term,
void (*cb)(const char *data, size_t size, void *user), void (*cb)(const char *data, size_t size, void *user),