o5r/plan9port
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

tmac: introduce real manual reference macro instead of overloading IR

Browse source 
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.
This commit is contained in:
Russ Cox 2020-08-13 23:41:59 -04:00
parent a1c4307800
commit 977b25a76a
297 changed files with 1790 additions and 1774 deletions
Download patch file Download diff file Expand all files Collapse all files

22
man/man3/9pclient.3
View file

@ -149,7 +149,7 @@ connects to a service named
.I name
in the current name space directory
(see
.IR intro (4)).
.IM intro (4) ).
Both attach to the root of the file system
using the attach name
.IR aname .
@ -228,7 +228,7 @@ the allocated structures will be freed and the
file descriptor corresponding to the connection
will be closed
(see
.IR close (2)).
.IM close (2) ).
Fids are not reference counted: when
.I fsclose
is called, the clunk transaction and freeing of storage
@ -308,7 +308,7 @@ sets the offset; the
and
.I type
arguments are used as in
.IR seek (3).
.IM seek (3) .
Calling
.I fspread
or
@ -340,7 +340,7 @@ for the given fid.
.PP
.I Fsaccess
behaves like Unix's
.IR access (2).
.IM access (2) .
.I Fsremove
removes the named path.
.I Fsfremove
@ -358,7 +358,7 @@ are like
and
.I vfprint
(see
.IR print (3))
.IM print (3) )
but write to
.BR CFid* s.
.PP
@ -376,7 +376,7 @@ is similar but reads the entire directory.
The returned pointer should be freed with
.I free
(see
.IR malloc (3))
.IM malloc (3) )
when no longer needed.
.PP
.I Fsdirfstat
@ -396,7 +396,7 @@ structure returned by
should be freed with
.I free
(see
.IR malloc (3))
.IM malloc (3) )
when no longer needed.
.PP
.I Fsdirstat
@ -418,7 +418,7 @@ opens a file on the 9P server
for reading or writing but returns a Unix file descriptor
instead of a fid structure.
The file descriptor is actually one end of a
.IR pipe (2).
.IM pipe (2) .
A proxy process on the other end is ferrying data
between the pipe and the 9P fid.
Because of the implementation as a pipe,
@ -443,18 +443,18 @@ If the
flag is set, the library calls
.I threadexitsall
(see
.IR thread (3))
.IM thread (3) )
when it detects EOF on a 9P connection.
.SH SOURCE
.B \*9/src/lib9pclient
.SH SEE ALSO
.IR intro (4),
.IM intro (4) ,
.IR intro (9p),
.I fsaopen
and
.I nsaopen
in
.IR auth (3)
.IM auth (3)
.SH BUGS
The implementation
should use a special version string to distinguish between