Index: man/man7/ports.7
===================================================================
--- man/man7/ports.7
+++ man/man7/ports.7
@@ -42,37 +42,27 @@
 contains any patches necessary to make the original
 application source code compile and run on
 .Fx .
-Compiling an
-application is as simple as typing
-.Nm make Cm build
+Compiling an application is as simple as typing
+.Dq Li "make build"
 in the port directory!
 The
 .Pa Makefile
 automatically fetches the
 application source code, either from a local disk or via FTP, unpacks it
 on your system, applies the patches, and compiles it.
-If all goes well,
-simply type
-.Nm make Cm install
+If all goes well, simply type
+.Dq Li make install
 to install the application.
 .Pp
-For more information about using ports, see
-.Dq "Packages and Ports"
-in
-.%B "The FreeBSD Handbook" ,
-.Pa ( file:/usr/share/doc/en_US.ISO8859-1/books/handbook/ports.html
-or
-.Pa https://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/ports.html ) .
-For information about creating new ports, see
-.%B "The Porter's Handbook"
-.Pa ( file:/usr/share/doc/en_US.ISO8859-1/books/porters-handbook/index.html
-or
-.Pa https://www.FreeBSD.org/doc/en_US.ISO8859-1/books/porters-handbook/ ) .
+See the references in the
+.Sx SEE ALSO
+section for more information about ports from both user's and developer's
+perspective.
 .Sh TARGETS
 Some of the targets work recursively through subdirectories.
 This lets you, for example, install all of the
 .Dq Li biology
-ports.
+ports with one command.
 The targets that do this are
 .Cm build , checksum , clean , configure ,
 .Cm depends , extract , fetch , install ,
@@ -83,9 +73,7 @@
 target in order.
 That is,
 .Cm build
-will be run
-(if necessary)
-by
+will be run (if necessary) by
 .Cm install ,
 and so on all the way to
 .Cm fetch .
@@ -438,7 +426,7 @@
 .Cm fetchindex
 target).
 Defaults to
-.Dq Nm fetch Fl am .
+.Dq Li "fetch -am" .
 .It Va NOCLEANDEPENDS
 If defined, do not let
 .Cm clean
@@ -525,26 +513,44 @@
 .Sh FILES
 .Bl -tag -width ".Pa /usr/ports/Mk/bsd.port.mk" -compact
 .It Pa /usr/ports
-The default ports directory
+The default ports directory.
 .It Pa /usr/ports/Mk/bsd.port.mk
 The big Kahuna.
 .El
 .Sh SEE ALSO
 .Xr make 1 ,
 .Xr make.conf 5 ,
-.Xr pkg 8 ,
+.Xr pkg 7 ,
 .Xr portsnap 8
 .Pp
-The following are part of the ports collection:
-.Pp
-.Xr pkg 7 ,
-.Xr portlint 1
+Additional user documentation:
+.Bl -dash -width "" -offset indent
+.It
+.Xr pkg 8
+.It
 .Rs
+.%T "Packages and Ports"
 .%B "The FreeBSD Handbook"
+.%U "https://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/ports.html"
+.%U "file:///usr/share/doc/en_US.ISO8859-1/books/handbook/ports.html"
 .Re
+.It
+.Lk "https://www.FreeBSD.org/ports" "Searchable index of all ports"
+.El
 .Pp
-.Pa https://www.FreeBSD.org/ports
-(searchable index of all ports)
+Additional developer documentation:
+.Bl -dash -width "" -offset indent
+.It
+.Xr portlint 1
+.It
+.Pa /usr/ports/Mk/bsd.port.mk
+.It
+.Rs
+.%B "The Porter's Handbook"
+.%U "https://www.FreeBSD.org/doc/en_US.ISO8859-1/books/porters-handbook/"
+.%U "file:///usr/share/doc/en_US.ISO8859-1/books/porters-handbook/index.html"
+.Re
+.El
 .Sh HISTORY
 The Ports Collection
 appeared in