X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=man%2Fform_new.3x;fp=man%2Fform_new.3x;h=3cefa8519172456bc5c6e670333425f7aa177fce;hb=74433bcf4f6fe40862a28f3c00edaedcd5054b01;hp=47398174fad8674e3334154100dcb8fa050d537d;hpb=e6bb3226cdd35f5fd9f45bb1685cc2203c889480;p=ncurses.git diff --git a/man/form_new.3x b/man/form_new.3x index 47398174..3cefa851 100644 --- a/man/form_new.3x +++ b/man/form_new.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright 2018,2020 Thomas E. Dickey * +.\" Copyright 2018-2020,2021 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -28,26 +28,26 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_new.3x,v 1.15 2020/10/24 09:02:26 tom Exp $ +.\" $Id: form_new.3x,v 1.17 2021/12/25 21:41:58 tom Exp $ .TH form_new 3X "" .SH NAME -\fBnew_form\fR, +\fBnew_form\fP, \fBfree_form\fP \- create and destroy forms .SH SYNOPSIS -\fB#include \fR +\fB#include \fP .sp \fBFORM *new_form(FIELD **\fP\fIfields\fP\fB);\fP .br \fBint free_form(FORM *\fP\fIform\fP\fB);\fP .br .SH DESCRIPTION -The function \fBnew_form\fR creates a new form connected to a specified field -pointer array (which must be \fBNULL\fR-terminated). +The function \fBnew_form\fP creates a new form connected to a specified field +pointer array (which must be \fBNULL\fP-terminated). .PP -The function \fBfree_form\fR disconnects \fIform\fR from its field array +The function \fBfree_form\fP disconnects \fIform\fP from its field array and frees the storage allocated for the form. .SH RETURN VALUE -The function \fBnew_form\fR returns \fBNULL\fR on error. +The function \fBnew_form\fP returns \fBNULL\fP on error. It sets \fBerrno\fP according to the function's success: .TP 5 .B E_OK @@ -62,7 +62,7 @@ The field is already connected to a form. .B E_SYSTEM_ERROR System error occurred, e.g., malloc failure. .PP -The function \fBfree_form\fR returns one of the following: +The function \fBfree_form\fP returns one of the following: .TP 5 .B E_OK The routine succeeded. @@ -73,10 +73,10 @@ Routine detected an incorrect or out-of-range argument. .B E_POSTED The form has already been posted. .SH SEE ALSO -\fBcurses\fR(3X), \fBform\fR(3X). +\fBcurses\fP(3X), \fBform\fP(3X). .SH NOTES -The header file \fB\fR automatically includes the header file -\fB\fR. +The header file \fB\fP automatically includes the header file +\fB\fP. .SH PORTABILITY These routines emulate the System V forms library. They were not supported on