ncurses 6.4 - patch 20240413

[ncurses.git] / man / menu.3x

diff --git a/man/menu.3x b/man/menu.3x
index fa7b03ac66dfd0cd2f86e4b267546edc27f97c8e..a833c3b55123587d63784bf4800b82f98b325aa4 100644 (file)
--- a/man/menu.3x
+++ b/man/menu.3x
@@ -1,6 +1,6 @@
 '\" t
 .\"***************************************************************************
 '\" t
 .\"***************************************************************************

-.\" Copyright 2018-2021,2023 Thomas E. Dickey                                *
+.\" Copyright 2018-2023,2024 Thomas E. Dickey                                *

 .\" Copyright 1998-2014,2017 Free Software Foundation, Inc.                  *
 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
 .\" Copyright 1998-2014,2017 Free Software Foundation, Inc.                  *
 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *


@@ -28,12 +28,19 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"

-.\" $Id: menu.3x,v 1.36 2023/09/16 23:38:39 tom Exp $
-.TH menu 3X 2023-09-16 "ncurses 6.4" "Library calls"
-.ie \n(.g .ds `` \(lq
-.el       .ds `` ``
-.ie \n(.g .ds '' \(rq
-.el       .ds '' ''
+.\" $Id: menu.3x,v 1.45 2024/03/16 15:35:01 tom Exp $
+.TH menu 3X 2024-03-16 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "Library calls"
+.ie \n(.g \{\
+.ds `` \(lq
+.ds '' \(rq
+.\}
+.el \{\
+.ie t .ds `` ``
+.el   .ds `` ""
+.ie t .ds '' ''
+.el   .ds '' ""
+.\}
+.

 .de bP
 .ie n  .IP \(bu 4
 .el    .IP \(bu 2
 .de bP
 .ie n  .IP \(bu 4
 .el    .IP \(bu 2


@@ -42,7 +49,9 @@
 \fBmenu\fP \-
 curses extension for programming menus
 .SH SYNOPSIS
 \fBmenu\fP \-
 curses extension for programming menus
 .SH SYNOPSIS

-\fB#include <menu.h>\fP
+.nf
+\fB#include <menu.h>
+.fi

 .SH DESCRIPTION
 The \fBmenu\fP library provides terminal-independent facilities for composing
 menu systems on character-cell terminals.
 .SH DESCRIPTION
 The \fBmenu\fP library provides terminal-independent facilities for composing
 menu systems on character-cell terminals.


@@ -56,7 +65,7 @@ these functions.
 To use the \fBmenu\fP library, link with the options
 \fB\-lmenu \-lcurses\fP.
 .
 To use the \fBmenu\fP library, link with the options
 \fB\-lmenu \-lcurses\fP.
 .

-.SS Current Default Values for Item Attributes
+.SS "Current Default Values for Item Attributes"

 .
 The \fBmenu\fP library maintains a default value for item attributes.
 You can
 .
 The \fBmenu\fP library maintains a default value for item attributes.
 You can


@@ -66,7 +75,7 @@ Changing this default with a
 \fBset_\fP function affects future item creations, but does not change the
 rendering of items already created.
 .
 \fBset_\fP function affects future item creations, but does not change the
 rendering of items already created.
 .

-.SS Routine Name Index
+.SS "Routine Name Index"

 .
 The following table lists each \fBmenu\fP routine and the name of
 the manual page on which it is described.
 .
 The following table lists each \fBmenu\fP routine and the name of
 the manual page on which it is described.


@@ -181,33 +190,26 @@ System error occurred (see \fBerrno\fP(3)).
 .B E_UNKNOWN_COMMAND
 The menu driver code saw an unknown request code.
 .SH NOTES
 .B E_UNKNOWN_COMMAND
 The menu driver code saw an unknown request code.
 .SH NOTES

-The header file \fB<menu.h>\fP automatically includes the header files
-\fB<curses.h>\fP and \fB<eti.h>\fP.
-.PP
-In your library list, libmenu.a should be before libncurses.a; that is,
-you should say \*(``\-lmenu \-lncurses\*('', not the other way around
-(which would give a link-error when using static libraries).
+The header file \fI\%menu.h\fP itself includes the header file
+\fI\%curses.h\fP.

 .SH PORTABILITY
 These routines emulate the System V menu library.
 They were not supported on
 Version 7 or BSD versions.
 .PP
 .SH PORTABILITY
 These routines emulate the System V menu library.
 They were not supported on
 Version 7 or BSD versions.
 .PP

-The menu facility was documented in SVr4.2 in
-\fICharacter User Interface Programming (UNIX SVR4.2)\fP.
+A menu facility was documented in SVr4.2's
+\fICharacter User Interface Programming\fP document.

 .PP
 It is not part of X/Open Curses.
 .PP
 .PP
 It is not part of X/Open Curses.
 .PP

-Aside from ncurses, there are few implementations:
+Aside from \fI\%ncurses\fP, there are few implementations:

 .bP
 systems based on SVr4 source code, e.g., Solaris.
 .bP
 NetBSD curses.
 .SH AUTHORS
 Juergen Pfeifer.
 .bP
 systems based on SVr4 source code, e.g., Solaris.
 .bP
 NetBSD curses.
 .SH AUTHORS
 Juergen Pfeifer.

-Manual pages and adaptation for ncurses by Eric S. Raymond.
+Manual pages and adaptation for \fI\%ncurses\fP by Eric S. Raymond.

 .SH SEE ALSO
 .SH SEE ALSO

-\fBcurses\fP(3X) and related pages whose names begin \*(``menu_\*(''
+\fB\%curses\fP(3X) and related pages whose names begin \*(``menu_\*(''

 for detailed descriptions of the entry points.
 for detailed descriptions of the entry points.

-.PP
-This describes \fBncurses\fP
-version @NCURSES_MAJOR@.@NCURSES_MINOR@ (patch @NCURSES_PATCH@).