blackbeard420/notcurses
1
0
Fork 0
mirror of https://github.com/dankamongmen/notcurses synced 2025-03-09 17:19:03 -04:00
Code Issues Projects Releases Wiki Activity

drop NCPLANE_OPTION_NEWPILE #1078

Browse Source
This commit is contained in:
nick black 2020-11-22 03:38:49 -05:00 committed by Nick Black
parent ee83b63107
commit b747af2ae8
4 changed files with 9 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
NEWS.md
View File

@ -10,10 +10,10 @@ rearrangements of Notcurses.
or more `ncplane`s, with a bindtree and a z-axis. Different piles can be
mutated or rendered concurrently. There is no new user-visible type: a
`struct notcurses` can be treated as a single pile.
* To create a new pile, use the new `NCPLANE_OPTION_NEWPILE` with
`ncplane_create()`. The returned plane will be the top, bottom, and root
of a new plane. Alternatively, use `ncplane_reparent()` or
`ncplane_reparent_family()` with a `NULL` destination.
* To create a new pile, pass a `NULL` `n` argument to `ncplane_create()`.
The returned plane will be the top, bottom, and root of a new plane.
Alternatively, use `ncplane_reparent()` or `ncplane_reparent_family()`
with a `NULL` destination.
* 2.0.7 (2020-11-21)

1
USAGE.md
View File

@ -647,7 +647,6 @@ When an `ncplane` is no longer needed, free it with
```c
#define NCPLANE_OPTION_HORALIGNED 0x0001ull
#define NCPLANE_OPTION_NEWPILE 0x0002ull
typedef struct ncplane_options {
int y; // vertical placement relative to parent plane

11
doc/man/man3/notcurses_plane.3.md
View File

@ -12,7 +12,6 @@ notcurses_plane - operations on ncplanes
```c
#define NCPLANE_OPTION_HORALIGNED 0x0001ull
#define NCPLANE_OPTION_NEWPILE 0x0002ull
typedef struct ncplane_options {
int y; // vertical placement relative to parent plane
@ -256,11 +255,11 @@ bound to themselves). Multiple threads can concurrently operate on distinct
piles, even changing one while rendering another.
Each plane is part of one and only one pile. By default, a plane is part of the
same pile containing that plane to which it is bound. If the
**NCPLANE_OPTION_NEWPILE** flag is given to **ncplane_create**, the returned
plane becomes the root plane, top, and bottom of a new pile. As a root plane,
it is bound to itself. A new pile can also be created by reparenting a plane
to itself, though if the plane is already a root plane, this is a no-op.
same pile containing that plane to which it is bound. If the **n** argument
provided to **ncplane_create** is **NULL**, the returned plane becomes the root
plane, top, and bottom of a new pile. As a root plane, it is bound to itself. A
new pile can also be created by reparenting a plane to itself, though if the
plane is already a root plane, this is a no-op.
When a plane is moved to a different pile (whether new or preexisting), any
planes which were bound to it are rebound to its previous parent. If the plane

3
include/notcurses/notcurses.h
View File

@ -1026,9 +1026,6 @@ API char* notcurses_at_yx(struct notcurses* nc, int yoff, int xoff,
// Horizontal alignment relative to the parent plane. Use 'align' instead of 'x'.
#define NCPLANE_OPTION_HORALIGNED 0x0001ull
// The new place will be the root of a new pile.
#define NCPLANE_OPTION_NEWPILE 0x0002ull
typedef struct ncplane_options {
int y; // vertical placement relative to parent plane
int x; // horizontal placement relative to parent plane