From 977b25a76ae8263e53fb4eb1abfc395769f23e3d Mon Sep 17 00:00:00 2001 From: Russ Cox Date: Thu, 13 Aug 2020 23:41:59 -0400 Subject: tmac: introduce real manual reference macro instead of overloading IR The overloading of IR emits magic \X'...' sequences that turn into HTML manual links. But not all such IR invocations should be manual links; those had to be written to avoid the IR macro before. Worse, the \X'...' ending the IR causes troff to emit only a single space after a period. Defining a new IM macro for manual references fixes both problems. Fixes #441. --- man/man3/mouse.3 | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) (limited to 'man/man3/mouse.3') diff --git a/man/man3/mouse.3 b/man/man3/mouse.3 index b5061fd9..6974dfa6 100644 --- a/man/man3/mouse.3 +++ b/man/man3/mouse.3 @@ -49,9 +49,9 @@ They use the message-passing .B Channel interface in the threads library (see -.IR thread (3)); +.IM thread (3) ); programs that wish a more event-driven, single-threaded approach should use -.IR event (3). +.IM event (3) . .PP The state of the mouse is recorded in a structure, .BR Mouse , @@ -107,7 +107,7 @@ are a naming the device file connected to the mouse and an .I Image (see -.IR draw (3)) +.IM draw (3) ) on which the mouse will be visible. Typically the file is nil, @@ -136,7 +136,7 @@ The actual value sent may be discarded; the receipt of the message tells the program that it should call .B getwindow (see -.IR graphics (3)) +.IM graphics (3) ) to reconnect to the window. .PP .I Readmouse @@ -152,7 +152,7 @@ or message sent on the channel. It calls .B flushimage (see -.IR graphics (3)) +.IM graphics (3) ) before blocking, so any buffered graphics requests are displayed. .PP .I Closemouse @@ -174,14 +174,14 @@ is nil, the cursor is set to the default. The format of the cursor data is spelled out in .B and described in -.IR graphics (3). +.IM graphics (3) . .PP .I Getrect returns the dimensions of a rectangle swept by the user, using the mouse, in the manner -.IR rio (1) +.IM rio (1) or -.IR sam (1) +.IM sam (1) uses to create a new window. The .I but @@ -220,7 +220,7 @@ struct Menu behaves the same as its namesake .I emenuhit described in -.IR event (3), +.IM event (3) , with two exceptions. First, it uses a .B Mousectl @@ -230,7 +230,7 @@ it creates the menu as a true window on the .B Screen .I scr (see -.IR window (3)), +.IM window (3) ), permitting the menu to be displayed in parallel with other activities on the display. If .I scr @@ -244,8 +244,8 @@ restoring the display when the menu is removed. .SH SOURCE .B \*9/src/libdraw .SH SEE ALSO -.IR graphics (3), -.IR draw (3), -.IR event (3), -.IR keyboard (3), -.IR thread (3). +.IM graphics (3) , +.IM draw (3) , +.IM event (3) , +.IM keyboard (3) , +.IM thread (3) . -- cgit v1.2.3 From d32deab17bfffa5bffc5fab3e6577558e40888c5 Mon Sep 17 00:00:00 2001 From: Russ Cox Date: Sat, 15 Aug 2020 20:07:38 -0400 Subject: tmac: rename IM (italic manual) to MR (manual reference) Suggested by G. Brandon Robinson. --- man/man3/mouse.3 | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) (limited to 'man/man3/mouse.3') diff --git a/man/man3/mouse.3 b/man/man3/mouse.3 index 6974dfa6..9b835891 100644 --- a/man/man3/mouse.3 +++ b/man/man3/mouse.3 @@ -49,9 +49,9 @@ They use the message-passing .B Channel interface in the threads library (see -.IM thread (3) ); +.MR thread (3) ); programs that wish a more event-driven, single-threaded approach should use -.IM event (3) . +.MR event (3) . .PP The state of the mouse is recorded in a structure, .BR Mouse , @@ -107,7 +107,7 @@ are a naming the device file connected to the mouse and an .I Image (see -.IM draw (3) ) +.MR draw (3) ) on which the mouse will be visible. Typically the file is nil, @@ -136,7 +136,7 @@ The actual value sent may be discarded; the receipt of the message tells the program that it should call .B getwindow (see -.IM graphics (3) ) +.MR graphics (3) ) to reconnect to the window. .PP .I Readmouse @@ -152,7 +152,7 @@ or message sent on the channel. It calls .B flushimage (see -.IM graphics (3) ) +.MR graphics (3) ) before blocking, so any buffered graphics requests are displayed. .PP .I Closemouse @@ -174,14 +174,14 @@ is nil, the cursor is set to the default. The format of the cursor data is spelled out in .B and described in -.IM graphics (3) . +.MR graphics (3) . .PP .I Getrect returns the dimensions of a rectangle swept by the user, using the mouse, in the manner -.IM rio (1) +.MR rio (1) or -.IM sam (1) +.MR sam (1) uses to create a new window. The .I but @@ -220,7 +220,7 @@ struct Menu behaves the same as its namesake .I emenuhit described in -.IM event (3) , +.MR event (3) , with two exceptions. First, it uses a .B Mousectl @@ -230,7 +230,7 @@ it creates the menu as a true window on the .B Screen .I scr (see -.IM window (3) ), +.MR window (3) ), permitting the menu to be displayed in parallel with other activities on the display. If .I scr @@ -244,8 +244,8 @@ restoring the display when the menu is removed. .SH SOURCE .B \*9/src/libdraw .SH SEE ALSO -.IM graphics (3) , -.IM draw (3) , -.IM event (3) , -.IM keyboard (3) , -.IM thread (3) . +.MR graphics (3) , +.MR draw (3) , +.MR event (3) , +.MR keyboard (3) , +.MR thread (3) . -- cgit v1.2.3