Turn all instances of Fn into proper cross references. While here, remove

redundant references to termios and favor Po/Pc for parenthesis enclosing.

ok jmc@ schwarze@

1 files changed, 17 insertions, 21 deletions

diff --git a/share/man/man4/tty.4 b/share/man/man4/tty.4
index a79e7aa47f2..e87ddd2ced1 100644
--- a/share/man/man4/tty.4
+++ b/share/man/man4/tty.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: tty.4,v 1.50 2018/05/01 15:16:50 anton Exp $
+.\"	$OpenBSD: tty.4,v 1.51 2018/06/05 06:32:26 anton Exp $
 .\"	$NetBSD: tty.4,v 1.4 1996/03/19 04:26:01 paulus Exp $
 .\"
 .\" Copyright (c) 1991, 1992, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"     @(#)tty.4	8.3 (Berkeley) 4/19/94
 .\"
-.Dd $Mdocdate: May 1 2018 $
+.Dd $Mdocdate: June 5 2018 $
 .Dt TTY 4
 .Os
 .Sh NAME
@@ -227,29 +227,25 @@ Return the current process group the terminal is associated
 with in the integer pointed to by
 .Fa tpgrp .
 This is the underlying call that implements the
-.Xr termios 4
-.Fn tcgetpgrp
+.Xr tcgetpgrp 3
 call.
 .It Dv TIOCSPGRP Fa int *tpgrp
 Associate the terminal with the process group (as an integer) pointed to by
 .Fa tpgrp .
 This is the underlying call that implements the
-.Xr termios 4
-.Fn tcsetpgrp
+.Xr tcsetpgrp 3
 call.
 .It Dv TIOCGETA Fa struct termios *term
 Place the current value of the termios state associated with the
 device in the termios structure pointed to by
 .Fa term .
 This is the underlying call that implements the
-.Xr termios 4
-.Fn tcgetattr
+.Xr tcgetattr 3
 call.
 .It Dv TIOCSETA Fa struct termios *term
 Set the termios state associated with the device immediately.
 This is the underlying call that implements the
-.Xr termios 4
-.Fn tcsetattr
+.Xr tcsetattr 3
 call with the
 .Dv TCSANOW
 option.
@@ -257,8 +253,7 @@ option.
 First wait for any output to complete, then set the termios state
 associated with the device.
 This is the underlying call that implements the
-.Xr termios 4
-.Fn tcsetattr
+.Xr tcsetattr 3
 call with the
 .Dv TCSADRAIN
 option.
@@ -266,8 +261,7 @@ option.
 First wait for any output to complete, clear any pending input,
 then set the termios state associated with the device.
 This is the underlying call that implements the
-.Xr termios 4
-.Fn tcsetattr
+.Xr tcsetattr 3
 call with the
 .Dv TCSAFLUSH
 option.
@@ -281,10 +275,12 @@ Performs no action and returns
 .It Dv TIOCNOTTY Fa void
 This call is obsolete but left for compatibility.
 In the past, when a process that didn't have a controlling terminal
-(see
+.Po
+see
 .Em The Controlling Terminal
 in
-.Xr termios 4 )
+.Xr termios 4
+.Pc
 first opened a terminal device, it acquired that terminal as its
 controlling terminal.
 For some programs this was a hazard as they didn't want a controlling
@@ -300,15 +296,15 @@ on that file descriptor.
 .Pp
 The current system does not allocate a controlling terminal to
 a process on an
-.Fn open
+.Xr open 2
 call: there is a specific ioctl called
 .Dv TIOCSCTTY
 to make a terminal the controlling
 terminal.
 In addition, a program can
-.Fn fork
+.Xr fork 2
 and call the
-.Fn setsid
+.Xr setsid 2
 system call which will place the process into its own session - which
 has the effect of disassociating it from the controlling terminal.
 This is the new and preferred method for programs to lose their controlling
@@ -385,8 +381,8 @@ If
 .Fa on
 points to a non-zero integer, redirect kernel console output
 .Po
-kernel
-.Fn printf Ns s
+see
+.Xr printf 9
 .Pc
 to this terminal.
 If