From mboxrd@z Thu Jan  1 00:00:00 1970
From: Marco van Hulten <marco@hulten.org>
Subject: bug#30656: symlink manual does not exist
Date: Thu, 01 Mar 2018 21:47:37 +0100
Message-ID: <20180301214737.2040e60e@jasniac.instanton>
References: <20180228225834.76a03636@jasniac.instanton>
	<87lgfb4u0s.fsf@gnu.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
Return-path: <bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:45018)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1erV7W-0002TX-1C
	for bug-guix@gnu.org; Thu, 01 Mar 2018 15:48:07 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1erV7S-0003Zc-Tf
	for bug-guix@gnu.org; Thu, 01 Mar 2018 15:48:06 -0500
Received: from debbugs.gnu.org ([208.118.235.43]:60112)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
	id 1erV7S-0003ZK-PZ
	for bug-guix@gnu.org; Thu, 01 Mar 2018 15:48:02 -0500
Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1erV7S-0005Zp-AI
	for bug-guix@gnu.org; Thu, 01 Mar 2018 15:48:02 -0500
Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-Message-ID: <handler.30656.B30656.151993726721412@debbugs.gnu.org>
In-reply-to: <87lgfb4u0s.fsf@gnu.org>
List-Id: Bug reports for GNU Guix <bug-guix.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-guix>,
	<mailto:bug-guix-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-guix/>
List-Post: <mailto:bug-guix@gnu.org>
List-Help: <mailto:bug-guix-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-guix>,
	<mailto:bug-guix-request@gnu.org?subject=subscribe>
Errors-To: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org
Sender: "bug-Guix" <bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org>
To: Ludovic =?UTF-8?Q?Court=C3=A8s?= <ludo@gnu.org>
Cc: 30656@debbugs.gnu.org

Ludovic=E2=80=94

Je  1 mrt 17:53 skribis Ludovic:
> Marco van Hulten <marco@hulten.org> skribis:
>=20
> > The man page of ln(1) tells me there exists a symlink(2) manual page
> > (which I am used to on Unix-like systems), but it is missing:
> >
> >
> > gast@graviton ~$ man 1 ln | grep -A1 SEE\ ALSO
> > SEE ALSO
> >        link(2), symlink(2)
> > gast@graviton ~$ man 2 symlink
> > No manual entry for symlink in section 2
> > gast@graviton ~$ man symlink
> > No manual entry for symlink
> >
> >
> > Man pages of both link(2) and symlink(2) are missing. =20
>=20
> They are provided by the =E2=80=98man-pages=E2=80=99 package.

Thanks, that solves it, and it is a simple solution.

Still, in a very strict sense this is a bug.  The ln(1) man page refers
to link(2) but it does not exist (and does not inform you that you need
the man-pages package).

However, there are two reasons why it is not a big issue.  Firstly,
Guix users will likely come to know this (maybe it'll get in the Guix
documentation, or they find this bug report on the web).  Secondly, at
the bottom of the man page there is a referal to the info page that
probably includes the same information as symlink(2).  I will close the
bug report.

=E2=80=94Marco