From nobody Wed Feb 05 18:57:47 2025 X-Original-To: bugs@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Yp8cq3yflz5mCsX for ; Wed, 05 Feb 2025 18:57:47 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Yp8cq3HgGz3cfj for ; Wed, 05 Feb 2025 18:57:47 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1738781867; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=eukVET9AVIoFXoY1zLE5SDi9nUlPfio6T9kywsivbug=; b=IYzgpsm8VANQ0JngXXqAZtkdOdg3Q+ZW4eTCKTdHZIKb8anDB4xNlmtDPOKy25i73540HC Quy0e4isJB75SgeeV7xbnZJJ4gAgHdNDOm3QxtQkfDGkKWbtzy+IbfAbNQdv+jx7ExiuJA ngNcT5e8jPyI1tgt69VrLoXISVUo+2ubjgMJGVSJvZCFun/163Z/PMQ5IgMClcizH//EXQ nkJb6BG9CC3VbzbrUqOITKUu4qqpYmCBc/D7etKNOlzOvbfGOKXDNUNj6J3GQ4/ojyFJb8 FJZWx5B24rr4n+JU6YWsedaACdBNGk32rXocWkFzBdsh/PUQZOwV9njGkB7K+Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1738781867; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=eukVET9AVIoFXoY1zLE5SDi9nUlPfio6T9kywsivbug=; b=rGbUzSGOEw1YQCuEq8uMQ/WUppQw+MIM0ziXZuc3+Xb7YTVQhn/2xfkF/pcHUqs2dMZYcM TKOe8wuuomvQNoc9fya+8HHszZKdzwHDD24Wr2/0l7bknJtsOeGlKyXm+FycDHmbHvMQbj qclosYB0lt/yea8lydkENpiTeq3JnVR5wJgZR6+c2SPnFBJ9vIBXXMXf6Vt+yBdJVDzYoA TPEHPhjyGFhcJevwyXow2iqklVyJDL3M+pJ1cJxShCN2uWlQP/TWADFWsalRQGvAoBG5E8 vum0pjR0Mbbu5DNb6hwkltDrSjCOplWLYCut+QBzJc08k4YJI/n8Zyo1WQDcBA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1738781867; a=rsa-sha256; cv=none; b=o4qxF0rXJsQKxDvZ3uhaM3tUA/y5qZ5DUrz/YfxJq4ct26JPUh14Sd3ViKTwa4ZJT+8jyd 9XREwplTofGaQpkat1KQd+oMM0q2ekHLarzPeJwFYe35r0Cf6TOuztMQwsgBV3EAuCJEjm ZSmsBSWSh4mTaMUHUQX3IyKbBVB3iY4s014D81QFhoXOpOKAMuWM3bQ83suXn8BY7DZkEj +mLcHqdM6MDEvckSJid0WCukJN7wydKT9Q2VBLEcI+FPXCkGjIBA26xY+gWIV8TzX9xAXX qL14WLT2o1vNM9ufe3PQfL7tzKAuBHaU6q5BrHy5bAWqjDNsjI7yCtU8o1icfg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Yp8cq2Xmcz13PR for ; Wed, 05 Feb 2025 18:57:47 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 515Ivl9R031241 for ; Wed, 5 Feb 2025 18:57:47 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 515Ivl9O031240 for bugs@FreeBSD.org; Wed, 5 Feb 2025 18:57:47 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: bugs@FreeBSD.org Subject: [Bug 284596] Confused about header file reference in tty(4) man page. Date: Wed, 05 Feb 2025 18:57:47 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Manual Pages X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Only Me X-Bugzilla-Who: artembunichev@zohomail.com X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: bugs@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status bug_severity priority component assigned_to reporter cc Message-ID: Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="UTF-8" X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Bug reports List-Archive: https://lists.freebsd.org/archives/freebsd-bugs List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-bugs@FreeBSD.org MIME-Version: 1.0 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D284596 Bug ID: 284596 Summary: Confused about header file reference in tty(4) man page. Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Only Me Priority: --- Component: Manual Pages Assignee: bugs@FreeBSD.org Reporter: artembunichev@zohomail.com CC: doc@FreeBSD.org I was reading tty(4) manual page, in particular the description for TIOCGWI= NSZ request. In the end of it it says "The winsize structure is defined in .". I never worked with winsize structure, so I didn't know wh= at's in it and decided to have a look. I did a quick search for "winsize" in /usr/include/sys/ioctl.h, but it didn't give any result. I figured that str= uct winsize is actually defined in /usr/include/sys/_winsize.h and then it's included in ioctl.h like that: _winsize.h -> ttycom.h -> ioctl.h. So it's true that winsize is defined in ioctl.h, but it's actually not that helpful if you want to look at the structure itself. Honestly, I'm not sure: maybe it's normal for manual pages to refer structures in such way; I don't have much knowledge about header files internals and the way they should be named in the manual pages, maybe their locations are machine-dependent. However, I'm thinking maybe it would be good to mention the in the page too, so that it will be clear for one who wants to look at the structure where to go. --=20 You are receiving this mail because: You are the assignee for the bug.=