From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 48) id ADC5B3858D28; Tue, 11 Apr 2023 11:27:10 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org ADC5B3858D28 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1681212430; bh=bxoJoQFRyM/AEBYCGd2gQdzphfSyIXMV9lcX6HHm9t4=; h=From:To:Subject:Date:In-Reply-To:References:From; b=SusLQSsloay1GGLaAdHjJGklY0N96ynH52vxZg9HhidGMslAs5NKoDa3oIP3OnHEZ HDzwPuaOvrvm7n3ywWJcmOXYtazaHBHboloiPJ/bjGSDdn3UVzLWxjiyBbpSEFNNXf +nuAGboBedZx0YiFYusv4kTiH57o1VEjafiEodJw= From: "GavinSmith0123 at gmail dot com" To: glibc-bugs@sourceware.org Subject: [Bug manual/17010] posix_openpt not documented Date: Tue, 11 Apr 2023 11:27:10 +0000 X-Bugzilla-Reason: CC X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: glibc X-Bugzilla-Component: manual X-Bugzilla-Version: unspecified X-Bugzilla-Keywords: X-Bugzilla-Severity: normal X-Bugzilla-Who: GavinSmith0123 at gmail dot com X-Bugzilla-Status: NEW X-Bugzilla-Resolution: X-Bugzilla-Priority: P2 X-Bugzilla-Assigned-To: unassigned at sourceware dot org X-Bugzilla-Target-Milestone: --- X-Bugzilla-Flags: security- X-Bugzilla-Changed-Fields: Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: http://sourceware.org/bugzilla/ Auto-Submitted: auto-generated MIME-Version: 1.0 List-Id: https://sourceware.org/bugzilla/show_bug.cgi?id=3D17010 --- Comment #1 from Gavin Smith --- This function has still not been documented. It means that the libc manual = is not the document that people should be looking at if they want to use pseudo-terminals. The Linux manpages project seems to be more comprehensive= in this area. The manual only documents getpt which is glibc-specific, as stated in the L= inux manpages: getpt() is glibc-specific; use posix_openpt(3) instead. The maintainers of the GNU compatibility library gnulib said that there was= no need for them to support getpt when this bug was first reported: https://lists.gnu.org/archive/html/bug-gnulib/2014-06/msg00030.html It would make sense to have a consistent treatment of getpt across glibc and gnulib as a function that should not be used in new programs, which means documenting posix_openpt properly. I am willing to write and send a patch f= or this if there is any chance of it being used. --=20 You are receiving this mail because: You are on the CC list for the bug.=