X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fmenu_items.3x;h=7c042435cfc72617b4bc0468135d7982dc417a1c;hp=0915343853686ba59d452f2eb1d38e84fb220d07;hb=152c5a605234b7ea36ba3a03ec07e124bb6aac75;hpb=027ae42953e3186daed8f3882da73de48291b606 diff --git a/man/menu_items.3x b/man/menu_items.3x index 09153438..7c042435 100644 --- a/man/menu_items.3x +++ b/man/menu_items.3x @@ -1,6 +1,7 @@ '\" t .\"*************************************************************************** -.\" Copyright (c) 1998,2006 Free Software Foundation, Inc. * +.\" Copyright 2018-2019,2020 Thomas E. Dickey * +.\" Copyright 1998-2012,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -27,18 +28,20 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_items.3x,v 1.7 2006/11/04 18:35:31 tom Exp $ +.\" $Id: menu_items.3x,v 1.17 2020/10/24 09:00:06 tom Exp $ .TH menu_items 3X "" .SH NAME -\fBmenu_items\fR - make and break connections between items and menus +\fBset_menu_items\fR, +\fBmenu_items\fR, +\fBitem_count\fP \- make and break connections between items and menus .SH SYNOPSIS \fB#include \fR +.sp +\fBint set_menu_items(MENU *\fP\fImenu\fP\fB, ITEM **\fP\fIitems\fP\fB);\fP .br -int set_menu_items(MENU *menu, ITEM **items); +\fBITEM **menu_items(const MENU *\fP\fImenu\fP\fB);\fP .br -ITEM **menu_items(const MENU *menu); -.br -int item_count(const MENU *menu); +\fBint item_count(const MENU *\fP\fImenu\fP\fB);\fP .br .SH DESCRIPTION The function \fBset_menu_items\fR changes the item pointer array of the given @@ -47,9 +50,9 @@ The function \fBset_menu_items\fR changes the item pointer array of the given The function \fBmenu_items\fR returns the item array of the given menu. .PP The function \fBitem_count\fR returns the count of items in \fImenu\fR. -.SH RETURN VALUES +.SH RETURN VALUE The function \fBmenu_items\fR returns a pointer (which may be \fBNULL\fR). -It does not set errno. +It does not set \fBerrno\fP. .PP The function \fBitem_count\fR returns \fBERR\fR (the general \fBcurses\fR error return value) if its \fImenu\fP parameter is \fBNULL\fP. @@ -69,7 +72,7 @@ No items are connected to the menu. The menu is already posted. .TP 5 .B E_SYSTEM_ERROR -System error occurred (see \fBerrno\fR). +System error occurred (see \fBerrno\fR(3)). . .SH SEE ALSO \fBcurses\fR(3X), \fBmenu\fR(3X). @@ -77,17 +80,12 @@ System error occurred (see \fBerrno\fR). The header file \fB\fR automatically includes the header file \fB\fR. .SH PORTABILITY -These routines emulate the System V menu library. They were not supported on +These routines emulate the System V menu library. +They were not supported on Version 7 or BSD versions. .PP The SVr4 menu library documentation specifies the \fBitem_count\fR error value -as -1 (which is the value of \fBERR\fR). +as \-1 (which is the value of \fBERR\fR). .SH AUTHORS -Juergen Pfeifer. Manual pages and adaptation for new curses by Eric -S. Raymond. -.\"# -.\"# The following sets edit modes for GNU EMACS -.\"# Local Variables: -.\"# mode:nroff -.\"# fill-column:79 -.\"# End: +Juergen Pfeifer. +Manual pages and adaptation for new curses by Eric S. Raymond.