sbase/ln.1
Hiltjo Posthuma a0998d0252 sbase: improve man pages and some warnings.
From ed5e4d34a16436a37c0e084666fcfb77cc4859c3 Mon Sep 17 00:00:00 2001
From: Hiltjo Posthuma <hiltjo@codemadness.org>
Date: Thu, 31 Jul 2025 14:42:59 +0200
Subject: [PATCH 4/4] improve man pages and some warnings.

Checking for warnings: mandoc -Tlint *.1

- Swap .St -p1003.1-2013 macro with text:
  mdoc does not support this macro and some texts were changed, like commit
  d4dfd42d3580ad36bedfdc5b8924ff6683981f53
- Typo fixes:
  exeption -> exception.
- xargs.1: document -P extension.
- sed.1: remove use of .Pp of .Ss.
- Wrap lines to less than 80 characters and use a new sentence for each line.
- find.1: Xr reference C library functions.
2025-09-19 09:16:25 +02:00

62 lines
930 B
Groff

.Dd October 8, 2015
.Dt LN 1
.Os sbase
.Sh NAME
.Nm ln
.Nd link files
.Sh SYNOPSIS
.Nm
.Op Fl f
.Op Fl L | Fl P | Fl s
.Ar target
.Op Ar name
.Nm
.Op Fl f
.Op Fl L | Fl P | Fl s
.Ar target ...
.Ar directory
.Sh DESCRIPTION
.Nm
creates a hard link
.Ar name
to
.Ar target .
If no
.Ar name
is given, a hard link to
.Ar target
is created in the current directory.
If more than one
.Ar target
is given,
.Nm
hardlinks them in the existing
.Ar directory .
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl f
If
.Ar name
exists and is not a
.Ar target ,
remove it to allow the link.
.It Fl L | Fl P
If
.Ar target
is a symbolic link, create a hard link to the (referenced file) |
(symbolic link itself). The former is the default.
.It Fl s
Create symbolic links instead of hard links.
Disables
.Fl L
and
.Fl P ,
because their purpose does not apply to symbolic links.
.El
.Sh SEE ALSO
.Xr cp 1 ,
.Xr link 2 ,
.Xr symlink 2
.Sh STANDARDS
POSIX.1-2013.